Guia de solução de problemas de licença do Nexus

Introduction

Este documento descreve problemas comuns com a instalação de licenças e os processos de renovação em switches Nexus 7000 e 9000 Series. Este documento também descreve técnicas para solucionar problemas relacionados a licenças em switches Cisco Nexus Series.

Prerequisites

Requirements

A Cisco recomenda que você tenha conhecimento do Guia de Licenciamento do Cisco NX-OS.

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• Switch Nexus 7000 Series executando o Cisco Nexus Operating System (NX-OS) versão 6.2
• Switch Nexus 9000 Series executando o Cisco Nexus Operating System (NX-OS) versão 9.3(3)

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Informações de Apoio

Os switches Cisco Nexus NX-OS Series têm uma variedade de recursos vinculados a uma licença específica. Para usar esses recursos, a maioria das plataformas Nexus exige que a licença seja instalada primeiro. A licença de avaliação é uma licença temporária que dura por um período limitado e é usada para testar vários recursos. Terminado o período de avaliação, deve ser obtida e instalada uma licença permanente para continuar a utilizar as características pertinentes.

Este documento descreve problemas comuns com a instalação, renovação e atualizações de licenças nos switches Nexus 7000 e 9000 Series. Este documento também descreve técnicas para solucionar problemas relacionados a licenças em switches Cisco Nexus Series.

Problemas comuns nos switches Nexus 7000 Series

Esta seção aborda problemas comuns de licenciamento com os switches Nexus 7000 Series.

Já existe uma licença com uma data de vencimento posterior/diferente para o recurso

Quando você tenta instalar uma nova licença para recursos em um switch Nexus 7000 Series, esta mensagem de erro é exibida:

switch# install license bootflash:license_file.lic
Installing license failed: A license with a later/different expiry date already exists for feature.

O requisito é que os recursos habilitados por meio da licença de avaliação não sejam afetados quando a licença for atualizada e essa mensagem de erro for resolvida.

Solução

Quando um switch Nexus 7000 Series ativo não puder ser interrompido porque usa recursos vinculados a uma licença do período de avaliação (por exemplo, Open Shortest Path First e Border Gateway Protocol), faça estas etapas para renovar a licença de avaliação:

1. Verifique se os arquivos de licença existem para o dispositivo com os comandos show license brief e show license usage:
   
   

   switch# show license brief
   ENTERPRISELicense.lic
   ENTERPRISELicense1.lic
   
   switch# show license usage
   <snip>
   Feature                      Ins  Lic   Status Expiry Date Comments
                                    Count
   --------------------------------------------------------------------------------
   LAN_ADVANCED_SERVICES_PKG    Yes    -   In use 23 Oct 2009   -
   LAN_ENTERPRISE_SERVICES_PKG  No     -  Unused Never         -
   --------------------------------------------------------------------------------

2. Se você encontrar esse erro, atualize a licença atual em vez de instalá-la como faria quando um novo Switch Nexus 7000 Series estiver configurado para seus recursos vinculados a licença. Execute estas etapas para atualizar a licença atual:
   
   

   switch# update license bootflash:Enterprise1.lic Enterprise.lic
   Do you want to continue? (y/n) y
   Updating license ..done
   switch#

A linha do servidor na licença deve ter "this_host ANY"

Quando você tenta instalar uma licença com o comando install license bootflash:license_file.lic em um switch Nexus 7000 Series, esta mensagem de erro é exibida:

switch# install license bootflash:license_file.lic
Installing license failed: SERVER line in license should have "this_host ANY"

Solução

Esse erro é causado pela formatação incorreta no arquivo de licença. Para corrigir isso, o arquivo de licença deve ser editado com este procedimento:

1. Abra o arquivo .lic com um editor de texto.
   
   
2. Copie e cole seu conteúdo em um novo arquivo de texto.
   
   
3. Verifique se o texto está formatado de forma semelhante a esta:
   
   

   SERVER this_host ANY
   VENDOR cisco
   INCREMENT FM_SERVER_PKG cisco 1.0 permanent uncounted \
         VENDOR_STRING=<LIC_SOURCE>MDS_SWIFT</LIC_SOURCE><SKU>M9200FMS1K9-INTRL</SKU> \
        HOSTID=VDH=xxxxxxxxxxx \
         NOTICE="<LicFileID>xxxxxxxxxxx</LicFileID><LicLineID>1</LicLineID> \
         <PAK>xxxxxxxxx</PAK>" SIGN=xxxxxxxx

   
   
   Em particular, o software de licenciamento espera que o transporte retorne após ANY e cisco, e antes do INCREMENT começar.
   
   
4. Salve o arquivo com o tipo de arquivo todos os arquivos com codificação ANSI.
   
   
5. Copie o novo arquivo para o flash de inicialização do switch e tente instalá-lo novamente com o comando install license.
   
   

   Note: A partir do software NX-OS versão 6.2, o switch pode corrigir automaticamente a formatação do arquivo de licença antes de prosseguir com a instalação da licença. Isso pode ser feito com a palavra-chave format no comando install license.

