Task:
Upgrade OneFuse appliance in-place with tgz upgrade option.
Prerequisite step:
1. Get the URL of the latest download from the cloudbolt.io site:
support.cloudbolt.io/cloudbolt/s/topic/0TO5c000001MolrGAC/releases
e.g. v2025.1.246.tgz --> right click --> copy URL to clipboard and save for step 2 below.
2. Review the documentation:
docs.cloudbolt.io/articles/#!onefuse-latest-v2025-1/upgrade-onefuse
Steps:
1. Perform Snapshot (cold preferred)
--> vSphere client --> Datacenter --> VM
--> right click --> Power --> Shut Down Guest OS
--> right click --> Snapshots --> Manage Snapshots --> Take Snapshot
--> right click --> Power --> Power On
2. Download and uncompress the installation/upgrade file:
$ ssh myadmin@onefuse.mindwatering.net
<login>
$ sudo su
# cd /var/tmp/
# wget downloads.cloudbolt.io/2025.1.246/cloudbolt_upgrader_v2025.1.246.tgz
<wait>
# ls
<confirm tgz file exists>
# tar xzf cloudbolt_upgrader_v2025.1.246.tgz
# ls
<confirm new extracted folder exists>
# rm cloudbolt_upgrader*.tgz
<confirm deletion of tgz archive>
3. Prep for installation:
a. Backup the external users file:
# cp /opt/cloudbolt/cbhooks/hookmodules/external_users_sync.py /var/tmp/
b. Change to upgrade extracted folder:
# cd cloudbolt_upgrader_v2025.1.246/
c. If the PostgreSQL or MySQL server is external, update the database and specify the FQDN of the database server:
- The mysql line to update: mysql_host="localhost"
- The PostgreSQL line to update: postgresql_host="localhost"
# vi install_config
d. Update the path for python:
# export PATH=/usr/local/bin:${PATH}
e. Confirm space:
# df -h
<confirm gigs available for / path>
f. Remove old db backups (if applicable):
# cd /opt/cb_archive/
# ls -l
<view results>
# rm -rf v2024.*/
# rm -rf v2025.*/
4. Perform upgrade tasks:
a. Run the upgrader:
# ./upgrade_cloudbolt.sh
b. Backup the new external users file:
# cp /opt/cloudbolt/cbhooks/hookmodules/external_users_sync.py /var/tmp/external_users_sync_v2025-1-246_version.py
c. Restore the current/previous external users file:
# cp /var/tmp/exernal_users_sync.py /opt/cloudbolt/obhooks/hookmodules/
<y to confirm overwrite>
d. Logout:
# exit
$ exit
5. Provision a vRA deployment (VM), and confirm the OneFuse tasks are completed successfully.
6. After successful test, remove the snapshot
--> vSphere client --> Datacenter --> VM
--> right click --> Snapshots --> Manage Snapshots --> Highlight snapshot --> Delete --> Confirm
previous page
|