Instalar a licença do BroadWorks Server antes da atualização da versão principal

Introdução

Este documento descreve como instalar a licença local do servidor Cisco BroadWorks antes de atualizar o servidor BroadWorks para uma versão principal de software mais recente.

Pré-requisitos

A Cisco recomenda que você tenha conhecimento destes tópicos:

• Privilégio de Administrador de Sistema do Cisco BroadWorks.
• Manutenção de atualização do Cisco BroadWorks System, privilégio de atualização de licença.

Requisitos

Não há requisitos específicos para este documento.

Componentes Utilizados

Este documento não está restrito a versões especiais de software e hardware.

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. 

Informações de Apoio

Historicamente, antes de atualizar um servidor BroadWorks de uma versão principal anterior para uma versão principal mais recente, há três métodos para instalar a licença de versão do servidor de destino. 

No recente documento de manutenção do CiscoBroadWorks Server, a recomendação para usar o script install-license.pl. No entanto, o documento de manutenção R25/R26 Guia de gerenciamento de software CiscoBroadWorks não deixa claro como executar exatamente essa licença de instalação.pl script.  Este documento fornece uma explicação detalhada sobre como executar install-license.pl para preparar uma atualização de servidor BroadWorks para uma versão principal mais recente e também compartilhar os dois outros métodos para conseguir isso.

Sintomas de uma falha na instalação da licença

• Carregue a nova licença no servidor BroadWorks e execute o arquivo install-license.pl <newLicenseFilename>.zip.  Este comando falhou e recebeu um aviso de "Assinatura de licença inválida".

  bwadmin@BW_Server_hostname$ /usr/local/broadworks/bw_base/bin/install-license.pl /bw/install/license_CXXXXX_<Customer_Name>_R26.0_20260930.zip
  Unable to install license: Invalid license signature

• Compare o UUID do BroadWorks Server ou a impressão digital, se este servidor BroadWorks for um servidor NFM BroadWorks, com a nova licença para verificar a correspondência.

• Verifique o arquivo lmLog<timestamp>.txt que cobre a hora da instalação da licença com falha para identificar essa é uma dificuldade do código de erro 2.

  • bwadmin@BW_Server_hostname$ bwTrafficParser -m "Invalid license signature" lmLog2026.10.01-00.01.07.txt
    ...<?xml version="1.0" encoding="UTF-8"?><broadworks xmlns="http://schema.broadsoft.com/LicenseManager" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><ImportLicenseResponse><error>true</error><errorInfo><code>2</code><msg>Invalid license signature</msg></errorInfo><restartRequired>false</restartRequired></ImportLicenseResponse></broadworks>...

• As informações anteriores são adequadas para concluir que a causa raiz da dificuldade é a licença de servidor BroadWorks de destino, válida para a versão principal mais recente do servidor BroadWorks, que não é suportada pelo script atual do diretório binário da versão do servidor BroadWorks install-license.pl.

Informações necessárias para TAC para triagem

Estas são as informações que o Centro de Assistência Técnica (TAC) precisa para fazer a triagem:

• O arquivo atual de suporte técnico do BroadWorks Server
• A execução de /var/broadworks/logs/lmd/lmLog<timestamp>.txt que abrange essa falha install-license.pl, que foi negada pela causa 'Assinatura de licença inválida' e código de erro 2.
• O novo arquivo de licença que não passou na execução do install-license.pl.
• O registro de saída da sessão que abrange o comando 'qversions' do BroadWorks server BW_CLI
       

Etapa de configuração para atenuar esse problema

• Você pode alterar para o diretório binário do servidor BroadWorks da nova versão de destino da atualização como usuário bwadmin, para executar o script install-license.pl para o novo arquivo de licença da versão do servidor BroadWorks de destino.

  bwadmin@BW_Server_hostname$ cd /usr/local/broadworks/<target new release>/bin/
  bwadmin@BW_Server_hostname$ ./install-license.pl /bw/install/license_CXXXXX_<Customer_Name>_R26.0_20260930.zip
  bwadmin@BW_Server_hostname$

• Como alternativa, você pode atualizar o servidor BroadWorks para a nova versão de destino do servidor BroadWorks primeiro.  A ação de atualização altera o link do símbolo /usr/local/broadworks/bw_base para o novo diretório de versão do servidor BroadWorks.  Em seguida, execute o install-license.pl para instalar o novo arquivo de licença de versão do servidor BroadWorks.

• Há uma terceira opção para instalar o novo arquivo de licença de servidor BroadWorks ao mesmo tempo durante a instalação do novo estágio de versão binária do servidor BroadWorks. Isso é para fornecer o diretório e o nome de arquivo do novo arquivo de licença durante a instalação interativa, ou se você executar uma instalação não interativa com o arquivo installation.conf que tem uma diretiva LICENSE_FILE define o local da nova licença e o nome do arquivo.

  bwadmin@BW_Server_hostname$ grep LICENSE_FILE /var/broadworks/installation.conf
  LICENSE_FILE=/tmp/license_CXXXXX_CustomerName10022026_20261002.zip
  bwadmin@BW_Server_hostname$

Informações Relacionadas

•  Guia de gerenciamento de software Cisco BroadWorks 

Histórico de revisões

Revisão	Data de publicação	Comentários
1.0	19-Oct-2026	Versão inicial