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 Add Host on the Adabas Host Connections screen.

  3. graphics/add_host.png

    Enter the Connection Name, Host Name/IP and Port.

  4. Select the Authentication Configuration.

  5. Click on the Add Host button to add the new host connection to the Adabas REST server.

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.

graphics/config_default.png

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.

graphics/amn_credentials.png

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.

graphics/https.png

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

Select the Use Adabas Manager login credentials radio button to connect to the Adabas REST Server using Adabas Manager credentials, otherwise select the Use different login credentials, please specify user name radio button and specify the user name to connect, using Adabas REST Server credentials and its default authentication mode.

Prerequisite: Adabas REST Server authentication and credentials configuration.

graphics/amn_auth_config.png

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.

      graphics/rest_amn_credentials.png

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\configuration) and rename the file realm.properties to an arbitrary name.

    Note:
    You can ignore this step if you want to keep the default post-installation user name and password. The new user name and password will be added as a new entry to the existing one.

    graphics/realm_properties_file.png

  2. Stop the Adabas REST Server if it is running.

    graphics/stop_rest.png

  3. From the Adabas command prompt, go to the Adabas REST Server installation directory (<installation directory>\AdabasRestAdministration\bin) and run the command service.bat init. You will be prompted to Enter Administration user: enter the user name and password for that user.

    graphics/other_credentials.png

  4. The user name and password are now set. Go back to the Adabas REST Server installation directory and check for a new realm.properties file. Your new user name should appear in the file.

    graphics/other_users.png

  5. Run the command service.bat run to restart the Adabas REST Server.

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

    graphics/add_environment.png

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

graphics/adadatadir.png

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.

graphics/add_location.png

Browsing local drive:

graphics/local_drives.png

Browsing mapped network drive:

graphics/network_drive.png

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 InternalRepository 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 create a users.txt file for local authentication:

  • Create the users.txt file in <install-dir>/AdabasMager/config by executing the following command at <install-dir>/common/bin, where <install-dir> represents your Adabas Manager installation directory:

    ./internaluserrepo.sh -c -f ../../AdabasManager/config/users.txt -p mypassword myusername

    Or:
    In a Windows environment, issue the following command at the Windows command prompt to create the authentication text file (users.txt):

    internaluserrepo.bat -c -f ..\..\AdabasManager\config\users.txt -p mypassword myusername

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 (users.txt), issue the following command at the bash shell prompt:

    sh /<install-dir>/common/bin/internaluserrepo.sh -f /<install-dir>/AdabasManager/config/users.txt user1

    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 (users.txt):

    <install-dir>\common\bin\internaluserrepo.bat -f <install-dir>\AdabasManager\config\users.txt user1

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>/common/bin/internaluserrepo.sh -f /<install-dir>/AdabasManager/config/users.txt -lu

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

    <install-dir>\common\bin\internaluserrepo.bat -f <install-dir>\AdabasManager\config\users.txt -lu

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 (users.txt), issue the following command at the bash shell prompt:

    sh /<install-dir>/common/bin/internaluserrepo.sh -f /<install-dir>/AdabasManager/config/users.txt -d user1

    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 (users.txt):

    <install-dir>\common\bin\internaluserrepo.bat -f <install-dir>\AdabasManager\config\users.txt -d user1