BroadWorks-serverlicentie installeren vóór belangrijke upgrade-versie

Inleiding

In dit document wordt beschreven hoe u de lokale licentie van de Cisco BroadWorks-server installeert voordat u de BroadWorks-server upgradt naar een nieuwere belangrijke softwarerelease.

Voorwaarden

Cisco raadt kennis van de volgende onderwerpen aan:

• Cisco BroadWorks System Administrator-privilege.
• Cisco BroadWorks System upgrade onderhoud, update licentie privilege.

Vereisten

Voor dit document zijn geen specifieke eisen gesteld.

Gebruikte componenten

Dit document is niet beperkt tot speciale software- en hardwareversies.

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt. 

Achtergrondinformatie

Historisch gezien, voordat u een BroadWorks-server van een eerdere grote serverrelease naar een nieuwere grote serverrelease upgradt, zijn er drie methoden om de doelserverrelease-licentie te installeren. 

In het recente CiscoBroadWorks Server-onderhoudsdocument wordt het advies om de Installeer-license.pl script. Het onderhoudsdocument R25/R26 CiscoBroadWorks Software Management Guide maakt echter niet duidelijk hoe deze installatielicentie precies moet worden uitgevoerd.pl script. Dit document geeft gedetailleerde uitleg over hoe u install-license.pl uitvoert om een BroadWorks-serverupgrade voor te bereiden op een nieuwere belangrijke release en ook de twee andere methoden te delen om dit te bereiken.

Symptomen van een mislukte licentieinstallatie

• U uploadt de nieuwe licentie naar de BroadWorks-server en voert de installatie-license.pl <newLicenseFilename>.zip uit.  Deze opdracht is mislukt en ontvangt een waarschuwing voor de "Ongeldige licentiehandtekening".

  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

• Vergelijk de BroadWorks Server UUID of vingerafdruk, als deze BroadWorks-server een BroadWorks NFM-server is, met de nieuwe licentie om een overeenkomst te verifiëren.

• Controleer de lmLog<timestamp>.txt die de tijd van de mislukte licentieinstallatie bestrijkt om te identificeren dat dit een foutcode 2-moeilijkheid is.

  • 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>...

• De vorige informatie is voldoende voor een conclusie dat de hoofdoorzaak van de moeilijkheid de doellicentie van de BroadWorks-server is die geldig is voor een nieuwere belangrijke BroadWorks-serverrelease, die niet wordt ondersteund door het huidige BroadWorks-serverrelease-binaire directoryinstall-license.pl-script.

Vereiste informatie voor TAC tot Triage

Hier is de informatie die het Technical Assistance Center (TAC) nodig heeft om te triageren:

• Het huidige technische ondersteuningsbestand van BroadWorks Server
• De /var/broadworks/logs/lmd/lmLog<timestamp>.txt die deze fout install-license.pl uitvoering, die was geweigerd door oorzaak 'Ongeldige licentiehandtekening' en foutcode 2.
• Het nieuwe licentiebestand dat de uitvoering van install-license.pl niet heeft doorstaan.
• Het uitvoerlog van de sessie dat betrekking heeft op deze BroadWorks-server BW_CLI-opdracht 'aversies'
       

Configuratiestap om dit probleem te beperken

• U kunt als bwadmin-gebruiker overschakelen naar de nieuwe BroadWorks-serverbinaire directory voor de upgrade van de doelversie om het install-license.pl-script voor het doelnieuwe BroadWorks-serverrelease-licentiebestand uit te voeren.

  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$

• Als alternatief kunt u de BroadWorks-server eerst upgraden naar de doelversie van de nieuwe BroadWorks-server.  Met de upgradeactie wordt de koppeling /usr/local/broadworks/bw_base-symbool gewijzigd in de nieuwe directory voor de release van de BroadWorks-server.  Vervolgens voert u de install-license.pl uit om het nieuwe BroadWorks server release-licentiebestand te installeren.

• Er is een derde optie om een nieuw BroadWorks-serverlicentiebestand tegelijkertijd te installeren tijdens de installatie van de nieuwe BroadWorks-server met binaire release. Dat is om de directory en bestandsnaam van het nieuwe licentiebestand op te geven tijdens de interactieve installatie, of als u een niet-interactieve installatie uitvoert met het bestand install.conf met een richtlijn LICENSE_FILE definieert de nieuwe licentielocatie en bestandsnaam.

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

Gerelateerde informatie

•  Cisco BroadWorks Software Management Guide 

Revisiegeschiedenis

Revisie	Publicatiedatum	Opmerkingen
1.0	19-Oct-2026	Eerste vrijgave