Verbindung zur Oracle Datenbank 11g
Bevor Sie beginnen, müssen Sie Java auf Ihrem lokalen Server installieren, um später eine Verbindung zur Datenbank aufbauen zu können.
Installieren der Oracle Datenbank
Im ersten Schritt installieren Sie die Oracle Datenbank. Eine "freie" Version (mit dem Namen "Express Edition") kann hier heruntergeladen werden:
Bitte beachten Sie die folgende Einschränkung von Oracle Express Editions:
"Oracle Database XE kann auf allen Host Maschinen jeglicher Größe mit beliebig vielen CPUs (eine Datenbank pro Maschine) installiert werden, aber XE wird bis zu 11 GB Nutzerdaten speichern, bis zu 1 GB Memory und eine CPU auf der Host Maschine nutzen."
Nachdem der Download abgeschlossen ist, starten Sie bitte das Installationsprogramm. Klicken Sie auf Weiter, lesen Sie die Lizenzvereinbarungen und akzeptieren Sie. Klicken Sie wieder auf Weiter, wählen Sie den Standard-Pfad für die Installation und klicken auf Weiter. Nun geben Sie das SYS Passwort ein, klicken auf Weiter und beenden das Setup, indem Sie auf Installieren klicken.
Aufsetzen einer neuen Datenbank
Erstellen Sie eine neue Verbindung und geben anschließend die folgenden Namen ein:
Benutzername: SYSTEM
Kennwort: Ihr SYS Passwort
Hostname: localhost
SID: xe
Klicken Sie auf Anmelden, öffnen Sie die Datei CreateDatabase.sql und führen das Script aus. Dann öffnen Sie die Windows Kommandokonsole und nutzen cd um in den Ordner zu wechseln, in der sich die aqua dump Datei befindet. Dort geben Sie den folgenden Befehl ein:
imp aqua/aqua ignore=Y log=aqua_imp.log file=aqua_*.dmp
In dem Fall, dass Sie eine diff Datei erhalten haben, müssen Sie diese diff.sql ausführen, um die dump Datei auf die aktuelle aqua Version zu updaten. Sie können diese diff Datei entsprechend unser Update-Richtline anfragen.
Im nächsten Schritt erstellen Sie eine Verbindung zu Ihrem Oracle SQL Developer.
Zum Schluss müssen Sie noch die Lizenzdatei in der Datenbank konfigurieren. Dafür öffnen Sie die Lizenzdatei mit einem Text Editor (z.B. Notepad), kopieren den Wert des Tags CustomerAccount, fügen ihn in eine SQL-Anfrage ein und wenden diese in der Datenbank an.
UPDATE CUSTOMER SET ACCOUNT = '<CustomerAccount>'
Ihre aqua Datenbank ist nun installiert.
Konfiguration der Datenbankverbindung
In den folgenden Schritten verbinden Sie Ihr aqua System mit der Datenbank.
Zuerst ersetzen Sie hibernate.cfg.xml im Ordner C:\Prgroamme\andagon GmbH\ALM for IIS\Web\Webservice\bin. Dann öffnen Sie Web.config im Ordner C:\Programme\andagon GmbH\ALM for IIS\Web\Webservice mit einem Text Editor.
Ersetzen Sie die Zeile <add key="Database" value="Data Source=X;User Id=Y;Password=Z;"/> mit:
<add key="Database" value="Data Source=(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=$HOST)(PORT=$PORT)))(CONNECT_DATA=(SERVER=DEDICATED)(SID=$SID)));User Id=$USER;Password=$PASSWORD;"/>
Ersetzen Sie $HOST,$PORT,$SID,$USER und $PASSWORD mit Ihren Daten:
<add key="Database" value="Data Source=(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521)))(CONNECT_DATA=(SERVER=DEDICATED)(SID=XE)));User Id=aqua;Password=aqua;"/>
Dann konfigurieren Sie Ihre Oracle Version. Öffnen Sie den Ordner C:\app\Administrator\product\11.2.0\client_1\ODP.NET\bin\2.x, darin befindet sich die Datei Ora-ProvCfg, die Sie öffnen und die Version ermitteln. Diese Version muss in die Web.config Datei eingefügt werden.
Nun aktivieren Sie die 32-Bit-Anwendung in IIS. Öffnen Sie IIS, dann das Kontextmenü für aquaAPIPool und wählen Anwendungspool-Standardwerte festlegen aus. Hier setzen Sie 32-Bit Anwendungen aktivieren auf true.
Installation des ODP Treibers
aqua benötigt einen ODP.NET Treiber, um sich erfolgreich mit einer Oracle Datenbank zu verbinden. Dieser Treiber kann auf
heruntergeladen werden.
Stellen Sie sicher, dass Sie die richtige Version herunterladen! Entpacken Sie die Download-Dateien, öffnen dann die Kommandozeile, wechseln zum Verzeichnis des Entpackungsortes und führen folgenden Befehl aus:
install.bat odp.net2 c:\odac odac
Nun können Sie Ihren aqua Client installieren, indem Sie aqua.msi installieren und den Client starten. Die Standard-Anmeldedaten sind folgende:
Benutzername: Administrator
Passwort: default
Server: localhost
Ihr aqua System sollte einsatzbereit sein!
