Einrichten von Oracle APEX und Oracle Rest Data Services (ORDS) - Amazon Relational Database Service
Hinzufügen der Optionen APEX und APEX-DEVEntsperren des öffentlichen Benutzerkontos Konfigurieren von RESTful-ServicesVorbereiten der Installation von ORDS auf einem separaten HostEinrichten von Oracle APEX Listener

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.

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.

  2. Fügen Sie der Optionsgruppe die Optionen APEX und APEX-DEV hinzu.

  3. 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.

    2. Wählen Sie für Engine-Hauptversion die Version Ihrer DB-Instance aus.

    Weitere Informationen finden Sie unter Erstellen einer Optionsgruppe.

  2. 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.

  3. 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.

    • 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.

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.

  2. Entsperren Sie das Konto.

Zu diesem Zweck können Sie das Befehlszeilen-Dienstprogramm Oracle SQL*Plus 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. 

ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;

Konfigurieren von RESTful-Services für Oracle APEX

Um RESTful-Services in Oracle APEX zu konfigurieren (nicht für Oracle APEX 4.1.1.V1 erforderlich), verwenden Sie SQL*Plus, um als Masterbenutzer eine Verbindung mit 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.

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.

  2. 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;

  3. 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:

  4. 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.

  5. Während Sie als myapexhost.example.com bei apexuser angemeldet sind, 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.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.

  2. 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;

  3. 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:

  4. 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.

  5. 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

  2. Führen Sie folgenden Code aus.

    java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war

  3. 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

  4. 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.

  5. 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_PUBLIC_USER. 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.

    • 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.

  6. Wählen Sie Apply (Anwenden) aus. Das Oracle-APEX-Administrationsfenster wird angezeigt.

  7. Legen Sie ein Passwort für den Oracle-APEX-admin-Benutzer fest. Verwenden Sie dazu SQL*Plus, um sich mit Ihrer DB-Instance als Master-Benutzer zu verbinden, und führen Sie dann die folgenden Befehle aus.

    EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/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.

  8. 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.