O License Server Não Suporta Este Recurso

Quando você tenta instalar uma licença com o comando install license bootflash:license_file.lic em um switch Nexus 7000 Series, esta mensagem de erro é exibida:

switch# install license bootflash:license_file.lic
Installing license failed: License server does not support this feature

Solução

Esta mensagem indica que você executa uma versão do código que não suporta uma licença em seu arquivo. Conclua estes passos para corrigir o problema.

1. Examine o arquivo de licença que deseja instalar:
   
   

   switch# show file bootflash:license_file.lic
   
   SERVER this_host ANY
   VENDOR cisco
   INCREMENT FCOE-N7K-F248XP cisco 1.0 permanent 1 \
           VENDOR_STRING=<LIC_SOURCE>MDS_SWIFT</LIC_SOURCE><SKU>N7K-FCOEF248XP</SKU> \
           HOSTID=VDH=xxxxxxxxxxxxx \
           NOTICE="<LicFileID>xxxxxxxxxxx</LicFileID><LicLineID>1</LicLineID> \
           <PAK></PAK>" SIGN=xxxxxxxxxxxxx

   
   
   
2. Compare os campos no arquivo que estão em negrito na Etapa 1 com as tabelas de licença e a tabela de histórico de recursos no Guia de licenciamento do NX-OS para determinar qual versão do código suporta a licença.

A licença está ausente

Os registros reportam isso para licenças em uso:

switch# show logging logfile
<snip>
LICMGR-3-LOG_LIC_FILE_MISSING  License file(s) missing for feature LAN_ADVANCED_SERVICES_PKG.
LICMGR-3-LOG_LIC_FILE_MISSING  License file(s) missing for feature LAN_ENTERPRISE_SERVICES_PKG.

A saída de uso da licença exibe:

switch# show license usage
<snip>
Feature                      Ins  Lic   Status Expiry Date Comments
                                 Count
--------------------------------------------------------------------------------
ENHANCED_LAYER2_PKG           Yes   -   In use Never       license missing
LAN_ADVANCED_SERVICES_PKG     Yes   -   In use Never       license missing
LAN_ENTERPRISE_SERVICES_PKG   Yes   -   Unused Never       license missing
--------------------------------------------------------------------------------
**** WARNING: License file(s) missing. ****

Solução

Esta mensagem indica um destes dois problemas:

• O arquivo de licença para este dispositivo não está presente no flash de inicialização do dispositivo.
• O arquivo de licença deste dispositivo contém informações incorretas.

Conclua estes passos para corrigir o problema:

1. Verifique se o ID do host e o nome do arquivo da licença correspondem ao número de série do dispositivo.
   
   

   Note: A saída pode estar em branco para um dos dois primeiros comandos.

   
   
   

   switch# show license host
   License hostid: VDH=JAFxxxxxxQB   <--- License Host ID of the device
   
   switch# directory bootflash: | i lic
   762    Sep 12 01:16:18 2012  JAFxxxxxxQB_183876004.lic  <---- License filename
   
   switch# show sprom backplane 1
   <snip>
   Serial Number   : JAFxxxxxxQB   <--- Serial number of the device

   
   
   

   Observação: se eles não corresponderem e esse syslog for observado em dois switches Nexus 7000 Series diferentes, os arquivos de licença poderão ser trocados entre os dois dispositivos. Compare a ID do host e os números de série entre cada chassi e mova o arquivo apropriado para o chassi correto.

   
   
   
2. Mova uma cópia de backup do arquivo de licença para o flash de inicialização do dispositivo e, em seguida, atualize o arquivo de licença atualmente instalado com a cópia de backup por meio do comando update license.
   
   

   Note: Se você não tiver esse arquivo, peça que a licença seja reemitida por meio das ferramentas de suporte ou de um caso do Cisco Technical Assistance Center (TAC).

   
   

   switch# update license bootflash:JAFxxxxxxQB_backup.lic JAFxxxxxxQB_183876004.lic
   Do you want to continue? (y/n) y
   Updating license ..done
   switch#

3. Se você continuar a encontrar esta mensagem de erro ao tentar instalar a licença com o comando install license, limpe a licença SPROM com o comando clear license sprom e reinstale a licença com o comando install license bootflash:JAFxxxxxQB_183876004.lic em uma janela de manutenção .

A licença está em uso

Quando você tenta atualizar uma licença com o comando update license em um switch Nexus 7000 Series, esta mensagem de erro é exibida:

switch# update license bootflash:new_license.lic old_license.lic
Do you want to continue? (y/n) y
Updating license failed: License is in use

Solução

Esse problema ocorre quando o arquivo de licença usado para a atualização contém uma licença já instalada no Nexus 7000. Para corrigir esse problema, remova as licenças atuais do arquivo usado para a atualização com este procedimento:

1. Insira este comando para determinar quais licenças estão instaladas:
   
   

   show license usage 
   Feature                      Ins  Lic   Status Expiry Date Comments
                                    Count
   --------------------------------------------------------------------------------
   MPLS_PKG                      No    -   Unused             -
   ...
   ENTERPRISE_PKG                No    -   Unused             -
   ...
   FCOE-N7K-F248XP               Yes   1   Unused Never       -
   ...
   --------------------------------------------------------------------------------

   
   
   
2. Abra o arquivo .lic com um editor de texto.
   
   
3. Copie e cole seu conteúdo em um novo arquivo de texto.
   
   
4. Remova toda a seção INCREMENT da licença já instalada (neste exemplo, FCOE-N7K-F248XP 😞
   
   

   ...
   INCREMENT FCOE-N7K-F248XP cisco 1.0 permanent 1 \
           VENDOR_STRING=<LIC_SOURCE>MDS_SWIFT</LIC_SOURCE><SKU>N7K-FCOEF248XP</SKU> \
           HOSTID=VDH=xxxxxxxxxxxxx \
           NOTICE="<LicFileID>xxxxxxxxxxx</LicFileID><LicLineID>1</LicLineID> \
           <PAK></PAK>" SIGN=xxxxxxxxxxxxx
   ...

   
   
   
5. Salve o arquivo usando o tipo de arquivo todos os arquivos com codificação ANSI.
   
   
6. Copie o arquivo atualizado para o flash de inicialização do switch Nexus 7000 e tente instalá-lo novamente com o comando install license.

Problemas comuns nos switches Nexus 9000 Series

Esta seção aborda problemas comuns de licenciamento com os switches Nexus 9000 Series.

O License Server Não Suporta Este Recurso

Quando você tenta instalar uma licença com o comando install license bootflash:license_file.lic em um switch Nexus 9000 Series, esta mensagem de erro é exibida:

switch# install license bootflash:license_file.lic
Installing license failed: License server does not support this feature

Esta mensagem indica que você executa uma versão do código que não suporta uma licença em seu arquivo. Conclua estes passos para corrigir o problema.

1. Examine o arquivo de licença que deseja instalar:

   switch# show file bootflash:license_file.lic
   
   SERVER this_host ANY
   VENDOR cisco
   INCREMENT NXOS_ESSENTIALS_XF2 cisco 1.0 permanent uncounted \
   VENDOR_STRING=<LIC_SOURCE>MDS_SWIFT</LIC_SOURCE><SKU>NXOS-ES-XF2</SKU> \
   HOSTID=VDH=XXXXXXXXXXX \
   NOTICE="<LicFileID>XXXXXXXXXXXXXXXXX</LicFileID><LicLineID>1</LicLineID> \
   <PAK>XXXXXXXXXXX</PAK>" SIGN=XXXXXXXXXXXX

2. Compare os campos no arquivo que estão em negrito na Etapa 1 com as tabelas de licença e a tabela de histórico de recursos no Guia de licenciamento do NX-OS para determinar qual versão do código suporta a licença.

Note: Essa mensagem de erro pode aparecer nos dispositivos Cisco Nexus 93180YC-FX, 93108TC-FX, 93300YC-FX2 e 9336C-FX2 que executam o software NX-OS versão 9.2(3) como resultado do bug da Cisco ID CSCvo7 1854. A Cisco recomenda que você abra um caso de suporte com o Cisco TAC para confirmar e solucionar o problema ainda mais.

Tamanho do Nome de Arquivo Inválido, O Nome De Arquivo Excede 30 Caracteres

Quando você tenta instalar uma licença com o comando install license bootflash:long_license_filename.lic em um switch Nexus 9000 Series, esta mensagem de erro é exibida:

switch# install license bootflash:long_license_filename.lic
Installing license failed: Invalid filename size, filename exceeds 30 characters

Essa mensagem indica que o nome do arquivo de licença é muito longo para que o Nexus 9000 instale a licença. Os nomes dos arquivos de licença não devem exceder 30 caracteres. Conclua estes passos para corrigir o problema.

1. Renomeie o arquivo de licença com o comando move bootflash:long_license_filename.lic bootflash:license_file.lic.

   Note: Antes de renomear o arquivo de licença com o comando move, verifique se um arquivo existente no dispositivo ainda não foi nomeado com um nome de arquivo idêntico ao novo nome de arquivo para o arquivo de licença. Isso pode ser executado com o comando dir, como demonstrado neste exemplo.

   switch# dir | include long_license_filename.lic
   12726 Feb 25 16:11:30 2020 long_license_filename.lic
   switch# dir | include license_file.lic
   switch# 
   switch# move bootflash:long_license_filename.lic bootflash:license_file.lic
   switch# 
   switch# dir | include license_file.lic
   12726 Feb 25 16:13:27 2020 license_file.lic

2. Instale a licença usando o novo nome de arquivo mais curto com o comando install license bootflash:license_file.lic.

Informações Relacionadas

• Guia de solução de problemas do Cisco Nexus 9000 Series NX-OS - Solução de problemas de licenciamento
• Suporte Técnico e Documentação - Cisco Systems