Configuration

This document covers the following topics:


Adabas Manager Post-Installation Configuration

This section covers the following topics:

Required Post-Installation Configuration for Adabas Manager

  1. Click on the host configuration icon graphics/host_config.png on the top right corner of the Adabas Manager screen.

  2. Click on the button Host Config.

  3. Click the "+" icon on the far right, to add a new Adabas REST Administration HOST

    Host Configuration, Add icon on the far right ("plus" symbol)

    Enter the values according to your connections.

    Host Configuration, Add a host by entering Connection name and hostname

You can add as many host connections to the Adabas REST Server as you want, and enable only those you want to administer by setting the connection to ‘Enabled’ (default setting).

Adabas Manager and REST Server Configuration

This section covers the following topics:

Login to the Adabas Manager

Adabas Manager accepts log-ins from the following:

  • Operating system (e.g. Windows) local user

  • LDAP domain user

If the username of local user and LDAP user are identical, then the local user credentials take precedence.

For further information about Adabas REST Server connection authentication using its default authentication mode, refer to Adabas Rest Administration, Installation and First Steps for the Adabas REST Server default login credentials.

Default Configuration of the Adabas REST Server After Installation

The default configuration of the REST server can be found in config.default.xml file.

default configuration

Default Authentication Mode of the Adabas REST Server After Installation

Adabas REST Server uses Java JAAS with the standard "Adabas" configuration as its default authentication mode (see the XML tag <LoginService...> in the config.xml file located in the Adabas REST Server installation configuration directory). By default it is <LoginService class="" module="Adabas" type="jaas"/>. It authenticates the Adabas REST Server login credentials (including the Adabas REST Server post-installation default login credentials) contained in the realm.properties file located in the same Adabas REST Server installation configuration directory. The authentication mode can be changed by adapting the server module of the <LoginService...> in the config.xml file. Refer to Adabas Rest Administration, Authentication for further information.

authentication mode

Port Number for Adabas Manager Host Connection to the Adabas REST Server

Use the Adabas REST Server default port (assigned during Adabas REST Server installation), which is port 8190 for connection via HTTP, or port 8191 for a secured connection via HTTPS. The port is evaluated in the config.xml file located in the Adabas REST Server installation configuration directory.

Select the Secured Connection (via HTTPS) check box if you want to use a secured connection via HTTPS to the Adabas REST Server.

Host Configuration - Secured Connection Check Box

Authentication Configuration for Adabas Manager Host Connection to the Adabas REST Server

To connect to the REST Server using Adabas Manager credentials turn the switch "AMN Auth" to "Yes".

To connect to the REST Server using Adabas REST Server credentials and its default authentication mode turn the "AMN Auth" switch to "No" and specify the Adabas REST Server user name in the field "Alt. User".

Host Configuration - AMN Auth Check Box

Configuring the REST Server to use Adabas Manager Login Credentials

Start of instruction setTo configure the REST server to use Adabas Manager login credentials:

  • Follow the steps below if you select Use Adabas Manager login credentials and use LDAP domain user credentials:

    1. Go to the Adabas REST Server installation directory <installation directory>\AdabasRestAdministration\configuration.

    2. Open the file config.xml and search for the XML tag <LoginService...>.

    3. Edit the value of module to module="windows" (for Windows).

      Note:
      The module name is case sensitive and must match the module name defined in the security.conf file located in the same directory

    4. Save the edited version of config.xml.

      edited version of config file

If you select Use Adabas Manager login credentials and use OS local user credentials, see Configuring the Adabas REST Server to use Different Login Credentials

If local and domain user names are identical, the local user name authentication takes precedence.

Configuring the Adabas REST Server to use Different Login Credentials

