Solucionar problemas de teclas de opção em endpoints registrados na nuvem

Introdução

Este documento descreve como lidar com chaves de opções em um endpoint registrado na nuvem.

Pré-requisitos

Requisitos

Recomenda-se que você tenha alguma familiaridade com estes tópicos:

• Plataforma de Hub de Controle
• Administração de endpoints por meio da interface gráfica do usuário (GUI) do endpoint e da seção "Dispositivos" do Control Hub
• Sistema operacional da sala

Componentes Utilizados

O equipamento listado aqui foi usado para fazer os testes e produzir os resultados descritos neste documento:

• Organização do Hub de Controle
• Endpoint SX80
• Endpoint Codec Pro

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

O que é uma chave de opção?

As chaves de opção são valores de sequência alfanumérica que podem ser aplicados a um ponto final para aprimorar suas capacidades. As partes alfanuméricas da chave (geralmente 3 partes) são separadas por traços (-). Um exemplo de uma chave de opção é 1S050-1-79FDE3AC.

As teclas de opção não são usadas no endpoint para fazer download de novos recursos da Internet. Quando o endpoint é enviado a você, ele vem com todos os recursos disponíveis e tem todos os recursos que o hardware e o software permitem. No entanto, dependendo de parâmetros como seu contrato, as opções de compra feitas por você como cliente ao entrar em contato com seu representante de vendas e algumas restrições específicas do país que se aplicam, alguns dos recursos que o endpoint pode usar não estão disponíveis e foram desativados.

Isso pode acontecer, por exemplo, quando você decide comprar um endpoint, mas tem certeza de que alguns dos recursos opcionais oferecidos junto com ele não serão usados em seu ambiente. Em seguida, você pode decidir continuar com a compra do endpoint sem pagar pelas opções extras oferecidas. Você pode prosseguir com a compra de uma chave de opção que habilite qualquer recurso adicional que você precise ter no futuro.

É importante observar que você não precisa comprar separadamente cada chave de opção. Alguns deles podem ser obtidos sem qualquer custo adicional. Para obter informações adicionais sobre as taxas de chave de opção, entre em contato com seu Gerente de Sucesso do Cliente, representante de Vendas ou Parceiro ou com um agente da equipe de Licenciamento abrindo um tíquete com a Equipe de Licenciamento ou TAC.

Além disso, muitos endpoints vêm com teclas de opção pré-instaladas e prontas para uso imediato. Isso significa que os endpoints já têm algumas teclas de opção aplicadas a eles.

Como uma chave de opção pode ser obtida?

Você pode obter uma chave de opção entrando em contato com a equipe de licenciamento ou o TAC. Antes disso, você pode entrar em contato e discutir qualquer possível custo de cobrança com o Gerente de Sucesso do Cliente (CSM), o DSM ou o Parceiro designado.

Se você tiver dúvidas sobre uma chave de opção específica ou precisar de ajuda para aplicá-la de uma perspectiva técnica, será necessário abrir um caso no TAC.

Como o TAC ou o Licenciamento verificam a qualificação para as chaves de opção?

Ao entrar em contato com o TAC ou a equipe de licenciamento para obter uma chave de opção, você deve fornecer algumas informações básicas, como o Número do pedido de vendas, o Número do contrato ou a PAK. Ao fazer um pedido, as chaves de opção obtidas, juntamente com outros serviços adicionais, fazem parte do seu contrato e, portanto, são associadas a esses identificadores exclusivos. Seu ponto de contato de vendas pode compartilhar essas IDs com você mediante solicitação.

Como você recebe a chave de opção depois que o procedimento de solicitação tiver sido concluído?

Depois que a equipe de licenciamento aprovar sua solicitação para obter uma chave de opção, você receberá um e-mail com informações detalhadas da solicitação. Parece com esta imagem (apenas uma parte do email é fornecida para fins de demonstração, o restante foi omitido):

E-mail contendo o valor da chave de opção

Neste e-mail, informações importantes são fornecidas: o nome do produto, o número do pedido associado à ordem da chave de opção, as opções/recursos que a chave está ativando, o número de série do endpoint ao qual essa chave está associada e o valor da chave de opção. Além disso, instruções sobre como aplicar a chave e links relacionados à documentação estão incluídos (a documentação não é mostrada nesta imagem, esta parte foi omitida).

Há algum caso em que uma chave de opção não possa ser aplicada?

Sim, há certas circunstâncias sob as quais uma chave de opção não pode ser aplicada a um endpoint:

