メジャーリリースのアップグレードの前にBroadWorks Serverライセンスをインストールする

概要

このドキュメントでは、BroadWorksサーバを新しいメジャーソフトウェアリリースにアップグレードする前に、Cisco BroadWorksサーバローカルライセンスをインストールする方法について説明します。

前提条件

次の項目に関する知識があることが推奨されます。

• Cisco BroadWorks System Administrator権限
• Cisco BroadWorksシステムアップグレードのメンテナンス、ライセンスのアップデート権限。

要件

このドキュメントに関する特別な要件はありません。

使用するコンポーネント

このドキュメントは、特別なソフトウェアおよびハードウェアのバージョンに限定されるものではありません。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期（デフォルト）設定の状態から起動しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。 

背景説明

従来、BroadWorksサーバーを以前のメジャーサーバーリリースから新しいメジャーサーバーリリースにアップグレードする前に、ターゲットサーバーリリースライセンスをインストールする方法は3つあります。 

CiscoBroadWorks Serverの最新のメンテナンスドキュメントで、 install-license.plスクリプトを実行します。ただし、R25/R26のメンテナンス文書『CiscoBroadWorks Software Management Guide』では、このinstall-license.plを正確に実行する方法が明確になっていません このドキュメントでは、install-license.plを実行してBroadWorksサーバの新しいメジャーリリースへのアップグレードを準備する方法、および他の2つの方法を共有してアップグレードを実行する方法について詳しく説明します。

ライセンスのインストール失敗の症状

• 新しいライセンスをBroadWorksサーバにアップロードし、install-license.pl <newLicenseFilename>.zipを実行します。  このコマンドは失敗し、「Invalid license signature」という警告を受け取ります。

  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

• BroadWorksサーバがBroadWorks NFMサーバである場合は、BroadWorksサーバのUUIDまたはフィンガープリントと、一致を確認するための新しいライセンスを比較します。

• 障害ライセンスのインストール時刻を含むlmLog<timestamp>.txtを調べて、これがエラーコード2の問題であることを確認します。

  • bwadmin@BW_Server_hostname$ bwTrafficParser -m "Invalid license signature" lmLog2026.10.01-00.01.07.txt
    ...true2Invalid license signaturefalse...

• 上記の情報は、問題の根本原因が新しいメジャーBroadWorksサーバリリースに有効なターゲットBroadWorksサーバライセンスであり、現在のBroadWorksサーバリリースのバイナリdirectoryinstall-license.plスクリプトではサポートされていないという結論に対して適切です。

TACがトリアージを行うために必要な情報

トリアージを行うためにTechnical Assistance Center(TAC)が必要とする情報を次に示します。

• 現在のBroadWorks Serverテクニカルサポートファイル
• /var/broadworks/logs/lmd/lmLog<timestamp>.txtに、原因「Invalid license signature」とエラーコード2によって拒否されたこの障害install-license.plの実行が記録されています。
• install-license.pl の実行に失敗した新しいライセンスファイル。
• このBroadWorksサーバBW_CLIコマンド「qversions」を対象としたセッション出力ログ
       

この問題を軽減するための設定手順

• アップグレード対象となる新しいリリースのBroadWorksサーバのバイナリディレクトリにbwadminユーザとして変更し、対象となる新しいBroadWorksサーバのリリースライセンスファイルに対してinstall-license.plスクリプトを実行します。

  bwadmin@BW_Server_hostname$ cd /usr/local/broadworks//bin/
  bwadmin@BW_Server_hostname$ ./install-license.pl /bw/install/license_CXXXXX__R26.0_20260930.zip
  bwadmin@BW_Server_hostname$

• または、最初にBroadWorksサーバーを新しいBroadWorksサーバーのターゲットリリースにアップグレードします。  アップグレードアクションによって、/usr/local/broadworks/bw_baseシンボルリンクが新しいBroadWorksサーバリリースディレクトリに変更されます。  次に、install-license.plを実行して、新しいBroadWorksサーバリリースライセンスファイルをインストールします。

• 新しいBroadWorksサーババイナリリリース段階のインストール中に、新しいBroadWorksサーバライセンスファイルを同時にインストールする3つ目のオプションがあります。つまり、対話型インストール時に新しいライセンスファイルのディレクトリとファイル名を指定するか、または新しいライセンスの場所とファイル名を定義するディレクティブLICENSE_FILEを含むinstallation.confファイルを使用して非対話型インストールを実行する場合です。

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

関連情報

•  Cisco BroadWorksソフトウェア管理ガイド 

更新履歴

改定	発行日	コメント
1.0	19-Oct-2026	初版