Oracle APEX und Oracle Rest Data Services (ORDS) einrichten - Amazon Relational Database Service
Hinzufügen der Optionen APEX und APEX-DEVEntsperren des öffentlichen Benutzerkontos Dienste konfigurieren RESTful Vorbereitung 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.

Oracle APEX und Oracle Rest Data Services (ORDS) einrichten

Im folgenden Thema sind die Schritte aufgeführt, die für die Einrichtung von Oracle APEX und ORDS erforderlich sind

Hinzufügen der APEX- und APEX-DEV-Optionen zu Ihrer DB-Instance

Gehen Sie wie folgt vor, um die APEX-DEV Optionen APEX und zu Ihrer RDS for Oracle DB-Instance 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 die Optionsgruppe Ihrer DB-Instance zu.

Wenn Sie die APEX-DEV Optionen APEX und und hinzufügen, kommt es zu einem kurzen Ausfall, während Ihre DB-Instance automatisch neu gestartet wird.

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.

Um die APEX- und APEX-DEV-Optionen zu einer DB-Instance hinzuzufügen

  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 APEX-DEV Optionen APEX und werden in allen Editionen unterstützt.

    2. Wählen Sie für Major Engine Version (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 die APEX-DEV Optionen APEX und hinzu.

    Wählen Sie unter Version die Version von Oracle APEX aus, die Sie verwenden möchten.

    Wichtig

    Wenn Sie die APEX-DEV Optionen APEX oder zu einer vorhandenen Optionsgruppe hinzufügen, die bereits mit einer oder mehreren DB-Instances verknüpft ist, kommt es zu einem kurzen Ausfall. 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 APEX-DEV Optionen APEX oder zu einer vorhandenen DB-Instance hinzufügen, kommt es zu einem kurzen Ausfall, während Ihre DB-Instance automatisch neu gestartet wird. Weitere Informationen finden Sie unter Ändern einer Amazon RDS DB-Instance.

Entsperren des öffentlichen Benutzerkontos auf Ihrer DB-Instance

Nachdem Sie die APEX-DEV Optionen APEX oder die Optionen Ihrer DB-Instance installiert haben, stellen Sie sicher, dass Sie wie folgt vorgehen:

  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;

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*Plus, 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.

EXEC rdsadmin.rdsadmin_run_apex_rest_config('apex_listener_password', 'apex_rest_public_user_password');

Vorbereitung der Installation von ORDS auf einem separaten Host

Installieren Sie ORDS auf einem separaten Host, z. B. einer EC2 Amazon-Instance, einem lokalen Server in Ihrem Unternehmen oder Ihrem Desktop-Computer. Bei den Beispielen in diesem Abschnitt wird davon ausgegangen, dass Ihr Host Linux ausführt und benannt myapexhost.example.com ist.

Bevor Sie ORDS installieren können, müssen Sie einen Betriebssystembenutzer ohne Zugriffsrechte erstellen und dann die Oracle 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 an myapexhost.example.com als apexuser und laden Sie die Oracle APEX-Installationsdatei von Oracle in Ihr Verzeichnis herunter: /home/apexuser

  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 noch angemeldet myapexhost.example.com sindapexuser, 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 for Oracle unterstützt weiterhin Oracle APEX Version 4.1.1 und Oracle APEX Listener Version 1.1.4. Es wird empfohlen, die neuesten unterstützten Versionen von Oracle APEX und ORDS zu verwenden.

Installieren Sie Oracle APEX Listener auf einem separaten Host, z. B. einer EC2 Amazon-Instance, einem lokalen Server in Ihrem Unternehmen oder Ihrem Desktop-Computer. 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 Oracle 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 an myapexhost.example.com als apexuser und laden Sie die Oracle APEX-Installationsdatei von Oracle in Ihr Verzeichnis herunter: /home/apexuser

  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 apex.war Datei 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 in Ihrem Webbrowser die URL auf, die vom Oracle APEX Listener-Programm bereitgestellt wird. 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. Dieses Passwort haben Sie zuvor bei der Konfiguration des Oracle APEX-Repositorys angegeben. 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-Benutzer admin 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 in Ihrem Browser zum Oracle APEX-Administrationsfenster zurück und wählen Sie Administration. 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.