• Cada chave de opção é associada ao número de série de um endpoint específico. Você deve aplicar cada chave de opção ao ponto de extremidade para o qual você a solicitou. Se você tentar aplicar a chave de opção a outro endpoint, isso não funcionará.
• Você deve entrar em contato com os recursos oficiais da Cisco para obter as teclas de opção para os recursos que deseja ativar. Você não deve usar as Teclas de Opção da Internet de entidades não verificadas.
• Como a chave de opção está associada a um endpoint específico, você não pode transferi-la para um novo endpoint. Se um recurso habilitado por uma chave de opção não for mais necessário para um determinado ponto final, por exemplo, você o moveu para outro local, não poderá usar essa chave de opção em outro ponto final. Você precisa solicitar uma chave de opção para cada endpoint separadamente. (Há uma exceção a isso mencionada mais adiante)
• Se o seu endpoint já suportar um recurso e tiver uma chave de opção instalada nele por padrão, você não poderá usar outra chave de opção que habilite o mesmo recurso. Por exemplo, muitos dispositivos suportam criptografia pronta para uso. A chave de opção de criptografia que fornece ao dispositivo a capacidade de usar criptografia é instalada no dispositivo por padrão. Você não pode solicitar uma chave de opção para habilitar a criptografia e aplicá-la a este ponto de extremidade. As chaves de opção não podem ser empilhadas.
• Alguns endpoints não oferecem suporte a alguns recursos específicos. Por exemplo, alguns endpoints não oferecem suporte à criptografia. Você não pode usar uma chave de opção de criptografia nesses endpoints. Há limitações de hardware e software que impedem que o endpoint use esse recurso. É recomendável que você verifique a folha de dados do dispositivo específico antes de tentar aplicar qualquer tecla de opção a ela.
• Para alguns recursos, você precisa estar em uma versão mínima específica do SO para que eles estejam disponíveis. Se você acabou de receber um dispositivo via RMA, verifique se o dispositivo está no software mais recente antes de continuar aplicando uma chave de opção a ele.

Como verificar se um endpoint suporta uma chave de opção específica?

Há três maneiras diferentes de localizar as Option Keys suportadas por um endpoint.

Verificar a Folha de Dados do Ponto Final

Para verificar se o endpoint tem algum recurso adicional que você gostaria de habilitar com uma tecla de opção, você pode verificar a Folha de dados do endpoint. Para fins de demonstração, a ficha técnica do endpoint Codec Pro é usada:

Seção Opções de Software na Folha de Dados do Ponto Final

Na seção Informações de pedidos, navegue até Opções de software - solicitadas separadamente, onde você verá os recursos adicionais que podem ser adicionados ao endpoint. Na captura de tela fornecida, você pode ver o nome do recurso no lado esquerdo e o nome da tecla de opção no lado direito. Você pode observar que a chave de opção de criptografia não é mencionada porque ela vem pré-instalada no Codec Pro.

Verificar a GUI do endpoint

Você deve acessar a GUI do endpoint digitando seu endereço IP no navegador ou efetuando login no Control Hub e navegando até Devices, selecione o dispositivo desejado na lista e, na seção Support, clique em Launch ao lado de Local Device Controls. A GUI do endpoint será aberta em uma nova guia no navegador. Essas duas formas de acessar a GUI do endpoint exigem que você tenha acesso direto à rede para o endpoint.

Acessando a GUI do endpoint através do hub de controle - seção de suporte

Navegue até Software na seção Manutenção do sistema. Clique em Option Keys. Neste menu, você pode adicionar o valor da chave de opção na caixa de texto e clicar em Aplicar.

Localizando chaves de opção na GUI do endpoint

Na seção Installed Option Keys, você pode ver todas as Option Keys que seu endpoint está qualificado para ter instalado. Na coluna Status, você verá quais dessas chaves são Ative, o que significa que você já as instalou.

Você também tem a opção de excluir uma chave de opção desta seção clicando no ícone da lixeira ao lado de cada chave instalada.

Verificar Os Logs De Endpoint

Acesse a GUI do dispositivo e navegue até Issues and Diagnostics na seção System Maintenance. Clique em System Logs. Em seguida, clique na seta para baixo ao lado de Download logs e clique em Full logs (recommended). Um pacote de log compactado será baixado para o computador.

Coleta de logs na GUI do endpoint

Descompacte o pacote de log coletado e localize o arquivo xstatus.txt. Abra este arquivo em um aplicativo de anotações de sua escolha e procure a palavra-chave OptionKeys. Você pode encontrar todas as teclas de opção disponíveis para seu endpoint e ver quais delas foram adicionadas e estão ativas, o que é indicado pelo valor Verdadeiro ou Falso ao lado da linha de log correspondente:

Linhas de log de chave de opção do pacote de log coletado

Por que algumas teclas de opção não estão listadas na seção Option Key na GUI do endpoint?

Esta é uma imagem das Teclas de Opção relatadas nos arquivos de log de um Codec Pro com ID de Produto que contém o caractere "K9". Isso significa que o endpoint oferece suporte à criptografia.

Linhas de log de chave de opção do pacote de log coletado

Observe o trecho:

*s SystemUnit Software OptionKeys Encryption: True

Você pode ver que a chave de opção de criptografia está definida como True. Isso significa que a chave de opção foi aplicada ao endpoint.

Na GUI do endpoint, navegue até Software na seção Manutenção do sistema. Clique em Option Keys. Esta é a seção Installed Option Keys deste ponto de extremidade:

Seção de teclas de opção instaladas na GUI do endpoint

Você pode ver que a chave de opção de criptografia, que os logs mostram, não está presente nesta seção. Ele não só não é visto como instalado, como está ausente da lista.

