MongoDB Manual Upgrade

This document describes the steps to manually upgrade the MongoDB.

Pull or load the required MongoDB container images.

For Online installations	For air-gaped installations
docker pull 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-4.4.20 docker pull 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-5.0.16 docker pull 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-6.0.5	docker load -i ad-db_4.4.20.tgz docker load -i ad-db_5.0.16.tgz docker load -i ad-db_6.0.5.tgz

Upgrade to Version 4.4

Retag the version 4.4.20 to 3.2.0 by executing the following command.

Bash
    
docker tag 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-4.4.20 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:3.2.0
Copy

Restart the ad-db service by executing the following command.

Bash
    
 
accelo restart ad-db -d
Copy

Exec into the ad-db container by executing the following command.

Bash
    
 
docker exec -it ad-db_default bash
Copy

Exec into the mongo shell by executing the following command.

Bash
    
 
mongo mongodb://accel:ACCELUSER_01082018@localhost:27017
Copy

Set the compatibility version to 4.4.

Bash
    
 
db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )
Copy

The expected output for the above command is as follows.

{ "ok" : 1 }

Exit the mongo shell by executing the following command.

Bash
    
 
quit
Copy

Exit the ad-dbcontainer by executing the following command.

Bash
    
 
exit
Copy

Upgrade to Version 5.0

Retag the version 5.0.16 to 3.2.0 by executing the following command.

Bash
    
docker tag 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-5.0.16 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:3.2.0
Copy

Restart the ad-db service by executing the following command.

Bash
    
 
accelo restart ad-db -d
Copy

Exec into the ad-db container by executing the following command.

Bash
    
 
docker exec -it ad-db_default bash
Copy

Exec into the mongo shell by executing the following command.

Bash
    
 
mongo mongodb://accel:ACCELUSER_01082018@localhost:27017
Copy

Set the compatibility version to 5.0 by executing the following command.

Bash
    
 
db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )
Copy

The expected output for the above command is as follows.

{ "ok" : 1 }

Exit out of the mongo shell by executing the following command.

Bash
    
 
quit
Copy

Exit the ad-db container by executing the following command.

Bash
    
 
exit
Copy

Upgrade to Version 6.0.5

Retag the version 6.0.5 to 3.2.0 by executing the following command.

Bash
    
docker tag 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-6.0.5 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:3.2.0
Copy

Restart the ad-db service by executing the following command.

Bash
    
 
accelo restart ad-db -d
Copy

Exec into the ad-db container by executing the following command.

Bash
    
 
docker exec -it ad-db_default bash
Copy

Exec into the mongo shell by executing the following command.

Bash
    
 
mongosh mongodb://accel:ACCELUSER_01082018@localhost:27017
Copy

Since compatibility was already 5.0, upgrade goes as expected and you need not take any other action.

Validate the MongoDB Migration

If the Pulse Web UI loads without any issues, the DB migration is successful. Clear the browser cache and check few dashboard pages to validate.

Last updated on

Was this page helpful?