View source for MAXDB (7.6)

<translate>
<!--T:1-->
<-- zurück zur '''[[Hauptseite|Hauptseite]]'''
----

== Datenbank-Server == <!--T:2-->

<!--T:3-->
Die Installation der Datenbank erfolgt am einfachsten mit Hilfe der rpm Pakete, die über die SAP MAXDB Seite bezogen werden können.
Es werden die folgenden Pakete für x86 Linux benötigt:
<ul><li>Release independent
<li>Server
<li>ODBC
<li>Webtools oder Windows Clients
</ul>
Die Pakete werden am besten in ein gemeinsames Verzeichnis abgelegt und können dann mit dem folgenden Befehl
<br />'''rpm –i *.rpm'''
installiert werden. 

<!--T:4-->
Danach kann der Datenbank-Server mit dem Befehl
<br />'''/etc/init.d/maxdb76 start'''
<br />gestartet werden.

 <!--T:5-->
''Hinweis'':
 Bei einem erfolgreichen Start erscheint folgende Meldung:
 „starting MaxDB services: [root@localhost db]“

<!--T:6-->
Der ODBC Treiber wurde unter:
<br />'''/opt/sdb/interfaces/odbc'''
<br />installiert und wird von PHP beim späteren Kompilieren benötigt.

<!--T:7-->
Ansonsten kann man auch die Webtools installieren und per Browser neue Datenbanken anlegen und administrieren. Im LIMBAS Paket ist auch ein Shell-Script vorhanden, welches eine Demo-Datenbank installiert. 

<!--T:8-->
Falls man über einen zusätzlichen Windowsclient im Netzwerk verfügt, sollte man die MaxDB Clients für Windows installieren, um die Datenbank verwalten zu können.

