Installation de la licence BroadWorks Server avant la mise à niveau

Introduction

Ce document décrit comment installer la licence locale du serveur Cisco BroadWorks avant de mettre à niveau le serveur BroadWorks vers une version logicielle majeure plus récente.

Conditions préalables

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Privilège administrateur système Cisco BroadWorks.
• Maintenance de mise à niveau de Cisco BroadWorks System, privilège de licence de mise à jour.

Exigences

Il n'y a aucune exigence particulière pour ce document.

Composants utilisés

Ce document n'est pas limité à une version logicielle et matérielle spéciale.

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. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes. 

Informations générales

Historiquement, avant de mettre à niveau un serveur BroadWorks d'une version précédente vers une version plus récente, il existe trois méthodes pour installer la licence de version du serveur cible. 

Dans le document de maintenance récent de CiscoBroadWorks Server, les conseils pour utiliser le script install-license.pl. Cependant, le document de maintenance R25/R26 CiscoBroadWorks Software Management Guide ne précise pas comment exécuter cette install-license.pl script.  Ce document fournit des explications détaillées sur la façon d'exécuter install-license.pl pour préparer une mise à niveau du serveur BroadWorks vers une version majeure plus récente et partage également les deux autres méthodes pour y parvenir.

Symptômes d'un échec d'installation de licence

• Vous téléchargez la nouvelle licence sur le serveur BroadWorks et exécutez le fichier install-license.pl <nouveauNomFichierLicence>.zip.  Cette commande a échoué et a reçu l'avertissement « Signature de licence non valide ».

  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

• Comparez l'UUID ou l'empreinte digitale du serveur BroadWorks, si ce serveur BroadWorks est un serveur BroadWorks NFM, avec la nouvelle licence pour vérifier une correspondance.

• Vérifiez le fichier lmLog<timestamp>.txt indiquant l'heure de l'échec de l'installation de la licence pour identifier qu'il s'agit d'une erreur de code 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>...

• Les informations précédentes permettent de conclure que la cause principale du problème est la licence de serveur BroadWorks cible valide pour la version majeure plus récente du serveur BroadWorks, qui n'est pas prise en charge par le script binaire directoryinstall-license.pl de la version actuelle du serveur BroadWorks.

Informations requises pour le centre d'assistance technique au triage

Voici les informations dont le centre d'assistance technique (TAC) a besoin pour effectuer le tri :

• Le fichier d'assistance technique BroadWorks Server actuel
• Le fichier /var/broadworks/logs/lmd/lmLog<timestamp>.txt qui couvre cette erreur d'exécution de install-license.pl, qui a été refusée pour la cause « Signature de licence non valide » et le code d'erreur 2.
• Nouveau fichier de licence qui n'a pas réussi l'exécution de install-license.pl.
• Journal de sortie de session couvrant cette commande BW_CLI du serveur BroadWorks 'qversions'
       

Étape de configuration pour limiter ce problème

• Vous pouvez passer au répertoire binaire du serveur BroadWorks nouvelle version cible de mise à niveau en tant qu'utilisateur bwadmin, pour exécuter le script install-license.pl pour le fichier de licence de la nouvelle version du serveur BroadWorks cible.

  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$

• Vous pouvez également mettre à niveau le serveur BroadWorks vers la nouvelle version du serveur BroadWorks cible.  L'action de mise à niveau modifie le lien du symbole /usr/local/broadworks/bw_base vers le nouveau répertoire de version du serveur BroadWorks.  Exécutez ensuite le fichier install-license.pl pour installer le nouveau fichier de licence de version serveur BroadWorks.

• Il existe une troisième option pour installer le nouveau fichier de licence du serveur BroadWorks en même temps que vous installez la nouvelle version binaire du serveur BroadWorks. C'est-à-dire fournir le répertoire et le nom de fichier du nouveau fichier de licence pendant l'installation interactive, ou si vous exécutez une installation non interactive avec le fichier installation.conf qui a une directive LICENSE_FILE définit le nouvel emplacement de licence et le nom de fichier.

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

Informations connexes

•  Guide de gestion du logiciel Cisco BroadWorks 

Historique de révision

Révision	Date de publication	Commentaires
1.0	19-Oct-2026	Première publication