Building a Docker Image for the Adabas SQL Gateway Server Component on a Linux Machine
1. Launch CONNX Server Setup.
2. In the CONNX Server Component Installation dialog box, select the UNIX/Linux tab.
3. Select your system's platform from the Platform drop-down box. Select Adabas in the Product area. Select Docker.
4. If the target system has an FTP, SFTP or SCP server enabled, skip to step 5.
5. If the target system does not have an FTP, SFTP or SCP server enabled, select the Manual Copy Installation option and click the Begin Client Installation button. This option will create the necessary install files in the ADABAS\TEMPINST subdirectory of the CONNX installation directory. Move these files via an alternate copy method to the Unix server and then proceed to Step 12.
6. Select the desired transfer method and then in the Server text box, enter the TCP/IP host name or address for your system platform.
7. In the User ID text box, enter a privileged user account name. In the Password text box, enter a user account password.
8. By default, the Adabas data is sent to your home directory. If you wish to send it to another location, enter the name of the alternate directory in the Installation Information Install Path text box.
9. Click Install.
This action starts an FTP, SFTP or SCP session and copies the selected components to the target server. Progress will be displayed at the bottom of the screen.
10. An ftp window appears saying the files were successfully copied to the system and instructs you to log on to your system and follow the instructions in the readme.docker text file.
11. If the file transfer was not successful, an error box appears. Select Files from the menu. The sub menu has options to view the FTP log as well as the FTP script. The FTP logs have a timestamp appended to the name. Select the appropriate log file and check for errors. If the resolution to the problem requires a call to technical support, provide the log file as well as the script file to the support representative.
12. If the files fail to copy via the Client Installation's FTP, SFTP or SCP session, please use the Manual Copy Installation as outlined in Step 4.
13. To build the Docker image, start a terminal emulator on the Linux server and type the appropriate user name and password.
14. Navigate to the directory you specified in the windows file transfer GUI. This directory contains several files, including the Docker script file.
15. To build a docker image for the CONNX Adabas Data server, use the following command:
docker build -t connxXXXdataserver . -f./Dockerfile
where XXX is the current CONNX version number, for example 138.
16. To run the CONNX Data server docker image, use the following command:
docker run -d -e "ACCEPT_EULA=Y" --name cnxserver -v adabas client config directory:/config:z -p external port:6500 connxXXXdataserver
where XXX is the current CONNX version number, for example 138.
adabas client config directory is your dbmapping.txt to configure TCP/IP connectivity to Adabas nucleus.
Ensure that the directory on the host system has an owner and group of sagadmin with an id of 1724.
external port is the port number for connecting to the JDBC server.
17. Refer to the following docker commands to manage and verify the image and container:
Show the available docker images:
docker images
Start the docker image - for example:
docker run -d -e "ACCEPT_EULA=Y" --name cnxserver -v /home/cnxuser/adaconfig:/config:z -p 20003:6500 connx138dataserver
Show the log:
docker logs cnxserver
Show the containers:
docker ps -a
Stop the container:
docker stop cnxserver
Delete the container:
docker rm cnxserver
Remove the image:
docker image rm connx138dataserver