Upgrading CloudBolt

CloudBolt upgraders are distributed as .tgz archives. They can be downloaded either from CloudBolt’s UI (Admin > Version & Upgrade Info) or from the pertinent post in the support portal at https://support.cloudbolt.io/hc/en-us. The upgrader is designed to keep customizations you have made safe and not lose information, but be sure to review the release notes for any changes you may need to be aware of.

  1. Read the release notes.
  2. Best practice (but not required): set up the Continuous Infrastructure Testing (CIT) feature to have automated tests.
  3. Back up your CloudBolt instance by duplicating the VM or taking a snapshot.
  4. Decide whether to run the upgrade from the UI or from the command line.
  5. If you have a multi-server CloudBolt (ex. the DB is on a different VM, it is an HA setup), then you will need to run the upgrader from the command line.
  6. Navigate in the CloudBolt UI to Admin > Version & Upgrade Info.

Upgrading from the Web Interface

If there is a problem with the upgrade, ssh to the CloudBolt server and become root to inspect logs, and correct the problem. If you cannot do this, find someone who can before beginning the upgrade.

  1. Click the download and upgrade button.
  2. Right click on the job link to open it in a new tab.
  3. Watch the job to ensure the download succeeds and the upgrade is initiated. The progress of the upgrade will not be visible on this page after CloudBolt enters maintenance mode.
  4. Switch back to the Version & Upgrade Info page to track the upgrade progress after CB enters maintenance mode.

Upgrading from the Command Line

  1. Click the download button.
  2. ssh as root to the CloudBolt server and run cd/var/tmp
  3. Untar the file by running the command tarxzfname_of_cloudbolt_file.tgz (for example: tarxzfcloudbolt_upgrader_3.0-src-f893cd2.tgz)
  4. Go into the directory by running cdcloudbolt_upgrader*
  5. If the database that this CloudBolt instance is connecting to is on a different server, edit the install_config file to specify the mysql_host
  6. Run the command ./upgrade_cloudbolt.sh
  7. CloudBolt will upgrade to the new version.

Verifying the Upgrade

  1. Click on the CloudBolt logo at the bottom of any page, and verify the version is as expected.
  2. Run common operations that users depend on from your CloudBolt to ensure they function properly.
  3. Alternately, you can use CloudBolt’s Continuous Infrastructure Testing feature to test common orders and actions in an automated fashion.