在升级主版本之前安装BroadWorks服务器许可证

简介

本文档介绍在将BroadWorks服务器升级到更新的主要软件版本之前，如何安装Cisco BroadWorks服务器本地许可证。

先决条件

Cisco 建议您了解以下主题：

• Cisco BroadWorks系统管理员权限。
• Cisco BroadWorks系统升级维护，更新许可证权限。

要求

对于本文档没有特定要求。

使用的组件

本文档不限于特殊软件和硬件版本。

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。 

背景信息

以前，将BroadWorks服务器从以前的主服务器版本升级到更新的主服务器版本之前，有三种方法可以安装目标服务器版本许可证。 

在最新的CiscoBroadWorks服务器维护文档中，建议使用 install-license.pl脚本。但是，R25/R26维护文档《CiscoBroadWorks软件管理指南》没有明确说明如何准确执行此install-license.pl 脚本。  本文档详细说明了如何执行install-license.pl以准备BroadWorks服务器升级到更新的主要版本，并分享了实现此目标的另外两种方法。

许可证安装失败的症状

• 将新许可证上传到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分类所需信息

以下为技术支持中心(TAC)进行分类所需的信息：

• 当前的BroadWorks Server技术支持文件
• /var/broadworks/logs/lmd/lmLog<timestamp>.txt涵盖此故障install-license.pl执行，该故障已因“Invalid license signature”和错误代码2而被拒绝。
• 未通过install-license.pl执行的新许可证文件。
• 包含此BroadWorks服务器BW_CLI命令“qversions”的会话输出日志
       

缓解此问题的配置步骤

• 您可以以bwadmin用户的身份更改到升级目标新版本BroadWorks服务器二进制目录，以便为目标新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服务器许可证文件。也就是说，在交互式安装期间提供新许可证文件的目录和文件名，或者，如果使用installation.conf文件执行非交互式安装，则使用LICENSE_FILE指令定义新的许可证位置和文件名。

  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	初始版本