Starting the Docker Container

When you run the Docker container, an entry point shell script executes the following tasks:

  1. Checks if the EULA is accepted, ACCEPT_EULA=Y.

  2. Prepares the environment for Adabas.

  3. Prepares the environment for the Adabas RESTful Administration service if you have Adabas REST Administration included.

  4. Initializes the mounted Adabas license files if they are available.

  5. Creates a new Adabas database. This step is optional.

    If you want to automatically generate a new Adabas database the first time you start the container, you need to set the following environment variables in your docker run command:

    1. Use the ADABAS_DB_CREATION environment variable to generate a database. Either use the demodb parameter to create the Adabas example database or define the ADAFRM Adabas parameters to create specific database container sizes. 

      ADABAS_DB_CREATION=name=ABC assosize=(100M,100M) 
assoblock=(4k,16k) datasize=100M
datablock=16k worksize=200M

    2. Specify the database ID using the ADABAS_DBID environment variable. 

      ADABAS_DBID=177

      If you do not specify ADABAS_DBID, the ID of your Adabas database is equal to the deafault value of 001.

    3. Specify the exposed access ports with the docker run -p parameter.

  6. Restores the Adabas backup. This step is optional.

    If you want to restore an Adabas backup, you must first edit the script. Use the ADABAS_RESTORE_BCK environment variable to restore files. For example: 

    ADABAS_RESTORE_BCK=/data/data.bck 4-10

  7. Enables Adabas Analytics. This step is optional.

    If you want to enable Adabas Analytics, you must first edit the script. Use the ADABAS_ELA environment variable to enable the Adabas Analytics server.

  8. Checks if another instance on a remote host is already started.

    The Adabas High Availability Tool ADAHAM allows you to have multiple Adabas database nuclei work on the same database container. In that case, the tool synchronizes all Adabas database nuclei, but only one is active at a time. If the active nucleus fails, the next nucleus becomes active.

    The tool creates a new file called ADAHAM, with which it synchronizes the different Docker container instances.

  9. Starts the Adabas nucleus.

  10. Starts the Adabas RESTful Administration service if Adabas REST Administration is included.

  11. Checks the health of the database periodically.