Building an Adabas Manager Docker Image

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.


General Information

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.

Prerequisites

  • Docker installation version 1.13.1 or compatible;

  • Software AG Adabas Manager installation.

Building and Running the Adabas Manager Docker Image

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.

Start of instruction setTo build the Adabas Manager archive file (tar)

  • Execute the script CreateAdabasManager-tar.sh at <install_dir>/AdabasManager/docker/.

Start of instruction setTo 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:8.6.0 . 

Start of instruction setTo run the Docker image

  • Execute the following command:

    docker run -d -p 1234:8083 -e ACCEPT_EULA=Y --name AdabasManager86 adabasmanager:8.6.0

    Note:
    Port 1234 is a port on the host machine which is not used by another process. Port 8083 is the Adabas Manager port on the host machine. Port 8083 could be 9083, 10083 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 com.softwareag.catalina.connector.http.pid-{port-number}.properties at <Software AG installation folder> profiles/CTP/configuration/com.softwareag.platform.config.propsloader.

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.

Using Adabas Manager

  1. Launch Adabas Manager web application by entering the URL, for example http://{host-of-docker-container}:8083/amn in the browser.

  2. Login to the Adabas Manager web application with the default user ID = admin and password = manage.

Managing additional tester IDs in the authentication text file

  1. Go into the bash shell of the running container by entering the following command:

    docker exec -it <container-id> bash
  2. Issue the following command at the bash shell prompt to list internal users in the authentication text file:

    sh /opt/softwareag/common/bin/internaluserrepo.sh -f
     /opt/softwareag/AdabasManager/config/users.txt -lu
  3. Issue the following command at the bash shell prompt to add internal users to the authentication text file:

    sh /opt/softwareag/common/bin/internaluserrepo.sh -f
     /opt/softwareag/AdabasManager/config/users.txt user1
  4. Issue the following command at the bash shell prompt to delete internal users from the authentication text file:

    sh /opt/softwareag/common/bin/internaluserrepo.sh -f
     /opt/softwareag/AdabasManager/config/users.txt -d user1