Page Comparison

To ensure a smooth upgrade process, please follow the instructions below.

Note: If your current version is below 7.2.0, please follow Step 2. Otherwise, proceed with Step 1 only.

...

docker-compose -f /docker-compose.yaml/file/location/docker-compose.yaml pull
docker exec mongodb /bin/bash -c 'mongo admin --username="${MONGO_INITDB_ROOT_USERNAME}" --password="${MONGO_INITDB_ROOT_PASSWORD}" --eval "db.shutdownServer()"'
docker-compose -f /docker-compose.yaml/file/location/docker-compose.yaml down
docker-compose -f /docker-compose.yaml/file/location/docker-compose.yaml up -d

Next Step : Follow the Post Upgrade Steps

...

Only for those whose current version is below 7.2.0,

Before you continue with any latest version (> 7.2.0), it's important to update your system to version 7.2.0 first. By following these steps:

...

docker-compose -f /docker-compose.yaml/file/location/docker-compose.yaml pull
docker exec mongodb /bin/bash -c 'mongo admin --username="${MONGODB_ADMIN_USER}" --password="${MONGODB_ADMIN_PASS}" --eval "db.shutdownServer()"'
docker-compose -f /docker-compose.yaml/file/location/docker-compose.yaml down
docker stop nonjira-processor azure-processor nonazureboards-processor notification-consumer
docker rm nonjira-processor azure-processor nonazureboards-processor notification-consumer
docker-compose -f /docker-compose.yaml/file/location/docker-compose.yaml up -d

NOTE Ignore any errors

Step 2 c. - Upgrade Steps

If your current version is 7.x.x and want to upgrade to 8.1.0

• At first please upgrade your server to 8.0.0 by following this PSknowHOW - Upgrade Guide  and then run the delta script from 7.x.x to 8.0.0 from https://github.com/PublicisSapient/PSknowHOW

• And then start upgrading 8.0.0 to 8.1.0 by following the below steps:

  • In the docker-compose file replace the version from 8.0.0 to 8.1.0 and create following property changes in customapi.properties file.

#the package needs to be changed based on the installation and upgrade

• mongock.migration-scan-package=com.publicissapient.kpidashboard.apis.mongock.upgrade

#If you are creating a fresh instance, set the starting system version to 0

#The base version for Mongock is 8.0.0, so for upgrading an instance, maintain it as 8.0.0

• mongock.start-system-version=8.1.0