Instalar la licencia de BroadWorks Server antes de actualizar la versión principal

Introducción

Este documento describe cómo instalar la licencia local del servidor de Cisco BroadWorks antes de actualizar el servidor de BroadWorks a una versión de software principal más reciente.

Prerequisites

Cisco recomienda que tenga conocimiento sobre estos temas:

• Privilegio de administrador del sistema Cisco BroadWorks.
• Mantenimiento de actualizaciones del sistema Cisco BroadWorks, privilegios de actualización de licencias.

Requirements

No hay ningún requisito específico para este documento.

Componentes Utilizados

Este documento no se limita a una versión especial de software y hardware.

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando. 

Antecedentes

Históricamente, antes de actualizar un servidor BroadWorks de una versión anterior de un servidor principal a una versión más reciente de un servidor principal, existen tres métodos para instalar la licencia de la versión del servidor de destino. 

En el reciente documento de mantenimiento de CiscoBroadWorks Server, se recomienda utilizar el install-license.pl. Sin embargo, el documento de mantenimiento R25/R26 Guía de administración de software de CiscoBroadWorks no deja claro cómo ejecutar exactamente este archivo install-license.pl script.  Este documento proporciona una explicación detallada sobre cómo ejecutar install-license.pl para preparar una actualización del servidor de BroadWorks a una versión principal más reciente y también compartir los otros dos métodos para lograr esto.

Síntomas de una instalación de licencia fallida

• Cargue la nueva licencia en el servidor de BroadWorks y ejecute el archivo install-license.pl <newLicenseFilename>.zip.  Error al ejecutar este comando y se recibe una advertencia de "firma de licencia no vá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 el UUID o la huella dactilar del servidor BroadWorks, si este servidor BroadWorks es un servidor NFM BroadWorks, con la nueva licencia para verificar una coincidencia.

• Verifique el lmLog<timestamp>.txt que cubre el tiempo de la instalación de la licencia con fallas para identificar que ésta es una dificultad del código de error 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>...

• La información anterior es adecuada para una conclusión de que la causa raíz de la dificultad es la licencia del servidor BroadWorks de destino válida para la versión más reciente del servidor BroadWorks, no es compatible con el script actual directoryinstall-license.pl de la versión del servidor BroadWorks.

Información necesaria para que el TAC realice el diagnóstico

A continuación se muestra la información que necesita el Technical Assistance Center (TAC) para realizar la clasificación:

• El archivo de soporte técnico actual de BroadWorks Server
• El archivo /var/broadworks/logs/lmd/lmLog<timestamp>.txt que cubre esta falla en la ejecución de install-license.pl, que había sido denegada por causa 'firma de licencia no válida' y código de error 2.
• El nuevo archivo de licencia que no pasó la ejecución install-license.pl.
• El registro de salida de sesión que cubre este comando 'qversions' de BW_CLI del servidor BroadWorks
       

Paso de configuración para mitigar este problema

• Puede cambiar al nuevo directorio binario del servidor BroadWorks de destino de actualización como usuario bwadmin, para ejecutar el script install-license.pl para el nuevo archivo de licencia de versión del 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, puede actualizar primero el servidor BroadWorks a la nueva versión del servidor BroadWorks de destino.  La acción de actualización cambia el enlace del símbolo /usr/local/broadworks/bw_base al nuevo directorio de versiones del servidor BroadWorks.  A continuación, ejecute install-license.pl para instalar el nuevo archivo de licencia de versión del servidor de BroadWorks.

• Existe una tercera opción para instalar el nuevo archivo de licencia del servidor BroadWorks al mismo tiempo durante la instalación de la nueva etapa de lanzamiento binario del servidor BroadWorks. Esto es para proporcionar el directorio y el nombre de archivo del nuevo archivo de licencia durante la instalación interactiva, o si ejecuta una instalación no interactiva con el archivo installation.conf que tiene una directiva LICENSE_FILE define la nueva ubicación de licencia y el nombre de archivo.

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

Información Relacionada

•  Guía de administración de software de Cisco BroadWorks 

Historial de revisiones

Revisión	Fecha de publicación	Comentarios
1.0	19-Oct-2026	Versión inicial