Building an Adabas Manager Docker Image

#### Search Results

Search

# 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

- Prerequisites

- Building and Running the Adabas Manager Docker Image

## 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.

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/:

      docker build -t adabasmanager:{version} .

  Note
  The dot at the end of the command tells the command to look for the file (Dockerfile) at current location/folder.

To run the Docker image

- Execute the following command:

      docker run -d -p 1234:4990 -e ACCEPT_EULA=Y --name {AnyName} adabasmanager:{version}

  … where {`version`} could be 9.2.0 for Adabas Manager 9.2.0 (and so on) and {`AnyName`} can be any easily recognizable container name.

  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.

#### Using Adabas Manager

1. Launch Adabas Manager web application by entering the URL, for example https://{host-of-docker-container}:4990/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/AdabasManager/bin/text_user.sh list

3. 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

4. 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

### On this page

- General Information
- Prerequisites
- Building and Running the Adabas Manager Docker Image