Installation on Unix


Prerequisites

Adabas, Natural and Entire Net-Work

If you use Adabas, Entire Net-Work or Natural, these products should be installed and configured before installing Adabas Vista.

Adabas System Coordinator

Adabas System Coordinator must be installed before installing Adabas Vista. Adabas System Coordinator is included with Adabas Vista and will be installed or upgraded automatically by the Adabas Vista installation.

See the Adabas System Coordinator documentation for further details.

Configuration File

The Configuration File for the Adabas add-on products should be set up before installing Adabas Vista. Check that the machine on which you are installing Adabas Vista can access the Configuration File.

SYSAVI

The Adabas Vista configuration information in the Configuration File is managed using the Natural application SYSAVI. Only users that will manage the Configuration File need to install SYSAVI.

If you need to install Natural in order to use SYSAVI, this should be carried out before installing Adabas Vista.

Before You Start

The installation instructions make the following assumptions:

  • Adabas System Coordinator is being installed from CD-ROM

  • The CD-ROM is mounted on /dev/cdrom

  • The user account used to administer Software AG products is sag.

  • The SAG installation directory is /opt/softwareag

Running the Installation

To start the installation of Adabas Vista:

  • Login as user sag.

  • Run sh /dev/cdrom/setup.ux

The installer will now start and guide you through the installation process. You will be asked for some information as the installation progresses.

Software AG Installation Directory

You will be prompted to enter the path to the Software AG installation directory.

Adabas Visa License File

You will be prompted for the Adabas Vista license file. This file can be found on the root of the installation CD-ROM or (if you have already installed Adabas Vista previously) the/opt/softwareag/common/LKey directory.

Adabas System Coordinator

The installer will check that you have Adabas System Coordinator installed and that is the correct version. If it is not installed or is not the correct version, the Adabas System Coordinator installation will be invoked.

See the Adabas System Coordinator documentation for further details.

After Installation

User and Group

When the installation has completed, check that the /opt/softwareag/avi directory structure has been created and make sure that all files are owned by the user sag and have the group ID sag.

Environment Script

The installation will create an environment settings file sagenv.new. Review the contents of this file and check that the Adabas Vista environment is sourced after the Adabas System Coordinator environmemt.

Rename the sagenv.new file to sagenv and ensure that it is sourced from the .profile of each user who will use this environment.

Library Search Path

Source the sagenv script and check that the environment variable that controls the library load path ($LD_LIBRARY_PATH, $LIBPATH or $SHLIB_PATH depending upon the platform) is set so that the Adabas System Coordinator lib subdirectory appears before the directory in which the standard Adabas or Entire Net-Work ADALNKX is located.

Installing SYSAVI

The INPL file for installing SYSAVI can be found in the sysavi subdirectory on the Adabas Vista installation media.

For detailed information about using Natural, please refer to the Natural documentation. The user interface and the INPL utility are described in the Using Natural and Tools and Utilities sections respectively.

Set Work File 4

The INPL utility uses Work File 4 as the Report File. Some versions of Natural do not set a default $WRKF4 during installation, so you must do so before installing SYSAVI.

  • Run natparm

  • Select Natural Execution Configuration from the Edit menu

  • Select Work Files

  • Check that Work File 4 is set appropriately.

Install SYSAVI

The INPL utility is run from the Natural development environment.

  • Start natural.

  • Run the direct command INPL.

  • Choose Function Code B.

  • Choose File Type P.

  • Type /dev/cdrom/sysavi/sysavi.sag in the Load File field.

  • Press enter to install.

Configure LFILE 152

SYSAVI uses the Natural LFILE parameter to determine the database and file number of the Adabas Vista Configuration File. After installing the INPL you must configure the LFILE setting for file 152.

  • Run natparm.

  • Select Database Management System from the Edit menu.

  • Select Administrator DBMS Assignment

  • Select Administrator Logical Files.

  • Set LFILE 152 to the database and file number of the Configuration File.

  • Save the settings by selecting Save from the File menu.

  • Exit natparm.

Verify SYSAVI Installation

Verify the installation by performing the following actions:

  • Run natural

  • Logon to library SYSAVI

Run program MENU and the SYSAVI Main Menu will appear.