Installing the ADABAS Software

Installing the ADABAS Software

The ADABAS software and auxiliary files are stored in a UNIX directory tree of their own. This tree is integrated into the file system of the particular computer by means of a common shell environment variable DBROOT.

~1) Loading the Distribution Medium

Changing to the directory $SAG (if already defined); otherwise, to any other directory. In the directory $SAG, a subdirectory './esd/vnnn' (nnn is the version number, e.g., 611) is created. The software is loaded into this subdirectory.

cpio -ivBcdum < <tape device> Loading the software from the distribution medium.

Thus, DBROOT is the directory '<current directory>/esd/vnnn'.

In the ADABAS software dirctory DBROOT, the following files and subdirectories are created:

$DBROOT/README.eng Text file containing information about the current version in English (analogously README.deu: information about the version in German)

$DBROOT/pgm Executable programs, analysis tools, precompilers

$DBROOT/bin User commands for the ADABAS programs

$DBROOT/env Messages and HELP files

$DBROOT/etc/instlist List of all files that are required for installing an operational ADABAS database

$DBROOT/etc/filelist
List of all files created while loading the distribution medium

$DBROOT/lib Libraries for the precompilers, CALL Interface

$DBROOT/terminfo Terminal description files

$DBROOT/incl Precompiler include files

$DBROOT/demo/eng Demonstration programs for the precompilers, QUERY, LOAD, and SQL with explanations in English
(analogously: "$dbroot/demo/deu" with explanations in German)

$DBROOT/wrk Default directory where the RUNDIRECTORY and BACKUPDIRECTORY will be created.
The RUNDIRECTORY keeps the diagnose files;
the BACKUPDIRECTORY keeps copies of the parameter files.

~2) Preparing ADABAS

cd esd/vnnn
Changing to the directory DBROOT

bin/x_install Call as superuser ("root"). The owner and group of the ADABAS files are requested. Owner and access rights are set for the loaded files. The service name of ADABAS (sql30) is entered into the file "/etc/services" if this name is not yet available there. "bin/x_install" must also be executed for update installations.

~3) Setting the environment variables DBROOT and PATH

a) Manually

DBROOT=... The environment variable DBROOT must contain the name of the path (see above).

PATH=$DBROOT/bin:$PATH The directory "$dbroot/bin" must be integrated into the path to provide the SERVERDB with global access to the shell scripts.

Both environment variables must be exported using 'export'. It is recommended to call these commands in a shell or in the profile (.profile, .login, etc.).

b) Using the shell script 'SAGINST'

./SAGINST Call of the shell script
'SAGINST'

The shell script checks whether the environment variable SAG has already been defined. SAG defines the root directory for all SOFTWARE AG products.

Afterwards, a list of all products stored under SAG is displayed. To select the desired product, enter the corresponding number. If various products are concerned, the numbers must be separated by blanks.

Then a file 'sagenv.new' is created. The environment variables DBROOT and PATH are determined in this file. If there is already a file 'sagenv.new' under SAG, this file is renamed 'sagenv.old' .

It is recommended to rename the file 'sagenv.new' 'sagenv'. If an update installation is concerned, i.e., 'sagenv' is already available, only replace the product-specific parts of 'sagenv' with the contents of 'sagenv.new'.

The call

. $SAG/sagenv

should then be entered into the '.profile' files of all the product's users.

~4) Setting optional environment variables

SERVERDB=... SERVERDB denotes the name of the SERVERDB.

DBTERM=... DBTERM overrides TERM only for the ADABAS tools. The pertinent terminal description file is stored in "$dbroot/terminfo" .

DBTERMRESET=... DBTERMRESET can contain the string for a shell command which is executed after leaving an ADABAS tool, e.g., to reset the screen colors.

DBHIF=... DBHIF overrides the keyboard layouts of TERM or DBTERM. Own keyboard layouts can be made using "x_maketi" (see Section Using "x_maketi").

DBCHARSET=... DBCHARSET overrides the terminal-specific TERMCHAR SET entry in the file "$dbroot/terminfo/term/ charsetnames" (see Section Mapping National Special Characters ).

DBTERM should be set whenever a corresponding terminal description file exists in "$dbroot/terminfo" because the terminal description files distributed with the ADABAS software are better adjusted to the ADABAS tools than those provided by the operating system.

Any environment variable set must be exported with 'export'. It is recommended to call this command in a shell or in the profile (.profile, .login, sagenv etc.).

Examples of setting DBTERM and DBHIF:

Workstation HP 9000/7? or X terminal (HP-VUE)

DBTERM=vt100_hp DBHIF=vt100_hp

HP 9000 alpha terminals (700/32) in vt100 mode

DBTERM=vt100 DBHIF=vt100

SCO-UNIX PC with ANSI terminal

DBTERM=ansi (color setting of the environment)

DBTERM=ansi-col DBTERMRESET="setcolor blue cyan"

DBTERM=ansi-col (default color setting of the tools)

DBTERM=ansi-gra (color setting of the environment

and semigraphics)

SUN

DBTERM=sqldbsun (under SunView)

DBTERM=sqldbsun DBHIF=sqldb-ow

(under OpenWindows)

NCR system 3300 or 3400

DBTERM=at386

DEC Alpha OSF/1

DBTERM=vt300

$DBROOT/README.eng	Text file containing information about the current version in English (analogously README.deu: information about the version in German)
$DBROOT/pgm	Executable programs, analysis tools, precompilers
$DBROOT/bin	User commands for the ADABAS programs
$DBROOT/env	Messages and HELP files
$DBROOT/etc/instlist	List of all files that are required for installing an operational ADABAS database
$DBROOT/etc/filelist	List of all files created while loading the distribution medium
$DBROOT/lib	Libraries for the precompilers, CALL Interface
$DBROOT/terminfo	Terminal description files
$DBROOT/incl	Precompiler include files
$DBROOT/demo/eng	Demonstration programs for the precompilers, QUERY, LOAD, and SQL with explanations in English (analogously: "$dbroot/demo/deu" with explanations in German)
$DBROOT/wrk	Default directory where the RUNDIRECTORY and BACKUPDIRECTORY will be created. The RUNDIRECTORY keeps the diagnose files; the BACKUPDIRECTORY keeps copies of the parameter files.

*cd esd/vnnn***	Changing to the directory DBROOT
bin/x_install	Call as superuser ("root"). The owner and group of the ADABAS files are requested. Owner and access rights are set for the loaded files. The service name of ADABAS (sql30) is entered into the file "/etc/services" if this name is not yet available there. "bin/x_install" must also be executed for update installations.

DBROOT=...	The environment variable DBROOT must contain the name of the path (see above).
PATH=$DBROOT/bin:$PATH	The directory "$dbroot/bin" must be integrated into the path to provide the SERVERDB with global access to the shell scripts.

SERVERDB=...	SERVERDB denotes the name of the SERVERDB.
DBTERM=...	DBTERM overrides TERM only for the ADABAS tools. The pertinent terminal description file is stored in "$dbroot/terminfo" .
DBTERMRESET=...	DBTERMRESET can contain the string for a shell command which is executed after leaving an ADABAS tool, e.g., to reset the screen colors.
DBHIF=...	DBHIF overrides the keyboard layouts of TERM or DBTERM. Own keyboard layouts can be made using "x_maketi" (see Section Using "x_maketi").
DBCHARSET=...	DBCHARSET overrides the terminal-specific TERMCHAR SET entry in the file "$dbroot/terminfo/term/ charsetnames" (see Section Mapping National Special Characters ).