This article describes how to deploy the Smart ID Digital Access component on Docker using docker swarm.

You can also deploy Smart ID complete package using docker compose for which you can refer to Deploy Smart ID.

Prerequisites

The following is needed:

• Docker client and engine version 20.10.10 or later

• Linux that supports the above docker versions

• Software Components: Any of the PostgreSQL, MySQL, Sql-server, or Oracle database

• Configuration files: setup.tgz

• System Requirements: 8cpu with 32GB RAM and 100 GB physical space is recommended.

• For offline setup, you must install docker

Preparations

• Download the setup.tgz file on system from the support portal.

• It is always recommended to take backup/snapshot before starting setup.

• If you have multiple network interfaces, note down the NIC name or IP address of the network interface which will be used by docker swarm.

  • When docker swarm is initialized it binds to one NIC and one IP address for communication, and if you have multiple NICs, you have to specify which one to use, by NIC name or IP address.

  • If you want traffic for swarm to be restricted to a private/internal network then provide an internal IP address. But if you want to expose some of your service then you need to provide your public IP address.

Step-by-step instruction

Run the setup

1. Copy setup.tgz to your working directory.

2. Extract the file using tar command.

   Extract file

   tar -xf setup.tgz

3. Navigate to the scripts folder inside the setup folder.

   Navigate to scripts folder

   cd setup/scripts

4. Run the script setup.sh.

   Run the script

   sudo bash setup.sh

5. During the setup, provide the below mentioned inputs. 

Inputs

You will need to input the IP address that will be used for the swarm communication based on the NICs. See the "Preparations" section above.

To setup PostgreSQL press “Y” (Not recommended for production setup). If you want to use some external database press ‘’n”.

Next it will setup reporting database using PostgreSQL.

It will now pull the docker images and start the services

Wait for all the images to get downloaded. To check status of downloaded images, use this command: 

Check images

After all the images are downloaded from the repository, the containers will start automatically. It can take a few minutes to start all the containers. To check the container status, use this command:

Check container status

Make sure the status of each container is healthy.

Restart the services using this command on the node:

Deploy Digital Access stack

Offline setup

Offline setups consist of two steps:

First step

For the first step you need a system with network connectivity. Download docker images on the system.

1. Make sure docker is installed.

2. Download the images using the command docker pull. 

   pull images

3. To verify that all images are downloaded, run this command:

   Check images

4. Save all images in tar files. Run these commands: 

   image to tar

5. Copy all the tar files onto the system where you want to setup Digital Access.

Second step

On the system where the Digital Access setup will be done:

1.  Go to the folder where all the tar files are copied.

2. Load the images to a local docker repository using the command:

   load Images

3. Run the installation process, and follow the steps mentioned above.

Additional information