Installation

 

System Vorbereitungen

Vor der eigentlichen Installation der CD sind einige Vorarbeiten am System zu leisten.

Linux Kernel Parameter

Da ADABAS D mit Semaphoren, Shared-Memory und Message-Queues arbeitet, ist der Kernel mit System-V IPC (/usr/src/linux/.config:CONFIG_SYSVIPC=y) zu übersetzen.

Bei pre-2.0 Kerneln ist die maximale Größe des Shared-Memory Segments auf 4MB begrenzt. Um das zu ändern ist der Wert für SHMMAX in /usr/src/linux/include/linux/shm.h auf 0x1000000 zu setzen.

Weiter Kernelparameter die evtl. notwendig sind, werden auf der ADABAS D CD in readme.pe beschrieben. Bei Kernel 2.0.30 sind i.d.R. keine Anpassungen dieser Werte nötig.

Adabas-Benutzer

Vor der Installation ist ein Benutzer anzulegen, der Eigentümer der Adabas Binaries sein soll. Außerdem sollte eine Gruppe für die Mitbenutzer des DBMS angelegt werden.

Die Namen hierfür können beliebig vergeben werden. In den folgenden Beispielen wird von einem Adabas-Eigentümer adabas und einer Gruppe dba ausgegangen.

Für die Installation sollte ein Filesystem mit mindestens 60MB freiem Speicher ausgewählt werden. Im Beispiel wird von /opt/adabas ausgegangen.

Dem Adabas-Eigentümer wird als Homedirectory /opt/adabas zugewiesen. Im Profile ist die Variable DBROOT auf /opt/adabas zu setzen.

Environment Variablen für RDBMS-Benutzer

Alle Benutzer die mit der Datenbank arbeiten sollen müssen die Variable DBROOT im Environment gesetzt haben. Um die ADABAS D Dienstprogramme ausführen zu können, sollte PATH entsprechend gesetzt sein. Am einfachsten sind hierzu in die Login-Shell-Profile Dateien im Homedirectory der Benutzer (oder global in /etc/profile) folgende Zeilen einzufügen:

...
# setup ADABAS D environment
#
DBROOT=/opt/adabas
PATH=$PATH:$DBROOT/bin
export DBROOT PATH
...

RDBMS-Installation

Für die Installation von ADABAS D sind teilweise Root-Rechte nötig. Auf der CD ist eine Beispieldatenbank MYDB enthalten.

