Completing the Installation

#### Search Results

Search

# Completing the Installation

This document covers the following topics:

- Final Installation Steps

- Configure the Adabas Environment

- Configure the Adabas Client Environment

- Information about the Installed Version

- Reinstall Adabas SQL Gateway and Adabas Event Replicator

## Final Installation Steps

This section describes the steps which are needed to be completed after the installation of Adabas on Windows.

To complete the installation of Adabas on Windows.

1. Activate the Adabas license.

   1. Copy the file holding the license key to a temporary location on your Windows machine.

   2. Start a Command Prompt to activate the license via the Start menu under: All Programs> Start Menu group name > Administration > Adabas n.n > Activate License.

   3. In the Command Prompt execute the `adalic` script to activate the license file. Enter:

          adalic activate path_to_license_file

      where `path_to_license_file` represents the fully qualified path to your license file.

2. Change the default Adabas Data directory.

   The default Adabas Data directory is the Adabas installation directory (C:\ProgramData\Software AG\Adabas). If you want to choose a different location:

   1. Change to the Adabas\INSTALL directory of your main installation directory.

   2. Execute the change_adadatadir.bat command. Enter:

          change_adadatadir.sh new_location

      Where `new_location` represents the fully qualified path to the new location of your Data directory.

      Note
      The script change_adadatadir.sh updates the `new_location` value in the <install-dir>\AdabasRestAdministration\INSTALL\restenv.xml file if you have Adabas REST Administration installed. Stop Adabas RESTful server before changing ADADATADIR and restart it afterwards.

3. In the case of a first-time installation, continue as described under the step "Verify the Installation" below.

4. Side-by-Side Installation

   If you already have a previous version of Adabas installed and activated:

   1. Terminate your active databases. The administration command `adashow -a` lists the databases that must be terminated.

   2. Deactivate the previous Adabas installation via the Start menu under: All Programs > Start Menu group name > Administration > Adabas n.n > Deactivate Installation.

   3. Activate the current installation via the Start menu under: All Programs> Start Menu group name 2 > Administration > Adabas n.n > Activate Installation.

   Continue as described under the step "Verify the Installation" below.

5. Verify the Installation.

   Note
   This step is optional.

   To verify your installation, you may choose to:

   - Create the Demo Database

   - Start the database

   - Generate a database report

   - Terminate the database

   To achieve this, execute the following steps:

   1. Create the Demo Database

      - Via the Start menu under: All Programs > Start Menu group name > Administration > Adabas n.n > Create Demo Database.

      - Execute the script to create the Demo Database.

   2. Start a Command Prompt to execute Adabas utilities via the Start menu under: All Programs > Start Menu group name > Administration > Adabas n.n > Start Command Prompt.

   3. Start the database from the command prompt issuing the command:

          adastart dbid

      Where `dbid` represents the Database ID of your database.

      For further details on `adastart`, refer to the section Start Database: adastart in the Extended Operation documentation

   4. Generate a database report from the command prompt issuing the command:

          adarep dbid=dbid contents

      Where `dbid` represents the Database ID of your database.

      For further details on `adarep`, refer to the section ADAREP in the Utilities documentation.

   5. Determine whether the database is active by executing the following commands from the command prompt:

          adashow -a

      and

          getdbinfo dbid

   6. Terminate the database from the command prompt issuing the command:

          adastop dbid

      Where `dbid` represents the Database ID of your database.

      For further details on `adastop`, refer to the section Stop Database: adastop in the Extended Operation documentation.

   Note
   In the above description n.n represents the current version of Adabas: the 1st digit denotes the major version, the 2nd digit – the minor version.

6. If you have Adabas REST Administration installed, the changed Adabas Data directory needs to be updated for Adabas REST Administration service in two locations:

   - <install-dir>/AdabasRestAdministration/configuration/config.xml

   - <install-dir>/AdabasRestAdministration/INSTALL/restenv.xml

   To apply the changes to these files, you must execute the following command in the Adabas REST administration bin directory:

       service.bat data_dir new_location

   Where new_location represents the fully qualified path to the new location of your Data directory.

   Restart the Adabas REST Administration system service for the new Adabas Data directory location to take effect.

## Configure the Adabas Environment

It is not possible to set Global Environment Settings for Adabas.

The Adabas utilities require the Adabas environment variables to be set. The required environment variables are automatically set when the utility programs are executed from the All Programs > Start Menu group name > Administration > Adabas n.n > Start command prompt, where n.n represents the currently installed version of Adabas (the 1st digit denotes the major version, the 2nd digit – the minor version).

Use the script `adaenv.bat` located in the directory install_dir\Adabas\INSTALL\ to set the environment variables, when Adabas utility programs are to be executed outside the command prompt.

## Configure the Adabas Client Environment

The Adabas Client environment is only required by applications and services, which access an Adabas database or utilize the database communication facilities.

In a Windows environment where multiple Adabas Client installations exist, only one Global Adabas Client Environment installation can be active.

By default, the highest installed version of Adabas Client is set as the Global Environment.

If you want to switch back to a lower version, you must first unset the previous installation and then set the current installation using the script aclenvvar.

To set the Adabas installation use the Start menu. Go to: All Programs > Start Menu group name > Administration > Adabas Client n.n > Configure Global Environment.

In the Command Prompt, execute the script aclenvvar with one of the following options:

> aclenvvar unset

>   Unsets the previous global environment.

> aclenvvar set

>   Sets the current global environment.

> aclenvvar show

>   Displays information about the current local and global environment setting.

Note
In the above description n.n represents the current version of Adabas: the 1st digit denotes the major version, the 2nd digit – the minor version.

## Information about the Installed Version

### Adabas

Information about the version number can be obtained using the following methods:

- Open a command prompt from the Start menu: All Programs> Start Menu group name > Administration> Adabas Server n.n> Start Command Prompt. Then execute

      sagver %ADAPROGDIR%\adanuc.exe

- Open a command prompt from the Start menu: All Programs> Start Menu group name > Administration> Adabas Server n.n> Start Command Prompt. Then execute

      type %ADAPROGDIR%\version.txt

Note
In the above description n.n represents the current version of Adabas: the 1st digit denotes the major version, the 2nd digit – the minor version.

### Adabas Client

Information about the version number can be obtained using the following method:

- Open a command prompt from the Start menu: All Programs> Start Menu group name > Administration> Adabas Client n.n> Configure Global Environment. Then execute

      sagver %ACLDIR%\adalnkx.dll

Note
In the above description n.n represents the current version of Adabas: the 1st digit denotes the major version, the 2nd digit – the minor version.

## Reinstall Adabas SQL Gateway and Adabas Event Replicator

If you are also using the Adabas SQL Gateway or the Adabas Event Replicator, you must reinstall these products. For further information, refer to the related product documentation.

### On this page

- Final Installation Steps
- Configure the Adabas Environment
- Configure the Adabas Client Environment
- Information about the Installed Version
- Reinstall Adabas SQL Gateway and Adabas Event Replicator