Upgrading OmniDeq Appliance to version 1.5

Assumptions

1.. On the OmniDeq Appliance machine, navigate to the directory where the version 1.4.6 is installed

# cd <OmniDeq-home>

2.. Stop the OmniDeq Appliance 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 OmniDeq-home to a backup directory

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

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

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

6.. Extract from containers.tar.gz

# tar xvzf containers.tar.gz

7.. Load the new OmniDeq 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 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.6_to_1.5.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.6_to_1.5.js

11.. Start OmniDeq Appliance

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

12.. Open browser and access the OmniDeq Appliance. Login with the existing credentials and confirm you are able to login.

13.. Check the version of OmniDeq Appliance by clicking on Help/Current Version. Make sure that the version displayed is the version you installed.

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