In-Place upgrade of vCloud Usage Meter

You install vCloud Usage Meter 4.5 as an in-place upgrade on top of vCloud Usage Meter 4.x.

Prerequisites


Prerequisite	Description
Proxy	If you are upgrading in an isolated network behind a proxy, you must configure the proxy server on the OS level. Log in to the Photon OS virtual machine as root. Open the /etc/sysconfig/proxy file for editing by using a text editor such as vi. vi /etc/sysconfig/proxy Update the /etc/sysconfig/proxy with the following. PROXY_ENABLED="yes" HTTP_PROXY="`Proxy-server-name`:`port-number`" HTTPS_PROXY="`Proxy-server-name`:`port-number`" Save the /etc/sysconfig/proxy file. :wq!
Source vCloud Usage Meter appliance	Back up or take a snapshot of the source vCloud Usage Meter appliance that you want to upgrade. As root, enable and start SSH on the source vCloud Usage Meter appliance by running the commands. systemctl enable sshd systemctl start sshd
Authentication	You must have a password to log in to the vCloud Usage Meter console as root.

Procedure

Locally on your computer, download the upgrade files.

File Name	Description
Usage_Meter_Agent-4.5.0.0-<BUILD_NUMBER>_Upgrade.iso	The ISO upgrade file containing the upgrade script and the YUM repository.
Usage_Meter_Agent-4.5.0.0-<BUILD_NUMBER>_Upgrade.mf	Contains the sha1checksum of the upgrade ISO file.
Usage_Meter_Agent-4.5.0.0-<BUILD_NUMBER>_Upgrade.crt	Contains the public certificate that signs the ISO file.
Usage_Meter_Agent-4.5.0.0-<BUILD_NUMBER>_Upgrade.sign	Contains the signature for the ISO file.

(Optional) Verify that the checksum of the download matches the checksum posted on the download page.
```
sha1sum -c Usage_Meter_Agent-4.5.0.0-<BUILD_NUMBER>_Upgrade.mf
```

(Optional) Verify the certificate.

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

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

(Optional) Obtain the certificate public key and verify the signature of the ISO file.

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

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

Connect the CD-ROM drive of vCloud Usage Meter to the Usage_Meter_Agent-4.5.0.0-<BUILD>_Upgrade.iso file.
For information, see Add or Modify a Virtual Machine CD or DVD Drive in the vSphere Virtual Machine Administration documentation.
Log in to the source vCloud Usage Meter console as root.
Create an upgrade directory.
```
mkdir /root/upgrade
```
Mount the CD drive.
```
mount -o loop /dev/cdrom /root/upgrade
```
To start the in-place upgrade, run the command.
```
bash /root/upgrade/upgrade-um.sh
```
You are prompted to confirm if a snapshot of the source vCloud Usage Meter appliance that you want to upgrade exists.

Has a snapshot of the vCloud Usage Meter appliance VM been created on the vCenter Server environment that it's running on? (y/n):
To complete the in-place upgrade, you must reboot the appliance.

After rebooting the appliance, the system generates a newly created cloudusagemetering folder pointing to the upgraded vCloud Usage Meter installation.
Verify that the vCloud Usage Meter services are up and running.
1. Enter the /opt/vmware/cloudusagemetering directory.
```
cd /opt/vmware/cloudusagemetering
```
2. Verify the status of the vCloud Usage Meter services.
```
bash scripts/status.sh
```
  If the services are running, you receive a Running status back.
  Important: You can access the in-place upgrade log files at /opt/vmware/var/log/um-upgrade.log. If the verification fails with an Offline error message, restore the vCloud Usage Meter appliance from the latest backup or snapshot, and repeat the steps.

Stop SSH by running the commands.

systemctl stop sshd

systemctl disable sshd

What to do next

Verify the certificates for all metered product servers are FIPS compliant.
If you are upgrading from vCloud Usage Meter 4.1.x, in the vCloud Usage Meter Web interface, you must manually accept the certificates for all metered product servers.

Note: To ensure the automatic aggregation and reporting of the monthly product consumption data, after a successful upgrade, do not revert to the snapshot of the source vCloud Usage Meter appliance.