Building a Docker image for the C-ISAM and D-ISAM server component on a Linux machine
1. Start the CONNX Server Setup on a computer on which the CONNX Administrator component is installed.
2. Select the UNIX/Linux tab.
3. Select your system's platform from the Platform drop-down menu.
4. Select the CISAM or DISAM check box in the Product area.
5. Select the Docker check box.
If the target system has an FTP, SFTP or SCP server enabled, skip to step 6.
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 CISAM\TEMPINST or DISAM\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 below.
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 the Install button.
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.
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.
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, please provide the log file as well as the script file to the support representative.
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 5 above.
10. Start a terminal emulator on the Linux server and type the appropriate user name and password.
11. Navigate to the directory you specified in the windows file transfer GUI.
This directory will contain several files, including the Docker script file.
12. Use the following command to build a docker image for the CONNX Adabas Data server:
(replace XXX with the current CONNX version number - For example "138" for version 13.8)
docker build -t connxXXXdataserver . -f./Dockerfile
The final output should read:
Successfully tagged connxXXXdataserver:latest
13. Use the following command to run the CONNX Data server docker image:
(replace XXX with the current CONNX version number - 138 for example for 13.8)
docker run -d -e "ACCEPT_EULA=Y" --name cnxserver -v <data directory>:/data:z -p <external port>:6500 connxXXXdataserver
The <data directory> should contain your C-ISAM or D-ISAM data files (If you are accessing C-ISAM or D-ISAM). Ensure that the directory, and all data files in that directory on the host system have an owner and group of sagadmin with an id of 1724. The <external port> should be the port number for connecting to the JDBC server.
Use the following docker commands to manage and verify the image and container:
Command | Description |
docker images | Show the available docker images. |
docker run -d -e "ACCEPT_EULA=Y" --name cnxserver -v /home/cnxuser/data:/data:z -p 20003:6500 connx138dataserver | Start the specified docker image. |
docker logs cnxserver | Show the log. |
docker ps -a | Show the containers. |
docker stop cnxserver | Stop the container. |
docker rm cnxserver | Delete the container. |
docker image rm connx138dataserver | Remove the image. |