Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Einrichten von Oracle APEX und Oracle Rest Data Services (ORDS)
Das folgende Thema listet die Schritte auf, die für die Einrichtung von Oracle APEX und ORDS erforderlich sind.
**Topics**
+ [Hinzufügen der Optionen APEX und APEX-DEV zu Ihrer DB-Instance](#Appendix.Oracle.Options.APEX.Add)
+ [Entsperren des öffentlichen Benutzerkontos auf Ihrer DB-Instance](#Appendix.Oracle.Options.APEX.PublicUser)
+ [RESTful Dienste für Oracle APEX konfigurieren](#Appendix.Oracle.Options.APEX.ConfigureRESTful)
+ [Vorbereiten der Installation von ORDS auf einem separaten Host](#Appendix.Oracle.Options.APEX.ORDS.ords-setup)
+ [Einrichten von Oracle APEX Listener](#Appendix.Oracle.Options.APEX.Listener)
## Hinzufügen der Optionen APEX und APEX-DEV zu Ihrer DB-Instance
Gehen Sie wie folgt vor, um Ihrer DB-Instance von RDS für Oracle die Optionen `APEX` und `APEX-DEV` hinzuzufügen:
1. Erstellen Sie eine neue Optionsgruppe oder kopieren oder ändern Sie eine bestehende Optionsgruppe.
1. Fügen Sie der Optionsgruppe die Optionen `APEX` und `APEX-DEV` hinzu.
1. Ordnen Sie der DB-Instance die Optionsgruppe zu.
Wenn Sie die Optionen `APEX` und `APEX-DEV` hinzufügen, kommt es während des automatischen Neustarts der DB-Instance zu einem kurzen Nutzungsausfall.
**Anmerkung**
`APEX_MAIL` ist verfügbar, wenn die Option `APEX` installiert ist. Das Ausführungsrecht für das `APEX_MAIL`-Paket wird `PUBLIC` gewährt. Sie benötigen also kein APEX-Administratorkonto, um es verwenden zu können.
**So fügen Sie einer DB-Instance die Optionen APEX und APEX-DEV hinzu**
1. Bestimmen Sie die Optionsgruppe, die Sie verwenden möchten. Sie können eine Optionsgruppe erstellen oder eine bestehende Optionsgruppe verwenden. Wenn Sie eine bestehende Optionsgruppe verwenden möchten, fahren Sie mit dem nächsten Schritt fort. Erstellen Sie andernfalls eine benutzerdefinierte DB-Optionsgruppe mit folgenden Einstellungen:
1. Wählen Sie im Feld **Engine** die Oracle-Edition aus, die Sie verwenden möchten. Die Optionen `APEX` und `APEX-DEV` werden in allen Editionen unterstützt.
1. Wählen Sie für **Engine-Hauptversion** die Version Ihrer DB-Instance aus.
Weitere Informationen finden Sie unter [Erstellen einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create).
1. Fügen Sie der Optionsgruppe die Optionen hinzu. Wenn Sie nur die Oracle APEX-Laufzeitumgebung bereitstellen möchten, fügen Sie nur die `APEX`-Option hinzu. Um die vollständige Entwicklungsumgebung bereitzustellen, fügen Sie sowohl die Option `APEX` als auch die Option `APEX-DEV` hinzu.
Wählen Sie für **Version** die Version von Oracle APEX aus, die Sie verwenden möchten.
**Wichtig**
Wenn Sie einer vorhandenen Optionsgruppe, die bereits an eine oder mehrere DB-Instances angehängt ist, die Option `APEX` oder `APEX-DEV` hinzufügen, entsteht ein kurzer Nutzungsausfall. Während dieses Ausfalls werden alle DB-Instances automatisch neu gestartet.
Weitere Informationen über das Hinzufügen von Optionen finden Sie unter [Hinzufügen einer Option zu einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption).
1. Ordnen Sie die Optionsgruppe einer neuen oder bestehenden DB-Instance zu:
+ Einer neuen DB-Instance wird die Optionsgruppe beim Starten der Instance zugewiesen. Weitere Informationen finden Sie unter [Erstellen einer Amazon-RDS-DB-Instance](USER_CreateDBInstance.md).
+ Bei einer bestehenden DB-Instance weisen Sie die Optionsgruppe zu, indem Sie die Instance ändern und die neue Optionsgruppe anhängen. Wenn Sie die Option `APEX` oder `APEX-DEV` einer vorhandenen DB-Instance hinzufügen, kommt es während des automatischen Neustarts der DB-Instance zu einem kurzen Nutzungsausfall. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
## Entsperren des öffentlichen Benutzerkontos auf Ihrer DB-Instance
Stellen Sie nach der Installation der Option `APEX` oder `APEX-DEV` für Ihre DB-Instance sicher, dass Sie die folgenden Schritte ausführen:
1. Ändern Sie das Passwort für das `APEX_PUBLIC_USER`-Konto.
1. Entsperren Sie das Konto.
Zu diesem Zweck können Sie das Befehlszeilen-Dienstprogramm Oracle SQL\$1Plus verwenden. Stellen Sie als Master-Benutzer eine Verbindung zur DB-Instance her und rufen Sie die folgenden Befehle auf. Ersetzen Sie `new_password` durch ein Passwort Ihrer Wahl.
```
1. ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
2. ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;
```
## RESTful Dienste für Oracle APEX konfigurieren
Um RESTful Dienste in Oracle APEX zu konfigurieren (für Oracle APEX 4.1.1.V1 nicht erforderlich), verwenden Sie SQL\$1Plus, um als Master-Benutzer eine Verbindung zu Ihrer DB-Instance herzustellen. Führen Sie anschließend die gespeicherte Prozedur `rdsadmin.rdsadmin_run_apex_rest_config` aus. Beim Ausführen der gespeicherten Prozedur geben Sie Passwörter für die folgenden Benutzer an:
+ `APEX_LISTENER`
+ `APEX_REST_PUBLIC_USER`
Die gespeicherte Prozedur führt das `apex_rest_config.sql`-Skript aus, mit dem neue Datenbankkonten für diese Benutzer erstellt werden.
**Anmerkung**
Für Oracle APEX Version 4.1.1.v1 ist keine Konfiguration erforderlich. Für diese Oracle APEX-Version müssen Sie die gespeicherte Prozedur nicht ausführen.
Der folgende Befehl führt die gespeicherte Prozedur aus.
```
1. EXEC rdsadmin.rdsadmin_run_apex_rest_config('apex_listener_password', 'apex_rest_public_user_password');
```
## Vorbereiten der Installation von ORDS auf einem separaten Host
Installieren Sie ORDS auf einem separaten Host wie beispielsweise einer Amazon-EC2-Instance, auf einem lokalen Server in Ihrem Unternehmen oder auf Ihrem Desktopcomputer. Bei den Beispielen in diesem Abschnitt wird davon ausgegangen, dass auf Ihrem Host Linux ausgeführt wird und sein Name `myapexhost.example.com` lautet.
Bevor Sie ORDS installieren können, müssen Sie einen nicht privilegierten Betriebssystembenutzer erstellen und dann die APEX-Installationsdatei herunterladen und entpacken.
**So bereiten Sie die ORDS-Installation vor:**
1. Melden Sie sich bei `myapexhost.example.com` als `root` an.
1. Erstellen Sie einen Betriebssystembenutzer ohne administrative Rechte für die Listener-Installation. Mit dem folgenden Befehl wird ein neuer Benutzer mit dem Namen *apexuser* erstellt:
```
useradd -d /home/apexuser apexuser
```
Der folgende Befehl weist dem neuen Benutzer ein Passwort zu.
```
passwd apexuser;
```
1. Melden Sie sich bei `myapexhost.example.com` als `apexuser` an und laden Sie die Installationsdatei für Oracle APEX von Oracle in Ihr `/home/apexuser`-Verzeichnis herunter:
+ [http://www.oracle. com/technetwork/developer-tools/apex/downloads/index](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html).html
+ [Frühere Veröffentlichungsarchive von Oracle Application Express](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html)
1. Entpacken Sie die Datei im `/home/apexuser`-Verzeichnis.
```
unzip apex_version.zip
```
Nachdem Sie die Datei entpackt haben, ist ein `apex`-Verzeichnis im `/home/apexuser`-Verzeichnis vorhanden.
1. Während Sie noch angemeldet `myapexhost.example.com` sind`apexuser`, laden Sie die Oracle REST Data Services-Datei von Oracle in Ihr `/home/apexuser` Verzeichnis herunter: [http://www.oracle. com/technetwork/developer-tools/apex-listener/downloads/index](http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html).html.
## Einrichten von Oracle APEX Listener
**Anmerkung**
Oracle APEX Listener ist veraltet.
Amazon RDS für Oracle unterstützt weiterhin die Version 4.1.1 von Oracle APEX und die Version 1.1.4 von Oracle APEX Listener. Es wird empfohlen, die neuesten unterstützten Versionen von Oracle APEX und ORDS zu verwenden.
Sie müssen Oracle APEX Listener auf einem separaten Host wie einer Amazon EC2-Instance, einem lokalen Server im Unternehmen oder Ihrem Desktopcomputer installieren. Wir unterstellen `myapexhost.example.com` als Namen des Hosts, auf dem außerdem Linux ausgeführt wird.
### Vorbereiten der Installation von Oracle APEX Listener
Bevor Sie Oracle APEX Listener installieren können, müssen Sie einen nicht privilegierten Betriebssystembenutzer erstellen und dann die APEX-Installationsdatei herunterladen und entpacken.
**So bereiten Sie die Installation von Oracle APEX Listener vor:**
1. Melden Sie sich bei `myapexhost.example.com` als `root` an.
1. Erstellen Sie einen Betriebssystembenutzer ohne administrative Rechte für die Listener-Installation. Mit dem folgenden Befehl wird ein neuer Benutzer mit dem Namen *apexuser* erstellt:
```
useradd -d /home/apexuser apexuser
```
Der folgende Befehl weist dem neuen Benutzer ein Passwort zu.
```
passwd apexuser;
```
1. Melden Sie sich bei `myapexhost.example.com` als `apexuser` an und laden Sie die Installationsdatei für Oracle APEX von Oracle in Ihr `/home/apexuser`-Verzeichnis herunter:
+ [http://www.oracle. com/technetwork/developer-tools/apex/downloads/index](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html).html
+ [Frühere Veröffentlichungsarchive von Oracle Application Express](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html)
1. Entpacken Sie die Datei im `/home/apexuser`-Verzeichnis.
```
unzip apex_.zip
```
Nachdem Sie die Datei entpackt haben, ist ein `apex`-Verzeichnis im `/home/apexuser`-Verzeichnis vorhanden.
1. Wenn Sie bei `myapexhost.example.com` noch als `apexuser` angemeldet sind, laden Sie die APEX Listener-Datei von Oracle in Ihr `/home/apexuser`-Verzeichnis herunter:
#### Installieren und Konfigurieren von Oracle APEX Listener
Bevor Sie Oracle APEX verwenden können, müssen Sie die Datei `apex.war` herunterladen, Oracle APEX Listener mit Java installieren und dann den Listener starten.
**So installieren und konfigurieren Sie Oracle APEX Listener:**
1. Erstellen Sie ein neues Verzeichnis basierend auf Oracle APEX Listener und öffnen Sie die Listener-Datei.
Führen Sie folgenden Code aus:
```
mkdir /home/apexuser/apexlistener
cd /home/apexuser/apexlistener
unzip ../apex_listener.version.zip
```
1. Führen Sie folgenden Code aus.
```
java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war
```
1. Geben Sie folgende Informationen in der Eingabeaufforderung des Programms ein:
+ Benutzername des APEX-Listener-Administrators. Der Standardwert ist *adminlistener*.
+ Passwort für den APEX-Listener-Administrator.
+ Benutzername des APEX-Listener-Managers. Der Standardwert ist *managerlistener*.
+ Passwort für den APEX-Listener-Administrator.
Das Programm gibt eine URL aus, die Sie benötigen, um die Konfiguration abzuschließen.
```
INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure
Database is not yet configured
```
1. Lassen Sie Oracle APEX Listener laufen, damit Sie Oracle Application Express verwenden können. Nachdem Sie dieses Konfigurationsverfahren abgeschlossen haben, können Sie den Listener im Hintergrund ausführen lassen.
1. Rufen Sie im Webbrowser die vom Oracle-APEX-Listener-Programm ausgegebene URL auf. Das Oracle Application Express Listener-Administrationsfenster wird angezeigt. Geben Sie die folgenden Informationen ein:
+ **Benutzername** – `APEX_PUBLIC_USER`
+ **Password**: Passwort für *APEX\$1PUBLIC\$1USER*. Dies ist das Passwort, das Sie beim Konfigurieren des Oracle-APEX-Repositorys angegeben haben. Weitere Informationen finden Sie unter [Entsperren des öffentlichen Benutzerkontos auf Ihrer DB-Instance](#Appendix.Oracle.Options.APEX.PublicUser).
+ **Connection type (Verbindungstyp)** – Basic (Einfach)
+ **Hostname**: Endpunkt der Amazon-RDS-DB-Instance, z. B. `mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com`.
+ **Port** – 1521
+ **SID**: Name der Datenbank in der Amazon-RDS-DB-Instance, z. B. `mydb`.
1. Wählen Sie **Apply (Anwenden)** aus. Das Oracle-APEX-Administrationsfenster wird angezeigt.
1. Legen Sie ein Passwort für den Oracle-APEX-`admin`-Benutzer fest. Verwenden Sie dazu SQL\$1Plus, um sich mit Ihrer DB-Instance als Master-Benutzer zu verbinden, und führen Sie dann die folgenden Befehle aus.
```
1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
2. grant APEX_ADMINISTRATOR_ROLE to master;
3. @/home/apexuser/apex/apxchpwd.sql
```
Ersetzen Sie `master` durch den Masterbenutzernamen. Wenn Sie vom Skript `apxchpwd.sql` aufgefordert werden, geben Sie ein neues `admin`-Passwort ein.
1. Kehren Sie zum Oracle APEX-Administrationsfenster im Browser zurück und wählen Sie **Administration** aus. Wählen Sie anschließend **Application Express Internal Administration**. Wenn Sie zur Eingabe von Anmeldeinformationen aufgefordert werden, geben Sie die folgenden Informationen ein:
+ **Benutzername** – `admin`
+ **Passwort**: Das mit dem Skript `apxchpwd.sql` festgelegte Passwort
Wählen Sie **Anmeldung** und legen Sie dann ein neues Passwort für den Benutzer `admin` fest.
Ihr Listener ist nun einsatzbereit.