升级核对表和交换许可证密钥

营销结束: 自 2025 年 10 月 31 日起，新客户将无法再部署 VMware Solutions 的相关服务。 现有客户仍可在 IBM Cloud® 上继续使用并扩展其正在运行的 VMware® 工作负载。 欲了解更多信息，请参阅 IBM Cloud 上的 VMware 营销结束。

将现有的 VMware vCloud 使用量计量表升级至 9.x 或更高版本。 VMware vCloud 使用量统计工具的最新可用版本为 v9.1.0。 对于使用量计量器 v4.8，升级过程包括通过 IBM Cloud 使用量计量器门户获取您当前已注册的使用量计量器的访问令牌，随后首先对 v9.0.1 进行就地升级。 在首次升级至 v9.0.1 后，后续升级至 v9.x 或更高版本时，无需提供访问令牌。

对于 Usage Meter v4.8，不支持从 Usage Meter v4.8 直接升级到 v9.1。 您必须先将版本从 4.8 升级到 9.0.1，然后再升级到 9.1。 如需了解更多信息，请参阅 《升级路径——产品互操作性对照表》。

在升级到第 9 版或更高版本之前，必须交换 VMware Cloud Foundation™ ( VCF ) 许可证密钥。

交换许可证密钥的步骤

  1. 获取新的 Broadcom 许可证密钥，然后从 VMware Solutions 控制台获取 VMware Cloud Foundation ( VCF ) 许可证密钥。 更多信息，请参阅 检索 VCF 许可证密钥。
  2. 获取 VMware 附加密钥。 更多信息，请参阅 获取 VMware 附加密钥。
  3. 将新的许可证密钥添加到所有 VMware 产品，然后根据需要分配许可证。 更多信息，请参阅 管理 VMware 产品许可证。

升级用量计的步骤

要升级“使用量计”，请按照以下步骤操作：

启用 SSH 登录

  1. 通过 https://<Usage Meter IP>:5480 以 usagemeter 用户登录 VMware vCloud Usage Meter 设备管理控制台。
  2. 单击左侧导航面板中的“访问”。
  3. 在访问设置下，单击右上角的编辑。
  4. 在 “编辑访问设置”窗口中，打开启用 SSH 登录开关。 SSH 登录更改为已启用。

安装升级 ISO 文件

  1. 请从以下链接下载 Usage Meter 的 ISO 文件：

    • 若要将 Usage Meter v4.8 （或更早版本）升级至 v9.0.1，请访问：https://ibm.biz/~V0YiDk0EP。
    • 若要将 Usage Meter（ v9.0.1 ）升级至 v9.1.0，请访问：https://ibm.biz/~aBF0Bw0fU。

  2. 根据以下 SHA-256 中的值，验证 SHA-2 的校验和：

    • 有关从 Usage Meter v4.8 （或更早版本）升级到 v9.0.1 的信息，请参阅：ec5c46b4bdae915cb4a289dfbb03077cb802f404692bb3f2501b59b448102797。
    • 有关从 Usage Meter v9.0.1 升级到 v9.1.0 的信息，请参阅：d1f79f1bcc711c7753c871bd95bc434e8a31bb8fc584fc7ac88b75398be445c1。

    在 Windows® 上打开命令提示符，或在 Linux® 和 MacOS 上打开终端窗口，然后运行以下命令：

    • 对于 Windows： certutil -hashfile <path-to-iso-file> SHA256
    • 对于 Linux： sha256sum <path-to-iso-file>
    • 对于 macOS： shasum -a 256 <path-to-iso-file>

  3. 在 VMware vSphere® Web Client 中，登录 vCenter Server 实例。

  4. 在存储菜单下，选择 Usage Meter 虚拟机 ( VM ) 所在的数据存储。

  5. 在虚拟机选项卡中，单击虚拟机并验证使用情况计量器是否位于目标数据存储上。

  6. 在文件选项卡中，单击上传文件。 ISO 文件开始上传。

    您可能会收到有关主机证书的错误信息。 要解决这个问题，请在另一个网页浏览器选项卡中打开错误中显示的指定 URL，并接受证书。 如果无法加载，请确认主机是否在当前桌面 DNS 中，然后再次访问 URL。

  7. 上传完成后，ISO 文件将出现在文件列表中。

  8. 在“主机和群集”菜单下，找到并右键单击“用量表 VM”，然后选择“编辑设置”。

  9. 在虚拟硬件选项卡的 CD/DVD 驱动器上，选择数据存储 ISO 文件，然后单击确定。

    如果没有看到 CD/DVD 驱动器选项，请单击添加新设备。

  10. 在 “选择文件”窗口中，找到上传 ISO 文件的数据存储。

  11. 选择 ISO 文件，然后单击 “确定”。

  12. 在“编辑设置”窗口的“虚拟硬件”选项卡下，选择“已连接”复选框，然后单击“确定”。

运行升级命令

在为用量表运行升级命令之前，请完成以下步骤：

  1. 在 VMware vSphere® Web Client 中，登录 vCenter Server 实例。
  2. 在“主机和群集”菜单下，找到并右键单击“用量表 VM”，然后选择“编辑设置”。
  3. 在虚拟硬件选项卡的 CD/DVD 驱动器上，清除已连接复选框，然后单击确定。
  4. 在主机和群集菜单下，定位并右键单击用量表 VM，然后选择快照 > 拍摄快照。
  5. 输入快照的名称，然后单击“创建”。

