Completing the Installation

This document covers the following topics:

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.

Start of instruction setTo 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.

    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

    4. If installed, restart the Adabas Administration Service with the changed environment.

    Working with Adabas REST Administration

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

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

Start of instruction setTo 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.