Upgrading appliance to 1.4.3

Appliance versions 1.4.1 and 1.4.2 can be upgraded to 1.4.3

Assumptions

Version 1.4.1 or 1.4.2 of appliance is installed and running
sudo access to the appliance machine
Latest release singlefile.tar.gz is downloaded
Adequate space is available ( at least 50 GB ) on the partition where docker copies its files ( typically /var/lib/docker/ )

1.. On the appliance machine, navigate to the directory where CloudHedge is installed

# cd <CloudHedge-home>

2.. Stop the CloudHedge Enterprise using the following command:

# docker-compose -f compose.yaml down

3.. Take a backup of the Mongo Database

# mkdir mongo-backup
# cd mongo-backup
# mongodump --uri='mongodb://<db-username>:<db-password>@<host-ip>:27017/ch-db' --out .

This will create a directory ch-db which will contain the Mongo backup

4.. Move the files in CloudHedge-home to a backup directory

# cd <CloudHedge-home>
# mkdir app-backup
# mv * ./app-backup

5.. Move the downloaded singlefile.tar.gz to CloudHedge-home and extract it

# mv singlefile.tar.gz <CloudHedge-home>
# cd <CloudHedge-home>
# tar xvzf singlefile.tar.gz

6.. Extract from containers.tar.gz

# tar xvzf containers.tar.gz

7.. Load the new CloudHedge container images

# docker load -i containers.tar

This will take some time depending on system and disk speed

8.. Rename rhel-compose.yaml and rhel-cloudhedgeenv files

# mv rhel-compose.yaml compose.yaml
# mv rhel-cloudhedgeenv cloudhedgeenv

9.. Update cloudhedgeenv with the ip addresses and Mongo details as it was in the previous cloudhedgeenv file

10.. Update compose.yaml with the same tag for license-service as it was in the previous compose.yaml file

11.. Update the Mongo database with new collections. Download this file and use it as follows if TLS is not enabled on Mongo:

mongo --host <private-ip-address> --username <your-db-user> --password <your-db-password> --authenticationDatabase "ch-db" < upgrade_1.4.2_to_1.4.3.js

If TLS is enabled, run the following command:

mongo --host <private-ip-address> --username <your-db-user> --password <your-db-password> --tls --tlsAllowInvalidCertificates --authenticationDatabase "ch-db" < upgrade_1.4.2_to_1.4.3.js

12.. Start the CloudHedge Enterprise

# cd <CloudHedge-home>
# docker-compose -f compose.yaml up -d

13.. Open browser and access the appliance. Login with the existing credentials and confirm you are able to login.

14.. Check the version of CloudHedge Enterprise by clicking on Help/Current Version. Make sure that the version displayed is the version you installed

15.. After CloudHedge Enterprise is upgraded, for all the nodes that have been discovered in the earlier version of CloudHedge Enterprise, run "Check prerequisites". This will ensure that the nodes have the latest CloudHedge Enterprise tools on them that will enable all operations to be performed.