Completing the Installation

This document covers the following topics:

Final Installation Steps
Configure the Adabas Environment
Configure the Adabas Client Environment
Reinstall Adabas SQL Gateway and Adabas Event Replicator

Final Installation Steps

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

To complete the installation of Adabas 6.4 on Windows.

First Time Installation

Activate the Adabas license.
1. Copy 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> Software AG > Administration > Adabas 6.4 > Activate License.
3. In the Command Prompt execute the adalic script to activate the license file. Enter:
```
adalic activate license_file
```
  Where license_file represents the fully qualified path to your license file.
4. Continue as described under the step "Verify the Installation" below.
Side-by-Side Installation

If you already have Adabas Version 6.4 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 > Software AG > Administration > Adabas 6.4 > Deactivate Installation.
3. Activate the current installation via the Start menu under: All Programs> Software AG 2 > Administration > Adabas 6.4 > Activate Installation.
4. Activate the Adabas license.
  1. Copy 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> Software AG 2 > Administration > Adabas 6.4 > Activate License.
  3. In the Command Prompt execute the adalic script to activate the license file. Enter:
```
adalic activate license_file
```
    Where license_file represents the fully qualified path to your license file.
  4. Continue as described under the step "Verify the Installation" below.
Upgrade Installation

If you have Adabas Version 6.3 or earlier installed:
1. Terminate your active databases.
2. Unset the global Adabas environment.
3. Activate the current installation via the Start menu under: All Programs> Software AG > Administration > Adabas 6.4 > Activate Installation.
4. Activate the Adabas license.
  1. Copy 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> Software AG > Administration > Adabas 6.4 > Activate License.
  3. In the Command Prompt execute the adalic script to activate the license file. Enter:
```
adalic activate license_file
```
    Where license_file represents the fully qualified path to your license file.
  4. Continue as described under the step "Verify the Installation" below.
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 > Software AG > Administration > Adabas 6.4 > 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 > Software AG > Administration > Adabas 6.4 > 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
Deactivate Adabas Installation

The Adabas Installation must be deactivated prior to either
- Activating a Side-by-Side installation or
- Uninstalling the Adabas Installation
To deactivate the Adabas installation use the Start menu. Go to: All Programs > Software AG > Administration > Adabas 6.4 > Deactivate Installation.

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 > Software AG > Administration > Adabas 6.4 > Start command prompt.

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.

The Adabas Client environment can either be set system-wide (global setting) or locally to the application (local setting).

A global Adabas Client environment is required, when one or more of the following conditions apply:

When the remote administration of the database (e.g. via Adabas Manager) is required,
When the database is to be accessed via Entire Net-Work,
When a service application requires access to the database,
When multiple database versions are accessed concurrently.

Setting the global Adabas Client environment implies that only one Adabas Client version can be used. In such cases, the newest Adabas Client version installed on your machine should always be used.

Using a Local Adabas Client Environment

There are two ways to create a local Adabas Client environment:

Open a command prompt via the Start menu: All Programs > Software AG > Administration > Adabas Client 6.5 > Start Local Environment.
Alternatively, initialize the Adabas Client environment prior to executing the application by calling the script aclenv.bat located in the directory <install_dir>\AdabasClient\INSTALL\.

To set a global Adabas Client environment:

Open a command prompt via the Start menu: All Programs > Software AG > Administration > Adabas Client 6.5 > Configure Global Environment.
Execute the command aclenvvar set.

Modifying a Global Adabas Client Environment

Use the methods described above to set the global environment, when upgrading from a previous Adabas Client 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 Adabas SQL Gateway documentation.