This section describes how to create your own container images if you do not want to use the official pre-built container images.
The Software AG installation directory/Adabas/docker/Adabas directory contains scripts to create Docker-compatible packages from the Adabas installation. A prerequisite to use the scripts is to use the Software AG Installer for the installation of Adabas.
Use the scripts to generate a package for:
a single Adabas instance without add-ons.
a single Adabas instance with Adabas RESTful Administration. The installation must contain the Adabas RESTful Administration component.
The Adabas RESTful Administration allows you to administer and monitor an Adabas Docker
container through a REST server port instead of using the docker
attach command. Software AG provides a batch tool to connect to the
container through a REST server port. For more information about administering Adabas
through REST, see Adabas REST
Administration.
To create a Docker image, you need temporary and prepared files from an Adabas installation for your local instance. These temporary files can be removed after the desired container images are created.
You can use the createAdabasSAGtar.sh script inside the corresponding
product directory (Adabas or Adabas-RestAdministration) to perform this specific task. Run
the script for your desired use case (Adabas or Adabas with RESTful administration
service) to create the temporary files in the same directory.
For example, to create the necessary files for a single Adabas instance without add-ons:
In a terminal window, go to Software AG installation directory/Adabas/docker/Adabas.
Execute the following command:
./createAdabasSAGtar.sh Software AG installation directory
where Software AG installation directory is
the directory containing your Adabas installation.
The files now created under Software AG installation directory/Adabas/docker/Adabas/tmp contain the configuration of the Adabas installation and any custom scripts required for your container environment. You must generate new temporary files every time a configuration change occurs.
Before you build the Docker image, you can specify the values for user ID and group ID in
the Dockerfile for your desired sag user inside the container. Docker creates
the sag user and group during the image creation. This user requires a unique
user ID and a group ID to create files in the persistent volume, located at
/data.
To build the container image with the default user ID and group ID of 1724, enter:
docker build --tag name:tag .
If you want to change the default values, add the --build-arg parameter to
your build command:
docker build --tag name:tag –-build-arg sag_user_id=XXXX --build-arg group_id=XXXX .
