Turbonomic openSUSE to CentOS Appliance Migration

You may have heard the news, the Turbonomic appliance platform has changed from openSUSE to CentOS. If you want to upgrade your appliance to version 6.0, then you must migrate to the new CentOS platform. You can stay on your openSUSE appliance, but you will hit the version ceiling of 5.9.1.

This post covers the process of migrating from the Turbonomic openSUSE appliance (version 5.9.1) to the Turbonomic CentOS appliance (version 5.9.0, upgraded to version 5.9.1). I also cover the final step of upgrading to Turbonomic 6.0 to get your hands on all of the great new features. Assuming you have a working knowledge of Linux administration, this will take approximately 60 minutes to complete.

Prerequisites

Step 1 – Perform a Full Backup of your existing Turbonomic openSUSE Appliance

  1. SSH to the openSUSE Turbonomic instance and login as root.
  2. Check that the Turbonomic software version is 5.9.1, if it is not, upgrade to 5.9.1 before proceeding with step 3. This is required to make sure that the full backup will be successfully restored to the CentOS platform running 5.9.1.
  3. Execute the command “/srv/tomcat6/script/appliance/vmtbackup.sh -o full”. This will result in the “vmtbackup.zip” to be created in the “/tmp” directory.
  4. WinSCP into the openSUSE Turbonomic instance with the root credentials and copy “/tmp/vmtbackup.zip” to your desktop or JumpBox server. This is necessary because the openSUSE instance will be shutdown to make way for the new CentOS appliance.
  5. Also record the Turbonomic appliance version (verify it is 5.9.1), Hostname (“hostname” command), IP address (including netmask and gateway, “ifconfig -a” command), NTP servers (“/etc/chrony.conf” file), timezone (“date” command), DNS servers (“/etc/resolv.conf“ file) and Domain Name (“/etc/sysctl.conf” file).
  6. Also login to the Turbonomic UI (https://<appliance IP address>) and record the SMTP server, Targets, HTTP Proxy, etc.
  7. Shutdown the openSUSE Turbonomic appliance.
  8. Do not delete this appliance, it is required in case of rollback.

Step 2 – Deploy the new Turbonomic CentOS appliance (5.9.0) to your Management Cluster

  1. Take the Turbonomic CentOS OVA file downloaded and deploy the Turbonomic appliance to your management cluster (vSphere assumed).
  2. Access the console of the CentOS Turbonomic appliance and login as root/vmturbo.
  3. Execute the command “ipsetup” and follow the instructions.
  4. Also configure the hostname, NTP servers and timezone.

Step 3- Upgrade your Turbonomic CentOS appliance to 5.9.1

  1. Open a flash-enabled web browser to the Turbonomic update page: https://<appliance IP address>/update.html
  2. Login with the administrator/vmturbo credentials.
  3. Select “Apply offline update”.
  4. Select the CentOS 5.9.1 upgrade binary and press “Upload”.
  5. Once the upgrade is completed, login as administrator and verify the running version is 5.9.1.

Step 4 – Restore the Full Backup to your Turbonomic CentOS appliance

  1. SSH to the CentOS Turbonomic instance and login as root/vmturbo.
  2. WinSCP into the CentOS Turbonomic instance with the root credentials and copy “vmtbackup.zip” from your desktop or JumpBox server to the “/tmp” directory of the Turbonomic appliance.
  3. Execute the command “/srv/tomcat6/script/appliance/vmtrestore.sh -o full”. This will result in the “vmtbackup.zip” configuration to be restored to the Turbonomic appliance.
  4. Verify that the root password has been restored to the unique password from openSUSE.
  5. Login to the Turbonomic UI (https://<appliance IP address>) as administrator with your unique password from openSUSE.
  6. Upload the Turbonomic license XML file.
  7. Verify that the SMTP server, Targets, HTTP Proxy, etc. have been restored successfully.

Step 5 – Upgrade your Turbonomic CentOS appliance to 6.0

  1. Open a flash-enabled web browser to the Turbonomic update page: https://<appliance IP address>/update.html
  2. Login with the administrator credentials.
  3. Select “Apply offline update”.
  4. Select the CentOS 6.0 upgrade binary and press “Upload”.
  5. Once the upgrade is completed, login as administrator and verify the running version is 6.0.

Step 6 – Start using the new HTML5 UI

  1. The flash-enabled UI (https://<appliance IP address>) is still available to aid users whilst they transition to the new HTML5 UI.
  2. Start using the HTML5 UI (https://<appliance IP address>). You can switch back to the Classic UI by pressing the button in the lower Right-Hand corner.
  3. After a suitable period of time, delete the old openSUSE Turbonomic appliance.

Published by

vcdx133

Chief Enterprise Architect and Strategist, 4xVCDX#133, NPX#8, DECM-EA.