使用更新套件升級 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 應用裝置的內嵌式資料庫。

程序

在網頁瀏覽器中，登入 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-package 目錄。
```
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
```
升級發行版本顯示為 可用更新。
使用主要應用裝置或待命應用裝置管理使用者介面建立備份。
無法使用應用程式儲存格執行備份。
套用可用的升級。
```
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 應用裝置管理使用者介面，並確認所有應用裝置均顯示 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 應用裝置。