Migrate MongoDB from Version 6.0.X to 8.0.X

To upgrade MongoDB in the ad-db container to version 7.0 and then to 8.0, you must first be running MongoDB version 6.0. MongoDB supports only successive version upgrades.

Upgrade MongoDB using Accelo Binary

1. Download and load all required container images if you are working in an air-gapped network environment.

191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-7.0.19
191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-8.0.8

1. Run the following command to upgrade MongoDB to version 8.0.8.

accelo admin database migrate
Expected output:

[root@odppulse201:acceldata (ad-default)]$ accelo admin database migrate
INFO: Running database migrate command
Is the 'Database Service' up and running? [y/n]: : y
version from DB: 6.0
Now, trying to logon to the AccelData registry...
Docker login succeeded ✓
version from docker metadata: 6.0.19
INFO: Upgrading to 7.0.19
INFO: Tagging 7.0.19 image to pulse version
INFO: Removing old ad-db container
INFO: Creating new ad-db container
INFO: Connecting to new DB container
INFO: Setting compatibility version 7.0
INFO: Upgrading to 8.0.8
INFO: Tagging 8.0.8 image to pulse version
INFO: Remving old ad-db container
INFO: Creating new ad-db container
INFO: Upgrading mongo version to latest
To verify the MongoDB version, exec into the ad-db container and run the following command:

mongod --version
This command returns the currently installed MongoDB version.

Upgrade MongoDB Manually

If you are working in an air-gapped network, download and manually load all required container images.

191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-7.0.19
191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-8.0.8

Upgrade MongoDB from Version 6.0.x to 7.0.x

1. Retag the version 7.0.19 to pulse_version.

docker tag 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-7.0.19 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:<pulse_version>

1. Restart the ad-db service.

accelo restart ad-db -d

1. Exec into the ad-db container.

docker exec -it ad-db_default bash

1. Exec into the mongo shell.

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

1. Set the compatibility version to 7.0.

db.adminCommand( { setFeatureCompatibilityVersion: "7.0", confirm: true } )
Expected Output:

{ "ok" : 1 }

1. Exit out of the MongoDB shell.

quit

1. Exit out of the ad-db container.

exit

Upgrade MongoDB from Version 7.0.x to 8.0.x

1. Retag the version 8.0.8 to pulse_version.

docker tag 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-8.0.8 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:<pulse_version>
If you are using the MongoDB image bundled with Pulse v3.8.X, replace the migrate-8.0.8 image with the Pulse version you are upgrading to. The command looks as below.

docker tag 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:<pulse_version_3.8.X> 191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:<pulse_version>
Replace <pulse-version> with the actual version number, such as 3.8.0.

1. Restart the ad-db service.

accelo restart ad-db -d

1. Exec into the ad-db container.

docker exec -it ad-db_default bash

1. Exec into the MongoDB shell.

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

1. Set the compatibility version to 8.0

db.adminCommand( { setFeatureCompatibilityVersion: "8.0", confirm: true } )
Expected Output:

{ "ok" : 1 }

1. Exit out of the MongoDB shell.

quit

1. Exit out of the ad-db container.

exit