<!--T:9-->
Die MaxDB erwartet einen voll qualifizierten Rechnernamen. Das bedeutet, man sollte sicherstellen, dass in der
<br />'''/etc/hosts 
<br />die IP-Adresse des Rechners aufgelöst werden kann.

 <!--T:10-->
Auszug aus ''/etc/hosts'': 
 127.0.0.1	       localhost
 192.168.10.11         openlimbas.home.net

== DB-Instance == <!--T:11-->

<!--T:12-->
Um LIMBAS nutzen zu können, benötigen wir eine Datenbank-Instanz. Diese Instanz kann man auf unterschiedliche Art und Weise erzeugen. In der Anzahl der Instanzen ist „nur“ die Hardware ausschlaggebend.  

<!--T:13-->
Die folgenden Beispiele erstellen eine LIMBAS Instanz auf unterschiedlicher Art und Weise

<!--T:14-->
* erstellt eine Instanz mit Hilfe eines mitgelieferten Skripts
* erstellt eine Instanz per Windows-Client 

<!--T:15-->
Alternativ kann auch der Webclient der Datenbank genutzt werden. Seine Benutzung wird hier nicht dokumentiert, ist aber der Windows-Client-Installation sehr ähnlich. 


=== Mitgeliefertes Skript: create_db.sh === <!--T:16-->

<!--T:17-->
Das angepasste Shell-Script findet man unter:
<br />'''openlimbas/limbas_src/help/demo_configuration_scripts/create_db.sh'''
<br />
Mit seiner Hilfe ist es möglich, auf einfachste Weise eine Datenbank-Instanz zu erstellen ohne die Grundkenntnisse der Client-Installation kennen zu müssen. 
Bei der rpm Installation der MaxDB wurde ein Benutzer namens „sdb“ erstellt. Unter seiner Kennung laufen die installierten Instanzen. Initial hat dieser Anwender noch keine Shell, diese wird jedoch im Folgenden benötigt. Mit dem folgenden Befehl lässt sich dieses schnell unter root ändern:
<br />'''usermod –s /bin/bash sdb'''
<br />
Folgende Schritte müssen nun unternommen werden:
<ul>
<li>Den Datenbankserver starten (als root):
<br />'''/etc/init.d/maxdb76 start'''
<li>Shell anlegen für den User “sdb”:
<br />'''usermod –s /bin/bash sdb'''
<li>Als User sdb anmelden:
<br />'''su – sdb'''
<li>Das Skript unter openlimbas/limbas_src/help/demo_configuration_scripts aufrufen:
<br />'''create_db.sh --create LIMBAS 192.168.10.11 LIMBASUSER LIMBASPASS DBCONTROL CONTROLPASS DBA DBAPASS /opt/sdb   /var/opt/sdb 7600'''
</ul>

 <!--T:18-->
Hinweis / Erläuterung:
<table border="1" cellspacing="0" cellpadding="2">
<tr><td>LIMBAS</td><td>Datenbank Name</td></tr>
<tr><td>192.168.10.11</td><td>Server IP</td></tr>
<tr><td>LIMBASUSER</td><td>Demo LIMBAS User</td></tr>
<tr><td>LIMBASPASS</td><td>Demo LIMBAS Passwort</td></tr>
<tr><td>DBCONTROL</td><td>Datenbank Manager Operator</td></tr>
<tr><td>CONTROLPASS</td><td>Datenbank Manager Operator Passwort</td></tr>
<tr><td>DBA</td><td>Datenbank System Administrator</td></tr>
<tr><td>DBAPASS</td><td>Datenbank System Administrator Passwort</td></tr>
<tr><td>/opt/sdb</td><td>Absoluter Installationspfad von MaxDB, beinhaltet die Verzeichnisse 7600 und Programme</td></tr>
<tr><td>/var/opt/sdb</td><td>Absoluter Instanz-Pfad von MaxDB, beinhaltet das Verzeichnis data</td></tr>
<tr><td>7600</td><td>MaxDB Version</td></tr>
</table>

<!--T:19-->
Nach erfolgreicher Installation wird eine Zusammenfassung ausgegeben. Zusätzlich wurde ein Demo User angelegt, mit dem man sich in LIMBAS anmelden kann.
<br />--> LIMBASUSER,LIMBASPASS


=== Windows-Clients === <!--T:20-->

<!--T:21-->
Eine etwas individuellere Installation kann man mit Hilfe der Grafischen Clients erzeugen, jedoch sollte in diesem Fall die Windows-Firewall ausgeschaltet oder die Ports TCP 17200 und TCP 17210 freigeschaltet werden.
Es können die Windows-Clients (welche hier beschrieben werden) oder Web-Clients (per Browser) benutzt werden. Die Windows-Clients sind wesentlich komfortabler als die Web-Clients und bieten zusätzliche Möglichkeiten.

<!--T:22-->
Für Windows müssen 3 zusätzliche Client Pakete installiert werden:
* DBMGUI
* SQL Studio
* ODBC Driver
Nach der Installation muss zuerst der Windows ODBC Treiber eingerichtet werden.

 <!--T:23-->
--> Systemeinstellungen --> Verwaltung --> Datenquellen (ODBC) --> SystemDSN
 --> Hinzufügen --> Auswahl von Mysql/MaxDB Datenquelle

<!--T:24-->
Die Einstellungen in der neu hinzugefügten Datenquelle sind:
* Data SourceName (beliebiger Name)
* Server (IP Adresse der Linux-Servers, hier 192.168.10.11)
* Database (Datenbank Name, hier LIMBAS)

<!--T:25-->
Falls die '''MaxDB''' auf einer '''OpenSuse/CentOS''' installiert wurde, muss das '''Passwort''' des folgenden '''sdb''' Benutzer unbedingt mit '''md5''' verschlüsselt werden. 

<!--T:26-->
Jetzt können wir eine neue Datenbank-Instanz erstellen. Dazu starten wir den Database Manager (DBMGUI) und dann den „Instance Wizard“ (Create). 

<!--T:27-->
* Select Template: Blank 
* Database Instanz Name
** Database Server: (Linux IP Adresse) 192.168.10.11
** Database name: LIMBAS
** Logon Name: sdb (wurde vom MAXDB rpm Paket angelegt)
** Password: pass (muss noch angepasst oder geändert werden: '''passwd sdb --> pass''')
* Authorisation: Database Manager Operator
Mit diesem User muss man sich später beim DBMGUI (dieses Programm) anmelden. Dieser User kann die Datenbank löschen, Parameter ändern oder Backups generieren ABER keine Tabellen erstellen.
** User Name: DBCONTROL (Frei wählbarer Datenbank Controluser)
** Password: CONTROLPASS (Frei wählbares Passwort)
* Parameter Initialisation: default values
* Instance Type: OLTP
* Adjust Parameters: Können unverändert bleiben
Volumes:
** neues Data Volume erstellen mit 40000 Pages (312 MB)
** neues Log Volume erstellen mit 20000 Pages (156 MB)
* Backup Medium: optional
* Creation Mode : Create and start instance
Database System Administrator
Dieser User verwaltet die Systemtabellen oder erstellt weitere User 
** User Name: DBA (Frei wählbarer Datenbank Management User)
** Password: DBAPASS (Frei wählbares Passwort)
* START

<!--T:28-->
Nach erfolgreicher Installation bietet es sich noch an den Log-Modus auf „Überschreibbar“ zu ändern. Damit muss nicht auf ein Überfüllen des LogVolumes geachtet werden. Natürlich ist für ein produktives System davon abzuraten und jeder kann die Datenbank mit dem eigenen Konzept anlegen. 

<!--T:29-->
--> Configuration --> Log Settings --> Overwrite Mode for Log Area --> Next

<!--T:30-->
Die MaxDB Datenbank ist eine Enterprise Datenbank. Diese ist nur so gut, wie der Administrator sie eingerichtet bzw. gepflegt hat. Für Produktiveinsätze sollte man sich mit den Eigenheiten und Tuningmöglichkeiten sowie Backup oder Mirror Instanzen vertraut machen.

<!--T:31-->
Der letzte Schritt in Sachen Datenbank ist das Anlegen eines LIMBAS-Users. Dazu starten wir den SQL Client (SQL Studio) und verbinden uns mit der gerade erstellten Datenbank. 

<!--T:32-->
* Server (Linux IP Adresse) z.B. 192.168.10.11
* Database (Datenbank Name) z.B. LIMBAS
* User (DBA) in unserem Beispiel „DBA“
* Pass (DBAPASS) in unserem Beispiel „DBAPASS“

<!--T:33-->
In den nun erscheinenden SQL Dialog geben wir das SQL Statement zum Erstellen eines neuen DBA Users an.

<!--T:34-->
* '''CREATE USER LIMBASUSER PASSWORD LIMBASPASS DBA NOT EXCLUSIVE'''

<!--T:35-->
So das war’s. Mit dem gerade erstellten User LIMBASUSER wird sich LIMBAS später bei der Datenbank anmelden können.


===benötigte Funktionen erstellen=== <!--T:36-->
Limbas benötigt eine definierte Funktion die von Triggern ausgeführt werden kann.
Sie behandelt die angezeigten Werte bei hinzufügen oder entfernen von Verknüpfungen.


 <!--T:37-->
<nowiki>create dbproc LIMBASUSER.lmb_vkn(in id fixed(16),in vid fixed(16), in tabname char(60), in fieldname char(30), in act char(1) , in rtabname char(60), in rfieldname char(30)) as</nowiki>
 <nowiki>VAR statement1 char(100); statement2 char(100);</nowiki>
 
 Begin
 Try
 
 <nowiki>SET statement1 = 'update ' || tabname || ' set ' || fieldname || ' = ' || fieldname || ' ' || act || ' 1 where id = ' || id;</nowiki>
 <nowiki>EXECUTE statement1;</nowiki>
 
 <nowiki>SET statement2 = '';</nowiki>
 
 <nowiki>IF rtabname <> '' THEN</nowiki>
 <nowiki>SET statement2 = 'update ' || rtabname || ' set ' || rfieldname || ' = ' || rfieldname || ' ' || act || ' 1 where id = ' || vid;</nowiki>
 <nowiki>IF statement2 <> '' THEN</nowiki>
 <nowiki>EXECUTE statement2;</nowiki>
 
 
 <nowiki>Catch</nowiki>
 <nowiki>      Stop($RC, $ERRMSG);</nowiki>
 <nowiki>End;</nowiki>

=== Nützliche Datenbank Befehle === <!--T:38-->

<!--T:39-->
Folgende Datenbank-Befehle können hilfreich sein. Dazu wechselt man in das Verzeichnis:
 /opt/sdb/programs/bin
<br />Datenbank starten:
 dbmcli –d LIMBAS –u DBCONTROL,CONTROLPASS db_warm
<br />Datenbank stoppen:
 dbmcli –d LIMBAS –u DBCONTROL,CONTROLPASS db_offline
<br />Datenbank löschen:
 dbmcli –d LIMBAS –u DBCONTROL,CONTROLPASS db_offline
 dbmcli –d LIMBAS –u DBCONTROL,CONTROLPASS db_drop
<br />Datenbank zurücksetzen:
 dbmcli –d LIMBAS –u DBCONTROL,CONTROLPASS db_clear
<br />Datenbank - Log löschen, falls es unglücklicherweise voll ist und die Datenbank sich deshalb nicht mehr starten last:
 dbmcli –d LIMBAS –uUTL –u DBCONTROL,CONTROLPASS
 util_execute clear log
<br />Diese Befehle sind für die einzelnen Datenbank-Instanzen gültig. Den Datenbankserver, der für alle Instanzen eine Art übergeordneter Prozess darstellt, kann folgend gestartet / gestoppt werden:
 /etc/init.d/maxdb76 start
 /etc/init.d/maxdb76 stop
</translate>