# Verbindung zur Oracle Datenbank 12.2c

### **Vorbereitung** <a href="#vorbereitung" id="vorbereitung"></a>

Sie benötigen eine Oracle Datenbank. Eine "freie" Version (mit dem Namen "Express Edition") kann hier heruntergeladen werden: [LINK](https://www.oracle.com/database/technologies/appdev/xe.html)

{% hint style="info" %}
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 maximal bis zu 11 GB Nutzerdaten speichern, bis zu 1 GB Arbeitsspeicher und eine CPU auf der Host Maschine nutzen."&#x20;
{% endhint %}

### **Installieren der Oracle Datenbank** <a href="#installieren_der_oracle_datenbank" id="installieren_der_oracle_datenbank"></a>

&#x20;Im ersten Schritt installieren Sie die Oracle Datenbank. &#x20;

<figure><img src="http://aquawiki.andagon.com/de/pictures/drex_verbindung_zur_oracle_datenbank_12_2c_custom.png" alt=""><figcaption></figcaption></figure>

Nachdem der Download abgeschlossen ist, starten Sie bitte das Installationsprogramm. Klicken Sie auf Weiter, lesen Sie die Lizenzvereinbarungen und akzeptieren Sie diese. 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.&#x20;

### **Aufsetzen einer neuen Datenbank** <a href="#aufsetzen_einer_neuen_datenbank" id="aufsetzen_einer_neuen_datenbank"></a>

Mit Ihrem Installationspakt haben Sie einen Ordner mit mehreren SQL-Skripten und einem Datenbankdump erhalten. Mit diesen Dateien können Sie eine initiale Datenbank für Ihr aqua aufsetzen. Zum Aufsetzen der Datenbank benötigen Sie die Werkzeuge **sqlplus**, **sqlldr** und **imp**. Zusätzlich benötigen Sie die Zugangsdaten eines Accounts mit Administrationsrechten für die Oracle-Datenbank. Wir nehmen für den Rest der Anleitung an, dass Sie den 'system' Account verwenden. Die Datenbank, mit der sich die Werkzeuge verbinden, wird mit der folgenden Notation angegeben:&#x20;

`@//oracle-server:1521/sid`&#x20;

Bitte ersetzen Sie den Hostnamen und die sid entsprechend. Wenn Sie lokal auf dem Datenbankserver arbeiten, können Sie diesen Teil weglassen.&#x20;

Öffnen Sie ein Kommandozeilenfenster in dem Ordner mit den SQL-Skripten und dem Datenbankdump. Geben Sie den folgenden Befehl ein, um **sqlplus** zu starten:&#x20;

```sql
sqlplus system/ihrsystempasswort@//oracle-server:1521/sid 
```

Schreiben Sie die Ausgabe in eine Log-Datei. Dazu führen Sie den folgenden Befehl aus:&#x20;

`SPOOL CreateDatabase.log;`&#x20;

Führen Sie das Skript zur Konfiguration von SQLPlus aus:

`@login.sql;` &#x20;

Führen Sie das Skript zum Anlegen der Datenbank aus:&#x20;

`@CreateDatabase.sql;`&#x20;

Wenn keine Fehler aufgetreten sind, führen Sie die folgenden Befehle aus:&#x20;

`COMMIT;`\
`SPOOL OFF;`&#x20;

und schließen **sqlplus** durch die Eingabe von:&#x20;

`EXIT`&#x20;

Als nächstes importieren wir einen Dump mit der initialen Datenbank. Führen Sie den folgenden Befehl aus:&#x20;

`imp AQUA/AQUA@//oracle-server:1521/sid ignore=Y log=import.log file=aqua.dmp fromuser=AQUA touser=AQUA` &#x20;

<figure><img src="http://aquawiki.andagon.com/de/pictures/drex_verbindung_zur_oracle_datenbank_12_2c_custom_2.png" alt=""><figcaption></figcaption></figure>

<figure><img src="http://aquawiki.andagon.com/de/pictures/drex_verbindung_zur_oracle_datenbank_12_2c_custom_3.png" alt=""><figcaption></figcaption></figure>

Jetzt führen wir einige weitere SQL-Skripte aus. Starten Sie **sqlplus** mit:&#x20;

`sqlplus AQUA/AQUA@//oracle-server:1521/sid`&#x20;

Schreiben Sie die Ausgabe in eine Log-Datei. Dazu führen Sie den folgenden Befehl aus:&#x20;

`SPOOL diff.log;`&#x20;

Führen Sie das Skript zur Konfiguration von SQLPlus aus:

`@login.sql;`

Führen Sie das Diff-Skript aus:&#x20;

`@Diff-Oracle-Base-to-"target version".sql;`&#x20;

Dann führen Sie UpdateAccounts.sql und UpdateLicense.sql auf die gleiche Weise aus, wie das Diff-Skript. Wenn keine Fehler aufgetreten sind, führen Sie die folgenden Befehle aus:&#x20;

`COMMIT;`\
`SPOOL OFF;` \
\
und schließen **sqlplus** durch die Eingabe von:

\
`EXIT` \
\
Nun entpacken Sie den .zip Ordner BlobData.zip in einem Ordner Ihrer Wahl. Öffnen Sie dann das Kommandozeilenfenster und führen Sie den folgenden Befehl aus (ersetzen Sie die Parameter entsprechend):&#x20;

{% code overflow="wrap" %}

```batch
oracle-diff-loader.bat <ORACLE_USER> <ORACLE_PASSWORD> <ORACLE_INSTANCE> <WORK_PATH> <OLD_PATH> 
```

{% endcode %}

\
Wenn Sie die Standardwerte in dieser Anleitung verwenden, sieht der Befehl wie folgt aus:&#x20;

`oracle-diff-loader.bat AQUA AQUA //oracle-server:1521/sid . .` \
\
Wenn Sie lokal auf dem Datenbankserver arbeiten, sieht der Befehl wie folgt aus:&#x20;

`oracle-diff-loader.bat AQUA AQUA sid . .`&#x20;

Anschließend wenden wir das generierte SQL-Skript an. Starten Sie **sqlplus** mit:&#x20;

`sqlplus AQUA/AQUA@//oracle-server:1521/sid`&#x20;

Schreiben Sie die Ausgabe in eine Log-Datei. Dazu führen Sie den folgenden Befehl aus:&#x20;

`SPOOL blobdatasql.log;`&#x20;

Führen Sie das Skript zur Konfiguration von SQLPlus aus:

`@login.sql;`&#x20;

Führen Sie das generierte SQL-Skript aus:

`@oracle_diff-loader.sql;`&#x20;

Wenn keine Fehler aufgetreten sind, führen Sie die folgenden Befehle aus:&#x20;

`COMMIT;`\
`SPOOL OFF;`&#x20;

und schließen **sqlplus** durch die Eingabe von:&#x20;

`EXIT`&#x20;

Ihre aqua Datenbank ist jetzt installiert. &#x20;

Indessen können Sie Ihren aqua Client installieren, indem Sie **aqua.msi** installieren und den Client starten. Die Standard-Anmeldedaten sind folgende:&#x20;

| Benutzername | Administrator |
| ------------ | ------------- |
| Passwort     | AQUA          |
| Server       | localhost     |

&#x20;&#x20;

<figure><img src="http://aquawiki.andagon.com/de/pictures/drex_verbindung_zur_oracle_datenbank_12_2c_custom_4.png" alt=""><figcaption></figcaption></figure>

Ihr aqua System sollte einsatzbereit sein!