使用更新软件包升级 VMware Cloud Director 设备

可以使用更新软件包将 VMware Cloud Director 设备升级到最新版本，或者向 VMware Cloud Director 设备应用修补程序。

在 VMware Cloud Director 设备部署升级期间，VMware Cloud Director 服务将停止工作，并且可能会停机一段时间。停机时间取决于升级每个 VMware Cloud Director 设备和运行 VMware Cloud Director 数据库升级脚本所需的时间。VMware Cloud Director 服务器组中的工作单元数会减少，直到停止最后一个 VMware Cloud Director 设备上的 VMware Cloud Director 服务。在 VMware Cloud Director HTTP 端点前面正确配置的负载均衡器应停止将流量路由到停止的单元。

将升级应用于每个 VMware Cloud Director 设备并完成数据库升级后，必须重新引导每个 VMware Cloud Director 设备。

前提条件

生成 VMware Cloud Director 主设备的快照。

在从 10.1 或更高版本升级或进行修补时，如果已启用主数据库服务发生故障时自动进行故障切换，请在升级期间将故障切换模式更改为 Manual。升级后，可以将故障切换模式设置为 Automatic。请参见VMware Cloud Director 设备自动故障切换。
登录到数据库高可用性集群的主 VMware Cloud Director 设备所在的 vCenter Server 实例。
导航到主 VMware Cloud Director 设备，右键单击该设备，然后单击电源 > 关闭客户机操作系统。
右键单击设备，然后单击快照 > 生成快照。输入快照的名称和可选描述，然后单击确定。
右键单击 VMware Cloud Director 设备，然后单击电源 > 启动。
确认数据库高可用性配置中的所有节点都处于正常状态。请参见查看 VMware Cloud Director 设备集群运行状况和故障切换模式。
熟悉 VMware Cloud Director 设备的备份过程。请参见备份 VMware Cloud Director 设备的嵌入式数据库。

过程

在 Web 浏览器中，登录到 VMware Cloud Director 设备实例的设备管理用户界面以识别主设备，https://appliance_ip_address:5480。
记下主设备名称。必须先升级主设备，然后再升级备用单元和应用程序单元。备份数据库时，必须使用主设备。

在集群中的所有设备上，运行以下命令，关闭 VMware Cloud Director：

/opt/vmware/vcloud-director/bin/cell-management-tool -u <admin_username> cell --shutdown

将更新软件包下载到要升级的设备。

注：必须先升级主设备。
VMware Cloud Director 作为可执行文件分发，名称格式为 VMware_Cloud_Director_v。v.v.v- nnnnnnnn_update. tar.gz，其中 v. v. v. v 表示产品版本， nnnnnnnn 表示内部版本号。例如， VMware_Cloud_Director_10.1.0.4424-14420378_update.tar.gz。
创建要在其中提取更新软件包的 local-update-packag 目录。
```
mkdir /tmp/local-update-package
```

在新创建的目录中提取更新软件包。

 tar -zxf VMware_Cloud_Director_v.v.v.v-nnnnnnnn_update.tar.gz \
				-C /tmp/local-update-package

将 local-update-package 目录设置为更新存储库。
```
vamicli	update --repo file:///tmp/local-update-package
```
检查更新以验证是否正确建立了存储库。
```
vamicli update --check
```
此时，此升级版本显示为 可用更新。
使用主设备或备用设备管理 UI 创建备份。
无法使用应用程序单元执行备份。
应用此可用升级。
```
vamicli update --install latest
```
对其余备用单元和应用程序单元重复步骤 3-7 和步骤 9。
从任何设备中，运行 VMware Cloud Director 数据库 upgrade 实用程序。
```
/opt/vmware/vcloud-director/bin/upgrade
```
重新引导每个 VMware Cloud Director 设备。
```
shutdown -r now
```

下一步做什么

确认升级成功完成。
- 登录到 VMware Cloud Director Service Provider Admin Portal。
- 登录到 VMware Cloud Director 设备管理 UI，并确认所有设备均显示 Healthy 状态。
确认日志在升级期间未显示任何证书转换错误。如果日志中存在证书转换错误，则无法备份 VMware Cloud Director 设备。如果出现任何错误，请勿再次尝试升级，根据错误，先手动修复该问题，然后再次运行转换命令。
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates --convert
```
根据错误，可以采用不同的解决方法，例如：
- 如果在证书转换过程中，/opt/vmware/var/log/vami/updatecli.log 中出现以下异常，请参见知识库文章 88372。
```
 <JAVA_HOME>/lib/ext exists, extensions mechanism no longer supported; Use -classpath instead.
             .Error: Could not create the Java Virtual Machine.
              Error: A fatal exception has occurred. Program will exit. 
```
- 如果 /opt/vmware/var/log/vami/updatecli.log 的证书转换过程中存在与错误密钥相关的错误，或者如果未说明任何失败原因，则可能的解决办法包括：
  - 如果 .pem 和 .key 文件没有准备就绪，请确认密钥库文件是否存在。可以在 global.properties 文件中找到密钥库文件的位置。
  - 如果 VMware Cloud Director 查找密钥库文件，请使用 keytool 实用程序或 OpenSSL 工具从密钥库中提取 .pem 和 .key 文件。
  - 如果 VMware Cloud Director 找不到密钥库文件，请完全重新配置证书。要了解有关创建证书的更多信息，请参见创建和管理 VMware Cloud Director 设备的 SSL 证书。
  - 如果存在与通配符证书相关的现有 .pem 和 .key 文件，要使用通配符证书替换节点上的现有证书，请使用单元管理工具证书命令。
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates -j --cert /opt/vmware/vcloud-director/data/transfer/user.http.pem --key /opt/vmware/vcloud-director/data/transfer/user.http.key --key-password key_password
/opt/vmware/vcloud-director/bin/cell-management-tool certificates -p --cert /opt/vmware/vcloud-director/data/transfer/user.consoleproxy.pem --key /opt/vmware/vcloud-director/data/transfer/user.consoleproxy.key --key-password key_password
```
如果升级成功，则可以删除 VMware Cloud Director 设备的快照。
如果升级不成功，可以将 VMware Cloud Director 设备回滚到升级前生成的快照。请参见升级失败后回滚 VMware Cloud Director 设备。