In-Place Upgrade of vCloud Usage Meter

You can install vCloud Usage Meter 4.7 as an in-place upgrade on top of vCloud Usage Meter 4.3 and later.

Prerequisites


Prerequisite	Description
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, activate and start SSH on the source vCloud Usage Meter appliance by running the following commands. systemctl enable sshd systemctl start sshd
Authentication	Verify that you can access the vCloud Usage Meter console as root.

Procedure

Locally on your computer, download the following upgrade files from the Broadcom Support Portal download product page.

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

From the terminal of your computer, log in to the vCloud Usage Meter appliance and run the following commands.

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

Verify the certificate.

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

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

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

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

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

Connect the CD-ROM drive of vCloud Usage Meter to the Usage_Meter_Agent-4.7.0.1-<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.
Note: If you upload the .iso file inside the vCloud Usage Meter appliance manually, enter the full .iso path location in the command.
```
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 are prompted to reboot the appliance.

Reboot is recommended after an upgrade. Reboot now? (y/n)
If you enter y (yes), a reboot of the appliance starts. If you enter n (no), you must manually reboot the appliance by running the following command.
```
sudo reboot
```
The system generates a newly created cloudusagemetering folder under /opt/vmware pointing to the upgraded vCloud Usage Meter installation.

(Optional) If vCloud Usage Meter detects an incorrectly set hostname, you receive the following message.

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.

If you ignore the message, you might encounter the

Failed to process journal=>read

error in the vCloud Usage Meter Web interface. Follow the instructions provided in the message. For more information, see vCloud Usage Meter Certificate Management.

Verify that the vCloud Usage Meter services are up and running.
1. Verify the status of the vCloud Usage Meter services.
```
bash status.sh
```
  If the services are running, you receive a Running status. In case you receive a Running status that has errors, check the latest log files. The errors might not be related to the in-place upgrade.

What to do next

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.