使用 SSH 登录 Usage Meter Appliance VM 并完成以下步骤：

  1. 在 Windows 上打开命令提示符，或在 Linux 和 MacOS 上打开终端窗口，然后以 root 用户身份运行以下命令：

    1. mkdir /root/upgrade
    2. mount -o loop /dev/cdrom /root/upgrade
    3. bash /root/upgrade/upgrade-um.sh

    在运行 mount -o loop /dev/cdrom /root/upgrade 以升级用量计 VM 之前，可能需要运行 umount /root/upgrade 以卸载任何先前的升级。

  2. 在 IBM Cloud® for VMware Solutions 控制台中输入为用量计生成的访问令牌。 如需了解更多信息，请参阅 通过 IBM 注册用量计。

  3. 输入 y 表示同意 VCF 使用计费器设备成为 IBM 的提供商组织的一部分。

  4. 输入 y 确认快照已创建到用量表 VM。

    可能会出现有关“用量表”主机名的错误信息。 输入 y 继续升级路径。

  5. 升级过程开始，完成后输入 y 重启电表 VM。

  6. 重新启动完成后，在网络浏览器中打开 Usage Meter URL 并登录以验证升级版本。 然后，确认用量计设备的健康状况。

迁移用量表 VM 后，在升级过程中可能会遇到错误 Connection control operation failed for disk。 出现此问题的原因可能是活动快照保留了对已挂载 CD/DVD 设备的锁定。 要解决此问题，请执行以下任一操作。 不过，要成功迁移 VM，您可能需要完成所有这些工作。

  1. 删除所有现有的快照：

    1. 在 VMware vSphere Web Client 中，以管理员身份登录 vCenter Server 实例。
    2. 在主机和群集菜单下，选择用量表 VM。
    3. 在“快照”选项卡中，选择“全部删除”或指定已安装 CD/DVD 驱动器的任何快照，然后选择“删除”。
    4. 单击确定。

  2. 断开已安装驱动器的连接：

    1. 在 vSphere Web Client 中，以管理员身份登录 vCenter Server 实例。
    2. 在“主机和群集”菜单下，找到并右键单击“用量表 VM”，然后选择“编辑设置”。
    3. 清除 CD/DVD 驱动器中安装 ISO 升级文件的方框。
    4. 单击确定。

  3. 断开已安装驱动器与托管 ESXi 的连接：

    1. 在 vSphere Web Client 中，以管理员身份登录 vCenter Server 实例。
    2. 在主机和群集菜单下，选择用量表 VM。
    3. 在摘要选项卡中，找到相关对象并确定 VM 所在的主机。
    4. 以根用户或管理员身份登录 ESXi 主机。
    5. 选择虚拟机，右键单击列表中的 Usage Meter VM。
    6. 点击“编辑设置”。
    7. 在 CD/DVD 驱动器下，清除已连接复选框。
    8. 单击保存。

更换用量表证书

如果升级后无法访问 Usage Meter URL 或登录仪表板，请完成以下步骤，以更换因主机名不兼容而导致的 Usage Meter 证书：

  1. 使用 SSH 以 usagemeter 用户名登录 Usage Meter VM。

  2. 运行 stop.sh All 命令停止所有服务。

  3. 以根用户身份运行 hostnamectl hostname <new hostname> 命令，用正确的值更新主机名。

  4. 运行 export $(grep -v '^#' "/opt/vmware/cloudusagemetering/platform/conf/env.properties" | xargs) 和 mv /opt/vmware/cloudusagemetering/platform/security/keystore /opt/vmware/cloudusagemetering/platform/security/keystore.backup 命令，导出环境变量并备份现有密钥存储。

  5. 如果启用了 FIPS，请运行命令 keytool -changealias -alias "usage-meter-platform" -destalias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storetype BCFKS -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providerpath /opt/vmware/cloudusagemetering/platform/lib/bc-fips-*.jar -storepass "${TRUST_STORE_PASSWORD}"。 如果已禁用，请运行命令 keytool -changealias -alias "usage-meter-platform" -destalias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}"。

    如果在启用 FIPS 时运行 FIPS 禁用版本，则会显示错误 keytool error: java.security.KeyStoreException: Unrecognized keystore format.。 要解决这个问题，请使用指定类型加载它。

  6. 为 NGINX 变量创建一个临时目录，运行 export NGINX_FOLDER=$(mktemp -d) 命令将其移入 cloudusagemetering 目录，然后运行 cd /opt/vmware/cloudusagemetering 访问新目录。

  7. 运行 ./platform/bin/create-keystore.sh 命令创建新的密钥存储。

  8. 运行 rm -rf $NGINX_FOLDER 和 rm /opt/vmware/cloudusagemetering/platform/security/keystore.backup 命令删除临时备份文件。

  9. 如果启用了 FIPS，请运行 keytool -delete -alias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storetype BCFKS -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providerpath /opt/vmware/cloudusagemetering/platform/lib/bc-fips-*.jar -storepass "${TRUST_STORE_PASSWORD}" 命令删除备份密钥存储。 如果已禁用，请运行命令 keytool -delete -alias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}"。

  10. 运行命令 chmod 0640 /opt/vmware/cloudusagemetering/platform/security/keystore 更新新的密钥库权限，并重新启动使用情况记录仪 VM。

    由于主机名发生变化，您可能需要将 DNS 条目更新为新主机名，或者添加新主机名（如果不存在）。 如果重定向到登录页面时出现 OAuth 错误，请清除 Usage Meter 的任何现有 DNS 条目，然后重试。

  11. 重新启动完成后，在网络浏览器中打开 Usage Meter URL 验证升级版本。