Upgrade Runbook

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

NOTE: If your current version is below 7.2.0, proceed with Step 1 and Step 2. Otherwise, directly proceed to Step 2.

Step 1 - Upgrade to Version 7.2.0

Before you continue with any latest upgrades, it's important to update your system to version 7.2.0 first. If your current version is older than 7.2.0, follow these steps:

Open the docker-compose.yaml file using a text editor.
Locate your tagversion parameter of each service and replace it with 7.2.0.
Save the changes to the docker-compose.yaml file.

Step 2 - Upgrade Steps

Follow the below steps to upgrade the knowhow instance.

Steps Pull the images , stop the running container and run the new container by following commands .

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-compose -f /docker-compose.yaml/file/location/docker-compose.yaml up -d

Note Step 2 involves the graceful shutdown of the MongoDB service, a mandatory procedure when transitioning from versions below 6.12.x to version 7.x . This ensures a smooth upgrade process.

You may proceed to skip this step if your upgrade is within the 7.x version range.

Next Step : Follow the Post Upgrade Steps