Este é um comportamento esperado. Algumas chaves de opção são pré-instaladas nos endpoints, como as chaves de opção de criptografia. Como são pré-instalados de fábrica, eles não são listados na seção Installed Option Keys da GUI do endpoint. A seção Chaves de opção instaladas mostra apenas as chaves de opção que um administrador pode adicionar manualmente. A criptografia está disponível por padrão e, portanto, não é vista nesta seção.

Nessas situações, a única fonte de verdade são os logs do ponto final, se você quiser verificar se uma chave de opção específica está habilitada ou não. Se você redefinir um dispositivo de fábrica, as teclas de opção padrão não serão removidas. As chaves de opções que o administrador instala, e que não estão lá por padrão, também não são removidas após a redefinição de fábrica.

Regra geral para chaves de opção de criptografia

As chaves de opção de criptografia são um tipo de exceção, pois os recursos de criptografia são controlados pelas características de hardware e software dos endpoints. Há uma regra geral que você pode usar para identificar se o endpoint oferece suporte à criptografia e se ele está habilitado ou não, nos casos em que você não tiver certeza do número da ID do produto. Supõe-se que você tenha lido as seções anteriores deste artigo para poder executar as etapas descritas:

• Primeiro, procure a palavra-chave OptionKeys no arquivo de log xstatus.txt do ponto de extremidade.
• Se a chave de opção de criptografia estiver definida como True, ela oferecerá suporte à criptografia e estará habilitada. Se estiver definido como False, há uma chance de que o ponto final suporte criptografia, mas não esteja habilitado.
• Em seguida, observe a GUI do endpoint na seção Installed Option Keys.
• Se a chave de criptografia for instalável na GUI, você precisará obter uma chave e aplicá-la para ativar a criptografia.
• Se a chave de criptografia não puder ser instalada na GUI (você não a vê listada entre as chaves de opção disponíveis), seu endpoint não suporta criptografia e não há possibilidade de usar uma chave de opção para ativá-la.

Resumindo, para concluir que um endpoint não oferece suporte à criptografia quando a ID do produto não está disponível:

• Este trecho de código precisa ser visto nos logs de endpoint:

  *s SystemUnit Software OptionKeys Encryption: False

• A chave de opção de criptografia não pode ser vista como instalável na GUI do endpoint.

O que acontece após a realização de uma RMA?

Em uma seção anterior, foi mencionado que as teclas de opção que são geradas e fornecidas a você estão exclusivamente associadas ao número de série do seu endpoint. Nos casos em que um endpoint está enfrentando um problema de hardware e está qualificado para o processo de Autorização de devolução de material - RMA, você tem que devolver seu dispositivo de volta para a Cisco e receber um novo. O novo endpoint recebido não terá nenhuma chave de opção dos que você adicionou manualmente. Você precisa adicioná-los novamente.

Nesses casos, entre em contato com a equipe de licenciamento ou o TAC e explique a situação em um novo tíquete ou no tíquete existente que a RMA foi aprovada. A equipe de licenciamento compartilhará com você uma nova chave associada ao novo dispositivo. Você precisa aplicar esta chave ao dispositivo. A chave antiga se torna obsoleta e não pode mais ser usada. Qualquer tentativa de usar a chave de opção antiga no novo dispositivo recebido da RMA não será bem-sucedida e não é sugerida.

Como abrir um caso com a equipe de licenciamento?

Navegue até Support Case Manager. Faça login com sua conta da Cisco e clique em Open New Case. Navegue até Licenciamento de software e selecione Gerar licença. Em seguida, clique em Generate Traditional or Classic License through Enterprise Agreement Portal. Clique em Open Case.

Abrindo um caso relacionado ao licenciamento

Gerenciamento de chaves de opção com comandos xAPI

Você pode visitar esse link para ler a documentação do xAPI listando os comandos disponíveis que podem ser usados para gerenciar chaves de opção em um endpoint. Observe que além de adicionar e remover cada chave individualmente, existe a opção de excluir todas as chaves de opção de um ponto final: SystemUnit OptionKey RemoveAll. Não há opção para adicionar várias chaves de uma vez. A adição de chaves precisa ocorrer uma por uma manualmente.

Comando xAPI para gerenciar chaves de opção

Chaves de Produto vs Chaves de Opção

Uma chave do produto (Product Key) é diferente de uma chave de opção. As chaves de produto são usadas para transformar um determinado dispositivo de endpoint em outro dispositivo de endpoint com comportamento diferente e que, às vezes, também tem recursos diferentes. Por exemplo, uma chave de produto pode ser usada para transformar um Kit de Sala Mini em um USB de Sala. Com chaves de produto, você não está adicionando novos recursos a um dispositivo. Você está transformando um produto em um tipo de produto diferente. Não há suporte para isso em todos os pontos de extremidade. Muitos dispositivos têm a opção de alternar produtos de dentro de suas definições de configuração.

As chaves de produto são associadas ao número de série do dispositivo.

Informações Relacionadas

• Folha de dados do Codec Pro

• Support Case Manager
• Documentação xAPI do SO da sala

 </psee this