Upgrade OneFuse

Upgrade the OneFuse appliance using CLI or Yum

  3 minute read  

Before you begin

  1. Read the Release notes.
  2. Back up your OneFuse instance by cloning the VM or taking a snapshot.

Upgrade OneFuse

There are two methods to upgrade OneFuse:

  1. Option 1: Command Line
  2. Option 2: Yum Repository

Option 1: Upgrade via the command line

OneFuse upgraders are distributed as .tgz archives.

  1. Download the Upgrader .tgz

    Access CloudBolt’s Download Article for CMP/OneFuse 2023.5.

    1. Log in with your CloudBolt Connect account.
    2. Download CloudBolt Upgrader.

  2. SSH to the target OneFuse appliance

    • ssh as root user, switch the root user with “sudo su -” and then run required commands.

  3. Move the downloaded Upgrader .tgz file into the /var/tmp directory

    #Replace cloudbolt_upgrader_#.#.#_{uniqueID} with the name of the upgrader .tgz file

mv /path/to/cloudbolt_upgrader_#.#.#_{uniqueID}.tgz /var/tmp/

  4. Navigate to the /var/tmp directory:

    cd /var/tmp

  5. Open (untar) the Upgrader .tgz file:

    #Replace cloudbolt_upgrader_#.#.#_{uniqueID} with the name of the upgrader .tgz file

tar xzf cloudbolt_upgrader_#.#.#_{uniqueID}.tgz

  6. Navigate to the uncompressed directory that was from the Upgrader .tgz file:

    #Replace cloudbolt_upgrader_#.#.#_{uniqueID} with the name of the upgrader folder

cd cloudbolt_upgrader_#.#.#_{uniqueID}

  7. If the OneFuse database is on another server:

    1. Edit the install_config file to specify the mysql_host.
    2. Save the file

  8. Run the upgrade command:

    ./upgrade_cloudbolt.sh

  9. OneFuse will upgrade to the new version.

Option 2: Upgrade via Yum repository

To help make upgrades more reliable, we have removed operating-system packages (RPMs) from the Installer and Upgrader.

The Upgrader will now update all system requirements to the latest versions available.

OneFuse with public internet access

Users who would like to upgrade OneFuse should first verify that their appliances have a Yum repository available before running the upgrader:

  1. SSH into the OneFuse Appliance

  2. Run the following command:

    yum check-update

If your appliances are hosted in firewalled environments, you may need to add proxy settings to those appliances’ yum config:

  1. In the yum config file /etc/yum.conf, define the proxy settings to the following:

    #Replace <Proxy-Server-IP-Address>, <Proxy_Port>, <Proxy-Username>, and <Proxy-Password>

[main]
………………
proxy=http://<Proxy-Server-IP-Address>:<Proxy_Port>
proxy_username=<Proxy-Username>
proxy_password=<Proxy-Password>
………………

  2. Save and exit the file.

  3. Start using the yum command.

    • Run a command like the following to check if you are able to fetch the packages:

      #[root@yourfolder ~]
yum repolist

OneFuse without public internet access

Users who are not able to access a public Yum repository have two options for upgrading their appliances:

  1. Host an internal Yum repository mirror.
  2. Upgrade by installing a new CloudBolt Appliance OVA. Refer to Install from OVA.

Verify the upgrade

In the OneFuse UI:

  • The version number will appear on the initial OneFuse Log In page
  • Once logged in, select the Resources (help icon) to also view the currently installed version

Upgrade OneFuse supported upstream providers