1. mit der Login-Id des Adabas Eigentümers adabas einloggen
2. ADABAS D CD mounten (z.B. via # mount -t iso9660 /dev/scd0 /cdrom)
3. um das Installationsprogramm auf der CD benutzen zu können muß, X11 laufen und die DISPLAY Variable entsprechend gesetzt sein
   1. Installprogramm starten: cd /cdrom; ./install
   2. je nachdem was installiert werden soll, sind die entsprechenden CheckBoxes anzuklicken (normalerweise: ,,database software'' und ,,preconfigured database MYDB'')
   3. Schritt 1 ausführen (,,Choose the mount point...''') und in dem Popup-Dialog den Pfad angeben unter dem die CD gemounted ist (/cdrom)
   4. Schritt 2 ausführen (,,Choose DBROOT...''). Da DBROOT bereits im Environment gesetzt ist sollte in dem Popup-Dialog bereits /opt/adabas gesetzt sein
   5. Schritt 3 ausführen (,,Extract the Archive...''). Es erscheint ein Popup-Window, das den Fortschritt der Installation anzeigt.
   6. Schritt 4 ausführen (,,Call x_install...'') In diesem Schritt werden die File Attribute der Installation entsprechend gesetzt. Hierfür sind Root-Rechte notwendig. Das Install-Programm öffnet einen XTerm in dem das Root-Password eingegeben werden muß.

      Bei der Frage ,,Ownership of ... user name: '' ist adabas, bei der ,,... group name: '' dba anzugeben.

   7. Install-Programm über das Menü oder F3 beenden.

   Alternativ kann auch ohne Install Programm via tar(1) installiert werden. Dazu ist kein X11 erforderlich:

   $ cd $DBROOT
   /opt/adabas$ tar zxovf /cdrom/adad6115.tgz
   ...
   /opt/adabas$ tar zxovf /cdrom/mydb.tgz
   ...
   /opt/adabas$ su - root -c "cd $DBROOT && ./bin/x_install"

4. die Release-Notes in $DBROOT/README.* lesen

Die Datenbank-Software ist jetzt in $DBROOT installiert. Die Beispieldatenbank MYDB befindet sich unter $DBROOT/wrk/MYDB/.

Vorkonfigurierte Benutzer in der Datenbank MYDB

In der Datenbank MYDB existieren hauptsächlich folgende vorkonfigurierte User:

DBA

Der einzige Benutzer, der andere Benutzer mit DBA-Rechte anlegen darf, ist als superdba, Passwort admin angelegt.

Control User

Der Benutzer, der die Administrationstools xcontrol, x_param, x_util und panel aufrufen kann, ist als control, Passwort control angelegt.

Startup und Shutdown der Datenbank

Ein DB Startup/Shutdown Aktion kann nur vom Control-User (s.o.) bei MYDB control, Passwort control durchgeführt werden.

Um das Datenbanksystem benutzen zu können, muß es hochgefahren werden. Das Hochfahren besteht aus zwei Schritten:

1. Starten der Datenbank (cold). Es werden eine Anzahl von Serverprozessen und Datenbank-Dämonen gestartet. Nach dem Starten der Datenbank befindet sich diese im cold Zustand.
2. Öffnen der Datenbank (warm) - die Datenbankdateien werden zum Schreiben/Lesen geöffnet

Vor dem Herunterfahren des Rechners muß die Datenbank heruntergefahren werden:

1. Shutdown (cold) - die Datenbank wird geschlossen. Bei interaktivem Shutdown (via panel oder xcontrol wird abgefragt, ob alle aktuellen Transaktionen (d.h. noch angemeldete Benutzer) abgebrochen werden sollen. Anderenfalls wird auf das Beenden der Transaktionen gewartet.
2. Shutdown (offline) - die Datenbankserverprozesse werden angehalten.

Zum Starten, Stoppen gibt es mehrer Möglichkeiten. Auf die wichtigsten wird im Folgendem kurz eingegangen:

Startup/Shutdown via panel (X11)

Das TCL/Tk Programm panel erlaubt ein Startup/Shutdown via X11 GUI. Eine Dokumentation zu panel konnte ich in der HTML Dokumentation auf der CD leider nicht finden.

Schritte zum Startup:

1. Start:

   $ panel &

2. Eingabe: Username control, Password control - panel sollte jetzt die Datenbank hochfahren, den Erfolg kann man am Leuchten des grünen Ampellichtes erkennen.

Schritte zum Shutdown:

1. s.o.
2. s.o.
3. Linke Maus-Taste im Panel Window drücken und Menü-Eintrag offline auswählen Nach dem Herunterfahren sollte das rote Ampellicht leuchten.

Startup/Shutdown via xcontrol

Das Programm xcontrol dient zur Administration der Datenbank über ein character-basierendes User-Interface. Zum Starten in einem XTerm siehe 7.1.

Schritte zum Startup/Shutdown:

1. Start:

   $ xcontrol -u "control,control" -D MYDB

   (Die Parameter können auch in einem Dialog beim Programmstart eingegeben werden.)
2. zum Startup den Menüpunkt Operating:Restart:Warm, zum Shutdown Operating:Shutdown:Offline auswählen

automatisches Startup/Shutdown bei System Start/Stop

Das interaktive Startup/Shutdown, wie oben beschrieben, ist bei einem Datenbankserver, der täglich hoch- und runtergefahren wird nicht sehr komfortabel. Bei System-V basierendem init(8) Setup (z.B. Debian) kann folgendes Script zum automatischem Shutdown/Startup eingesetzt werden:

# start/stop ADABAS D RDBMS Server
#
# ****
# WARNING: this script is a potential security hole because DBA control
# userid/passwd is stored here in plain text, the script should be readable
# only for root
# ****
#
# set -x

# DB database name
#
DB=MYDB

case $1 in
start)
        su - adabas -c "x_start $DB && xutil -d $DB -u control,control restart"
        ;;
stop)
        su - adabas -c "xutil -d $DB -u control,control shutdown && x_stop $DB"
        ;;
*)
        echo "Usage: $0 start|stop" >&2
esac

Das Script sollte als /etc/init.d/adabas installiert werden und nach /etc/rc2.d/S90adabas und /etc/rc0.d/K20adabas gelinkt werden.