Installation der BroadWorks-Serverlizenz vor dem Upgrade der Hauptversion

Einleitung

In diesem Dokument wird beschrieben, wie Sie die lokale Lizenz für den Cisco BroadWorks-Server installieren, bevor Sie für den BroadWorks-Server ein Upgrade auf eine neuere Hauptversion der Software durchführen.

Voraussetzungen

Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:

• Cisco BroadWorks-Systemadministratorberechtigung.
• Wartung und Aktualisierung von Cisco BroadWorks-System-Upgrades.

Anforderungen

Für dieses Dokument bestehen keine spezifischen Anforderungen.

Verwendete Komponenten

Dieses Dokument ist nicht auf spezielle Software- und Hardwareversionen beschränkt.

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die möglichen Auswirkungen aller Befehle kennen. 

Hintergrundinformationen

Bisher gibt es drei Methoden, um die Lizenz für die Zielserverversion zu installieren, bevor Sie einen BroadWorks-Server von einer früheren Hauptserverversion auf eine neuere Hauptserverversion aktualisieren. 

Im aktuellen Wartungsdokument für den Cisco BroadWorks-Server wird empfohlen, install-license.pl-Skript. Im Wartungsdokument für R25/R26, das Cisco BroadWorks Software Management Guide enthält, ist jedoch nicht klar, wie diese Installationslizenz auszuführen ist.pl Skript.  In diesem Dokument finden Sie ausführliche Erläuterungen zur Ausführung von install-license.pl zur Vorbereitung eines BroadWorks-Server-Upgrades auf eine neuere Hauptversion sowie zur gemeinsamen Nutzung der beiden anderen Methoden, um dieses Ziel zu erreichen.

Symptome einer fehlgeschlagenen Installation einer Lizenz

• Sie laden die neue Lizenz auf den BroadWorks-Server hoch und führen die Datei install-license.pl <newLicenseFilename>.zip aus.  Dieser Befehl ist fehlgeschlagen und erhält die Warnung "Ungültige Lizenzsignatur".

  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

• Vergleichen Sie die UUID oder den Fingerabdruck des BroadWorks-Servers, wenn es sich bei diesem BroadWorks-Server um einen BroadWorks NFM-Server handelt, mit der neuen Lizenz, um eine Übereinstimmung zu überprüfen.

• Überprüfen Sie in lmLog<timestamp>.txt den Zeitpunkt der Installation der Fehlerlizenz, um festzustellen, dass es sich um einen Fehler mit Fehlercode 2 handelt.

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

• Die vorherigen Informationen sind ausreichend, um zu dem Schluss zu kommen, dass die Ursache des Problems in der Ziellizenz für den BroadWorks-Server liegt, die für eine neuere Hauptversion des BroadWorks-Servers gültig ist und vom aktuellen binären Skript directoryinstall-license.pl der BroadWorks-Serverversion nicht unterstützt wird.

Erforderliche Informationen für TAC-Triage

Hier finden Sie die erforderlichen Informationen für das Technical Assistance Center (TAC), um die folgenden Elemente einzuordnen:

• Die aktuelle BroadWorks Server-Datei für den technischen Support
• Die Datei /var/Broadworks/logs/lmd/lmLog<timestamp>.txt, die diesen Fehler bei der Ausführung von install-license.pl behandelt und durch die Ursache "Invalid license signature" (Ungültige Lizenzsignatur) und Fehlercode 2 abgelehnt wurde.
• Die neue Lizenzdatei, die die Ausführung von install-license.pl nicht bestanden hat.
• Das Sitzungsausgabeprotokoll für den BW_CLI-Befehl 'qversions' des BroadWorks-Servers.
       

Konfigurationsschritt zur Behebung dieses Problems

• Sie können das neue Binärverzeichnis des BroadWorks-Servers als bwadmin-Benutzer in das Upgrade-Ziel ändern, um das Skript install-license.pl für die neue Ziellizenzdatei für die BroadWorks-Serverversion auszuführen.

  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$

• Alternativ können Sie den BroadWorks-Server zunächst auf die neue Zielversion von BroadWorks aktualisieren.  Die Upgrade-Aktion ändert die Verknüpfung /usr/local/Broadworks/bw_base in das neue BroadWorks-Server-Release-Verzeichnis.  Führen Sie anschließend die Datei install-license.pl aus, um die neue Lizenzdatei für die BroadWorks-Serverversion zu installieren.

• Es gibt eine dritte Option, um eine neue BroadWorks-Server-Lizenzdatei während der Installation der neuen binären Version des BroadWorks-Servers zu installieren. Dies bedeutet, dass das Verzeichnis und der Dateiname der neuen Lizenzdatei während der interaktiven Installation angegeben werden, oder wenn Sie eine nicht interaktive Installation mit der Datei installation.conf durchführen, die eine Direktive LICENSE_FILE hat, die den neuen Lizenzspeicherort und den Dateinamen definiert.

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

Zugehörige Informationen

•  Cisco BroadWorks Software Management-Leitfaden 

Revisionsverlauf

Überarbeitung	Veröffentlichungsdatum	Kommentare
1.0	19-Oct-2026	Erstveröffentlichung