Start of instruction setTo configure the Adabas REST server to use different login credentials (other than its default login credentials and LDAP domain user)

  1. Go to the Adabas REST Server installation directory (<installation directory>\AdabasRestAdministration\bin).

  2. Run the command service.bat(sh) add_user. You will be prompted to enter the user name and password for that new user.

  3. Restart the Adabas REST Server by running the command service.bat/sh stop/start or sudo system_service.sh stop/start from <installation directory>\AdabasRestAdministration\bin.

Adabas Environment

This section covers the following topics:

Configuring Adabas Manager and the Adabas REST Server to Allow the Administration of a Different Adabas Version in a Different Location

In the Adabas REST Server configuration file, the Adabas installation location (ADAPROGDIR) is set by default to the Adabas REST Server installation directory.

Start of instruction setTo enable administration of a different Adabas version:

  1. From an Adabas command prompt, set the Adabas environment by executing the command service.bat add_env <Adabas installation location>.

    add environment

  2. To set the Adabas environment for lower Adabas version, use the latest Adabas REST Server installed for the current Adabas version.

Note:
If the specified installation location does not have Adabas installed, the error message EAIF00013:Adabas environment path error will be displayed, e.g. ‘Error evaluating environment on C:\SoftwareAG_ADA:EAIF00013:Adabas environment path error for C:\SoftwareAG_ADA\Adabas’

File and Directory Browsing

Browsing in Adabas Manager

By default, the browsing directory is set to {ADADATADIR}.

default browsing directory

If you want to browse files on another location, e.g. local drive or network drive, add its directory location to the Adabas REST Server config.xml file.

add location

Browsing local drive:

browsing local drive

Browsing mapped network drive:

browsing mapped network drive

Adabas Manager Communicator

This section covers the following topics:

Configuring Adabas Manager Communicator to Administer Entire Net-Work

Adabas Manager Communicator disables CORS by default. CORS must be enabled in order for Adabas Manager to connect to and administer Entire Net-Work. Open the file <Software AG Installation Folder>\AdabasManagerCommunicator\config\amc.properties and change the following line from:

ENABLE_CORS=NO

to

ENABLE_CORS=YES

To allow all connections to Adabas Manager Communicator:

ALLOW_ORIGIN=*

To allow a specific Adabas Manager to connect:

ALLOW_ORIGIN=http://<host>:<port> (for example http://amn.com:8083)

Restart the Adabas Manager Communicator service after configuring the amc.properties file in order for the changes to take effect.

Administering Internal Users in the Internal Repository File for Local Authentication

Besides logging into Adabas Manager using LDAP authentication, it is possible to create local user IDs and store them into a text file. This is useful for users of Adabas Manager who only want to test out Adabas Manager locally without connecting to the company network (LDAP).

Start of instruction setTo add internal users to the InternalRepository file for local authentication:

  • To add internal users (e.g. user1) to the authentication text file (auth.config), issue the following command at the bash shell prompt:

    sh /<install-dir>/AdabasManager/bin/text_user.sh add

    Or:
    In a Windows environment, issue the following command at the Windows command prompt to add internal users (e.g. user1) to the authentication text file (auth.config):

    <install-dir>\AdabasManager\bin\text_user.bat add

Start of instruction setTo list internal users in the InternalRepository file for local authentication:

  • To list internal users in the authentication text file, issue the following command at the bash shell prompt:

    sh /<install-dir>/AdabasManager/bin/text_user.sh list

    Or:
    In a Windows environment, issue the following command at the Windows command prompt to list internal users in the authentication text file (auth.config):

    <install-dir>\AdabasManager\bin\text_user.bat list

Start of instruction setTo delete internal users from the InternalRepository file for local authentication:

  • To delete internal users (e.g. user1) from the authentication text file (auth.config), issue the following command at the bash shell prompt:

    sh /<install-dir>/AdabasManager/bin/text_user.sh delete

    Or:
    In a Windows environment, issue the following command at the Windows command prompt to delete internal users (e.g. user1) from the authentication text file (auth.config):

    <install-dir>\AdabasManager\bin\text_user.bat delete