Completing the Installation

#### Search Results

Search

# Completing the Installation

This document covers the following topics:

- Final Installation Steps

- Information about the Installed Version

- Reinstall Adabas SQL Gateway and Adabas Event Replicator

- Adapting the Installation for Use with other Products

- Adabas Client and Applications using s-bits

## Final Installation Steps

This section describes the steps, which need to be completed after the installation of Adabas on Linux.

Note
All scripts mentioned in the following steps are to be executed in a Bourne shell.

To complete the installation of Adabas on Linux.

1. Change to the bin directory of your main installation directory.

2. If you did not use sudo during the installation, you must run the script afterInstallAsRoot.sh to complete the installation or some products might not work correctly.

   - Run the script afterInstallAsRoot.sh with root privileges.

3. Source the environment settings by executing the command

       . ./sagenv.new

4. Activate the Adabas License.

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

   2. Change to the Adabas/INSTALL directory of your main installation directory.

   3. Execute the `adalic` command. Enter:

          adalic activate path_to_license_file

      Where path_to_license_file represents the fully qualified path to the license file.

5. Change the default Adabas Data directory.

   Notes:

   1. This step is optional.
   2. If this step is omitted, the Adabas Data directory is set to the default.
   3. The adaenv environment file will be modified by these steps.

   The default Adabas Data directory is the Adabas installation directory (i.e../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.sh` 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. Source the environment settings to enable the change. Execute the command:

          . ./adaenv

      Or close the current shell, open a new shell, change to the bin directory of your main installation directory, then source the environment by executing

          . ./sagenv.new

6. 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. Open a command shell.

   2. Source the environment settings.

   3. Create the Demo Database

      - Execute the `crdemodb` command. Enter:

            crdemodb dbid [port]

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

      `port` is an optional parameter. When this parameter is provided, it will create a new entry `ADASTARTPORTNUMBER = <port>` in DB<dbid>.INI file in the NUCPARMS section.

      This port number will be used by `adastart` to connect to nucleus.

      Valid port number is between 1024 and 65535 and the port must not be in use. Any character is not allowed.

   4. Start the database 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

   5. Generate a database report 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.

   6. Terminate the database 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

## Information about the Installed Version

### Adabas

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

- Open a command shell. Then source the environment settings and execute

      sagver $ADAPROGDIR/bin/adanuc.bin

- Open a command shell. Then source the environment settings and execute

      cat $ADAPROGDIR/version.txt

### Adabas Client

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

- Open a command shell. Then source the environment settings and execute

      sagver $ACLDIR/lib/ libadalnkx.so

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

## Adapting the Installation for Use with other Products

If you are also using other Software GmbH products, you must either install those products into the same directory where you installed Adabas, or you must modify the generated script sagenv.new to setup up your environment properly. For further information see Side-by-Side Installations.

## Adabas Client and Applications using s-bits

The default installation directory for Adabas Client is /opt/softwareag/AdabasClient.

If you are installing Adabas Client into a directory which is not the default (e.g. /opt/softwareag/Suite1/Adabas Client) and you want to use an Adabas interface with applications that have the s-bit set, you must create a symbolic link pointing the directory /opt/softwareag/AdabasClient to the physical location of the Adabas Client Installation directory..

To create a new symbolic link

1. Open a command shell.

2. Source the environment settings.

3. Create the symbolic link by executing:

       ln -s <installation_directory> /opt/softwareag/AdabasClient

   For example:

       ln -s /opt/softwareag/Suite1/AdabasClient /opt/softwareag/AdabasClient

Note
These operations require root permissions.

### On this page

- Final Installation Steps
- Information about the Installed Version
- Reinstall Adabas SQL Gateway and Adabas Event Replicator
- Adapting the Installation for Use with other Products
- Adabas Client and Applications using s-bits