> For the complete documentation index, see [llms.txt](https://docs.aqua-cloud.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aqua-cloud.io/documentation/de-documentation/installation-fur-on-premise/system-anforderungen/verbindung-zur-oracle-datenbank-12.2c.md).

# 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!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.aqua-cloud.io/documentation/de-documentation/installation-fur-on-premise/system-anforderungen/verbindung-zur-oracle-datenbank-12.2c.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
