This document describes how to build an Adabas Manager Docker image, and how to run the Adabas Manager container using scripts that are provided with Adabas Manager.
The preparation of Adabas Manager in a docker container consists of two steps that are performed after the appropriate Adabas Manager components have been installed:
Preparation of a .tar file which contains all required components;
Building the docker image based on the .tar file.
Docker installation version 1.13.1 or compatible;
Software AG Adabas Manager installation.
The directory <install_dir>/AdabasManager/docker/ contains the following three files:
CreateAdabasManager-tar.sh
Dockerfile
entrypoint.sh
The scripts provided with Adabas Manager support the building of a Docker image and the running the Docker container.
To build the Adabas Manager archive file (tar)
Execute the script CreateAdabasManager-tar.sh at <install_dir>/AdabasManager/docker/.
To build the Adabas Manager Docker image
Execute the following command at <install_dir>/AdabasManager/docker/ (note the period at the end of the command):
docker build -t adabasmanager:9.0.0 .
To run the Docker image
Execute the following command:
docker run -d -p 1234:4990 -e ACCEPT_EULA=Y --name AdabasManager90 adabasmanager:9.0.0
Note:
Port 1234 is a port on the host machine which is not used
by another process. Port 4990 is the Adabas Manager port on the host machine.
Port 4990 could be 4991, 4992 and so on if there are more than one parallel
installations of Adabas Manager in the host machine. You can check this port
number in the file at <Software
AG_installation:directory>/AdabasManager/config/config.env .
The advantage of this method is that the complete configuration is in the image. For troubleshooting, Software AG support will require only the image and the command you entered. The disadvantage of this method is if the configuration changes, you will have to build a new image and rerun the container.
Launch Adabas Manager web application by entering the URL, for example https://{host-of-docker-container}:4990/amn in the browser.
Login to the Adabas Manager web application with the default user ID = admin and password = manage.
Go into the bash shell of the running container by entering the following command:
docker exec -it <container-id> bash
Issue the following command at the bash shell prompt to list internal users in the authentication text file:
sh /opt/softwareag/AdabasManager/bin/text_user.sh list
Issue the following command at the bash shell prompt to add internal users to the authentication text file:
sh /opt/softwareag/AdabasManager/bin/text_user.sh add
Issue the following command at the bash shell prompt to delete internal users from the authentication text file:
sh /opt/softwareag/AdabasManager/bin/text_user.sh delete