Skip to main content

Docker Upgrade

Overview​

Docker Upgrade is used to update TAKAKRYPT services to the latest version without reinstalling the system. The upgrade process will download the latest image, update the running containers, and preserve the existing configuration and data.

Prerequisites​

Ensure the following requirements have been met:

  • Have Administrator or sudo access to the Linux server.
  • TAKAKRYPT is installed and running normally.
  • An internet connection is available to download the latest image.
  • A backup of the database and configuration has been performed.
  • The server has sufficient storage space.

Verification Before Upgrade​

1. Verify Container Status

Ensure that all services are running normally before the upgrade.

docker ps

2. Verify Storage Capacity

df -h

3. Verify Docker Service

systemctl status docker

Ensure that the Docker status is active (running).

Upgrade Steps​

Step 1: Access the Server​

Log in to the Linux server using an account that has sudo privileges.

ssh <username>@<server-ip>

Example:

ssh dummy@192.168.1.100

Step 2: Verify the Installer File​

Ensure the installer file is available on the server.

ls

Ensure the installer file is available before proceeding to the next stage.

Step 3: Run the Upgrade​

Run the following command:

sudo ./<nama file installer> upgrade

The system will perform the following process automatically:

  • Download the latest image from the repository.
  • Stop the old version containers.
  • Create and run the latest version containers.
  • Reconnect all the required services.

Post-Upgrade Validation​

Verify Container Status

Ensure that all containers are running.

sudo docker ps

Ensure that all of the following services are available and have the status Up:

  • nginx
  • website
  • gateway-service
  • auth-service
  • crypto-service
  • tokenize-service
  • masking-service
  • lock-service
  • dispatch-service
  • audit-service
  • notification-service
  • backup-service

Troubleshooting​

Upgrade Failed

Check the log of the container that is experiencing the issue:

sudo docker logs <container-name>

Container Not Running

Check the container status:

sudo docker ps -a

If there is a container with the status Exited, Restarting, or Created, check the detailed log of that container.

sudo docker logs <container-name>

All Containers Not Running

Check the Docker service status.

sudo systemctl status docker

If the Docker service is not active, restart Docker.

sudo systemctl restart docker

Once Docker is active again, verify the container status:

sudo docker ps -a