Completing the Installation

This document covers the following topics:


Final Installation Steps

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

Start of instruction setTo 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. In the case of a first-time installation, continue as described under the step "Verify the Installation" below.

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

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

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