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

Prerequisites

  • Back up or take a snapshot of the source vCloud Usage Meter appliance that you want to upgrade.
  • Enable SSH on the source vCloud Usage Meter appliance.
  • You must have a password to log in to the vCloud Usage Meter console as root.

Procedure

  1. Locally on you computer, download the upgrade files.
    File Name Description
    Usage_Meter_Agent-4.4.0.0-<BUILD_NUMBER>_Upgrade.iso The ISO upgrade file containing the upgrade script and the YUM repository.
    Usage_Meter_Agent-4.4.0.0-<BUILD_NUMBER>_Upgrade.mf Contains the sha1checksum of the upgrade ISO file.
    Usage_Meter_Agent-4.4.0.0-<BUILD_NUMBER>_Upgrade.crt Contains the public certificate that signs the ISO file.
    Usage_Meter_Agent-4.4.0.0-<BUILD_NUMBER>_Upgrade.sign Contains the signature for the ISO file.
  2. Verify that the checksum of the download matches the checksum posted on the download page.
    sha1sum -c Usage_Meter_Agent-4.4.0.0-<BUILD_NUMBER>_Upgrade.mf
  3. Verify the certificate.
    openssl x509 -in Usage_Meter_Agent-4.4.0.0-<BUILD_NUMBER>_Upgrade.crt -text
    openssl verify Usage_Meter_Agent-4.4.0.0-<UM_NEW_BUILD>_Upgrade.crt
  4. Obtain the certificate public key and verify the signature of the ISO file.
    openssl x509 -pubkey -in Usage_Meter_Agent-4.4.0.0-<BUILD_NUMBER>_Upgrade.crt \
      > Usage_Meter_Agent-4.4.0.0-<BUILD_NUMBER>_Upgrade.key
    openssl dgst -sha1 -verify Usage_Meter_Agent-4.4.0.0-<BUILD_NUMBER>_Upgrade.key \
      -signature Usage_Meter_Agent-4.4.0.0-<BUILD_NUMBER>_Upgrade.sign \
      Usage_Meter_Agent-4.4.0.0-<BUILD_NUMBER>_Upgrade.mf
  5. Connect the CD-ROM drive of vCloud Usage Meter to the Usage_Meter_Agent-4.4.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.
  6. Log in to the source vCloud Usage Meter console as root.
  7. Create an upgrade directory.
    mkdir /root/upgrade
  8. Mount the CD drive.
    mount -o loop /dev/cdrom /root/upgrade
  9. To start the in-place upgrade, run the command.
    bash /root/upgrade/upgrade-um.sh
  10. 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.

  11. 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/logs/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.
  12. Stop SSH by running the command:
    service sshd stop

What to do next

Important: 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.