Installa la licenza del server BroadWorks prima di aggiornare la versione principale

Introduzione

In questo documento viene descritto come installare la licenza locale del server Cisco BroadWorks prima di aggiornare il server BroadWorks a una versione principale più recente del software.

Prerequisiti

Cisco raccomanda la conoscenza dei seguenti argomenti:

• Privilegio Cisco BroadWorks System Administrator.
• Manutenzione dell'aggiornamento del sistema Cisco BroadWorks, privilegio di aggiornamento della licenza.

Requisiti

Non sono richieste specifiche per questo documento.

Componenti usati

Il documento può essere consultato per tutte le versioni software o hardware.

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi. 

Premesse

Prima di aggiornare un server BroadWorks da una versione principale precedente a una versione principale più recente, sono disponibili tre metodi per installare la licenza di versione del server di destinazione. 

Nel recente documento di manutenzione relativo al server Cisco BroadWorks, i consigli per utilizzare install-license.pl. Tuttavia, il documento di manutenzione di R25/R26 Cisco BroadWorks Software Management Guide (Guida alla gestione del software Cisco BroadWorks) non chiarisce esattamente come eseguire questa licenza di installazione.pl script.  Questo documento fornisce una spiegazione dettagliata su come eseguire install-license.pl per preparare un aggiornamento del server BroadWorks a una versione principale più recente e condividere gli altri due metodi per ottenere questo risultato.

Sintomi di un'installazione non riuscita della licenza

• La nuova licenza viene caricata nel server BroadWorks ed eseguita install-license.pl <newLicenseFilename>.zip.  Il comando non è riuscito e viene visualizzato l'avviso "Firma della licenza non valida".

  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

• Confrontare l'UUID o l'impronta digitale del server BroadWorks, se si tratta di un server BroadWorks NFM, con la nuova licenza per verificare la corrispondenza.

• Controllare il file lmLog<timestamp>.txt relativo all'ora dell'installazione della licenza non riuscita per verificare se si tratta di un errore di codice 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>...

• Le informazioni precedenti sono sufficienti per concludere che la causa principale del problema è la licenza del server BroadWorks di destinazione valida per la versione principale più recente del server BroadWorks, non supportata dallo script corrente directory binaria-install-license.pl della versione del server BroadWorks.

Informazioni necessarie per il triage del TAC

Di seguito vengono riportate le informazioni necessarie per individuare il centro di assistenza tecnica (TAC):

• L'attuale file di supporto tecnico del server BroadWorks
• Il file /var/broadworks/logs/lmd/lmLog<timestamp>.txt relativo a questo errore di esecuzione di install-license.pl, che è stato negato per causa 'Firma della licenza non valida' e codice di errore 2.
• Il nuovo file di licenza che non ha superato l'esecuzione di install-license.pl.
• Il log di output della sessione relativo a questo comando BW_CLI del server BroadWorks 'qversions'
       

Passaggio di configurazione per risolvere il problema

• È possibile passare alla directory binaria del server BroadWorks della nuova release di destinazione dell'aggiornamento come bwadmin user, per eseguire lo script install-license.pl per il nuovo file di licenza del server BroadWorks di destinazione.

  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$

• In alternativa, è possibile aggiornare prima il server BroadWorks alla nuova versione di destinazione del server BroadWorks.  L'azione upgrade consente di modificare il collegamento del simbolo /usr/local/broadworks/bw_base nella nuova directory di rilascio del server BroadWorks.  Eseguire quindi il file install-license.pl per installare il nuovo file di licenza del server BroadWorks.

• È disponibile una terza opzione per installare contemporaneamente il nuovo file di licenza del server BroadWorks durante l'installazione della nuova fase di rilascio binario del server BroadWorks. ovvero fornire la directory e il nome del nuovo file di licenza durante l'installazione interattiva, oppure se si esegue un'installazione non interattiva con il file installation.conf che dispone di una direttiva LICENSE_FILE definisce la nuova posizione della licenza e il nome del file.

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

Informazioni correlate

•  Guida alla gestione del software Cisco BroadWorks 

Cronologia delle revisioni

Revisione	Data di pubblicazione	Commenti
1.0	19-Oct-2026	Versione iniziale