Configuration

#### Search Results

Search

# Configuration

This document covers the following topics:

- Adabas Manager Post-Installation Configuration

- Adabas Manager and REST Server Configuration

- Adabas Environment

- File and Directory Browsing

- Adabas Manager Communicator

- Administering Internal Users in the Internal Repository File for Local Authentication

## Adabas Manager Post-Installation Configuration

This section covers the following topics:

- Required Post-Installation Configuration for Adabas Manager

### Required Post-Installation Configuration for Adabas Manager

1. Click on the host configuration icon 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

   Enter the values according to your connections.

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

- Default Configuration of the Adabas REST Server After Installation

- Default Authentication Mode of the Adabas REST Server After Installation

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

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

- Configuring the REST Server to use Adabas Manager Login Credentials

- Configuring the Adabas REST Server to use Different Login Credentials

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

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

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

### Configuring the REST Server to use Adabas Manager Login Credentials

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

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

To 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

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

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

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

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.

Browsing local drive:

Browsing mapped network drive:

## Adabas Manager Communicator

This section covers the following topics:

- Configuring Adabas Manager Communicator to Administer Entire Net-Work

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

To 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

To 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

To 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

### On this page

- Adabas Manager Post-Installation Configuration
- Adabas Manager and REST Server Configuration
- Adabas Environment
- File and Directory Browsing
- Adabas Manager Communicator
- Administering Internal Users in the Internal Repository File for Local Authentication