就地升級 vCloud Usage Meter

您可以將 vCloud Usage Meter 4.7 以就地升級方式安裝在 vCloud Usage Meter 4.3 及更新版本之上。

必要條件


必要條件	說明
來源 vCloud Usage Meter 應用裝置	備份您要升級之來源 vCloud Usage Meter 應用裝置，或建立其快照。以 root 身分執行以下命令，在來源 vCloud Usage Meter 應用裝置上啟用並啟動 SSH。 systemctl enable sshd systemctl start sshd
驗證	確認您能夠以 root 身分存取 vCloud Usage Meter 主控台。

程序

在電腦上，從 VMware Customer Connect 下載產品頁面本機下載下列升級檔案。

檔案名稱	說明
Usage_Meter_Agent-4.7.0.0-<BUILD_NUMBER>_Upgrade.iso	包含升級指令碼和 YUM 存放庫的 ISO 升級檔案。
(可選) Usage_Meter_Agent-4.7.0.0-<BUILD_NUMBER>_Upgrade.mf	包含升級 ISO 檔案的 sha1checksum。
(可選) Usage_Meter_Agent-4.7.0.0-<BUILD_NUMBER>_Upgrade.crt	包含簽署 ISO 檔案的公開憑證。
(可選) Usage_Meter_Agent-4.7.0.0-<BUILD_NUMBER>_Upgrade.sign	包含 ISO 檔案的簽章。

從電腦的終端機登入 vCloud Usage Meter 應用裝置，然後執行以下命令。

驗證下載的總和檢查碼是否符合下載頁面上公佈的總和檢查碼。
```
sha1sum -c Usage_Meter_Agent-4.7.0.0-<BUILD_NUMBER>_Upgrade.mf
```

驗證憑證。

openssl x509 -in Usage_Meter_Agent-4.7.0.0-<BUILD_NUMBER>_Upgrade.crt -text

openssl verify Usage_Meter_Agent-4.7.0.0-<UM_NEW_BUILD>_Upgrade.crt

取得憑證公開金鑰並驗證 ISO 檔案的簽章。

openssl x509 -pubkey -in Usage_Meter_Agent-4.7.0.0-<BUILD_NUMBER>_Upgrade.crt \
  > Usage_Meter_Agent-4.7.0.0-<BUILD_NUMBER>_Upgrade.key

openssl dgst -sha1 -verify Usage_Meter_Agent-4.7.0.0-<BUILD_NUMBER>_Upgrade.key \
  -signature Usage_Meter_Agent-4.7.0.0-<BUILD_NUMBER>_Upgrade.sign \
  Usage_Meter_Agent-4.7.0.0-<BUILD_NUMBER>_Upgrade.mf

將 vCloud Usage Meter 的 CD-ROM 光碟機連線至 Usage_Meter_Agent-4.7.0.0-<BUILD>_Upgrade.iso 檔案。

如需相關資訊，請參閱《vSphere 虛擬機器管理》說明文件中的〈新增或修改虛擬機器 CD 或 DVD 光碟機〉。
以 root 身分登入來源 vCloud Usage Meter 主控台。
建立升級目錄。
```
mkdir /root/upgrade
```
掛接 CD 光碟機。
備註：如果手動將 .iso 檔案上傳到 vCloud Usage Meter 應用裝置中，請在命令中輸入完整的 .iso 路徑位置。
```
mount -o loop /dev/cdrom /root/upgrade
```
若要開始就地升級，請執行命令。
```
bash /root/upgrade/upgrade-um.sh
```
系統會提示您確認要升級的來源 vCloud Usage Meter 應用裝置的快照是否存在。

是否已在執行 vCloud Usage Meter 應用裝置虛擬機器的 vCenter Server 環境中建立該虛擬機器的快照? (y/n):
若要完成就地升級，系統會提示將應用裝置重新開機。

建議在升級後重新開機。是否立即重新開機? (y/n)
如果輸入 y (是)，將開始重新開機應用裝置。如果輸入 n (否)，則必須執行以下命令手動將應用裝置重新開機。
```
sudo reboot
```
系統會在 /opt/vmware 下產生新建立的 cloudusagemetering 資料夾，指向升級後的 vCloud Usage Meter 安裝。

(選擇性) 如果 vCloud Usage Meter 偵測到錯誤設定的主機名稱，會顯示以下訊息。

Detected wrong hostname. Expected hostname: ${host}, but found: ${current_hostname}.This will most probably result in issues after upgrade with the existing vCloud Usage Meter certificates.
Please change the hostname and then you can either generate a new self-signed
certificate or import an internal Certification Authority (CA) - Signed Certificate. 
Note: The certificate CN must match the hostname of the vCloud Usage Meter appliance.
For information, see vCloud Usage Meter Certificate Management.

如果忽略此訊息，vCloud Usage Meter Web 介面中可能會顯示

Failed to process journal=>read

錯誤。按照訊息中提供的指示進行操作。如需詳細資訊，請參閱 vCloud Usage Meter 憑證管理。

確認 vCloud Usage Meter 服務已啟動且正在執行。
1. 確認 vCloud Usage Meter 服務的狀態。
```
bash status.sh
```
  如果服務正在執行，您會收到執行中狀態。如果收到執行中狀態，但有錯誤，請查看最新的記錄檔。錯誤可能與就地升級無關。
  
  如果驗證失敗並顯示離線狀態且有錯誤，請查看 /opt/vmware/var/logs/um-upgrade.log 中的就地升級記錄檔。

下一步

備註：

為確保自動彙總和報告每月產品耗用資料，成功升級後，請不要還原為來源 vCloud Usage Meter 應用裝置的快照。