Installation and First Steps

#### Search Results

Search

# Installation and First Steps

Installation is done using the Software AG Installer. The Adabas REST administration is part of Adabas but does not have to be installed with Adabas. If another Adabas installation is on the installation host, this can be used, if the Adabas version is greater than or equal to Adabas Version 6.5.

Access to Adabas RESTful resources is protected using authentication, which is managed by the configuration file realm.properties, which contains a list of users and passwords.

This document is organized as follows:

- Password Management

- Adabas Installation Management

- Changing the Location of the Adabas Data Directory

- Starting the Server

- Ensuring that the Server is Working

## Password Management

### Setting the Initial Admin Password

During installation, you will be prompted by a dialog box to set the initial admin password. This password-setting feature is available from version 7.0.1 onwards.

If for any reason you need to reset the initial password at a later stage, you can do so by deleting the realm.properties configuration file in the configuration directory, and then recreating the file by running the service script as follows:

    ./service.bat init

### Managing New Users and Passwords

You can add new user and password entries to configuration/realm.properties. The service script provides you with the functionality to add an additional user as follows:

    ./service.bat add_user

## Adabas Installation Management

The Adabas RESTful server is able to manage different version of Adabas. Up to two minor version are support downwards. In this case, the Adabas Version 6.7 based Adabas RESTful server supports managing Adabas Version 6.6 and Adabas Version 6.5 databases. A prerequisite for this is to provide a corresponding Adabas version installation. The Adabas installation location has to be added to the Adabas RESTful server configuration.

The service script provides you with the functionality to add additional Adabas installations. The current status is displayed by using the following command:

    ./service.bat add_env

The output of this example out would look something like this:

    2019-02-14 10:54:02 - Load default configuration from file /opt/softwareag/AdabasRestAdministration/configuration/config.xml
    Current defined configurations:
    ----------------------------
    ADADATADIR      : /data/SAG/Adabas
    ---------------------------------------------
    Location        : /opt/softwareag
     ADAPROGDIR      : /opt/softwareag/Adabas
     Version         : V67002
     Structure level : 21
    ---------------------------------------------

Use the following command to add a new installation:

    ./service.bat add_env <Installation location>

This will add the Adabas installation to the Adabas RESTful configuration.

## Changing the Location of the Adabas Data Directory

By default, the Adabas Data directory (ADADATADIR) is the Adabas installation directory. You can change the default location of the Adabas Data directory with the `change_adadatadir.sh` or `change_adadatadir.bat` command. For details on how to change the Adabas Data directory, see Installation on Windows > Completing the Installation or Installation on Linux > Completing the Installation.

## Starting the Server

Inside the installation directory of the Adabas REST administration, a bin directory can be found. The bin directory contains all of the start scripts required to start the Adabas REST administration. All scripts will provide reference information about valid parameters in case no argument is entered.

For example, to start the REST server on Windows just start:

    ./service.bat run

## Ensuring that the Server is Working

To check if the server works correctly, you can either use your favorite web browser or use curl. By default, the username is admin and the password is manage.

Use the following command to check whether the server is running:

    http://<host>:<port>/adabas/database

where `<host>` and `<port>` correspond to your environment. The following are some example REST calls:

URL | Function | Result
--- | --- | ---
http://localhost:8120/adabas/database | List databases | List all databases known to the REST server
http://localhost:8120/adabas/database/24 | Database Info | Returns the database information for database 24
http://localhost:8120/adabas/database/24/file | List database files | List all files defined in the database 24

Using curl, the following command would correspond to the first example:

    curl -vv --user admin:manage http://localhost:8120/adabas/database

### On this page

- Password Management
- Adabas Installation Management
- Changing the Location of the Adabas Data Directory
- Starting the Server
- Ensuring that the Server is Working