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 Application Express (APEX) Amazon RDS unterstützt Oracle Application Express (APEX) mittels Verwendung von `APEX`- und `APEX-DEV`-Optionen. Sie können Oracle APEX als Laufzeitumgebung oder als vollständige Entwicklungsumgebung für webbasierte Anwendungen bereitstellen. Mit Oracle APEX können Sie Anwendungen vollständig im Webbrowser erstellen. Weitere Informationen finden Sie unter [Oracle Application Express](https://apex.oracle.com/) in der Oracle-Dokumentation. **Topics** + [ ## Oracle APEX-Komponenten ](#Appendix.Oracle.Options.APEX.components) + [ # Anforderungen und Einschränkungen ](Appendix.Oracle.Options.APEX.Requirements.md) + [ # Einrichten von Oracle APEX und Oracle Rest Data Services (ORDS) ](Appendix.Oracle.Options.APEX.settingUp.md) + [ # Konfigurieren von Oracle Rest Data Services (ORDS) ](Appendix.Oracle.Options.APEX.ORDSConf.md) + [ # Aktualisieren und Entfernen von Oracle APEX ](Appendix.Oracle.Options.APEX.UpgradeandRemove.md) ## Oracle APEX-Komponenten Oracle APEX besteht aus den folgenden Hauptkomponenten: + *Repository* zum Speichern der Metadaten für Oracle-APEX-Anwendungen und -Komponenten. Das Repository besteht aus Tabellen, Indizes und anderen Objekten, die in Ihrer Amazon-RDS-DB-Instance installiert sind. + *Listener*, der die HTTP-Kommunikation mit Oracle APEX-Clients verwaltet. Der Listener befindet sich auf einem separaten Host wie beispielsweise einer Amazon-EC2-Instance, einem On-Premises-Server in Ihrem Unternehmen oder Ihrem Desktopcomputer. Der Listener akzeptiert eingehende Verbindungen von Webbrowsern, leitet sie zur Verarbeitung an die Amazon-RDS-DB-Instance weiter und sendet die Ergebnisse anschließend aus dem Repository an die Browser zurück. Amazon RDS für Oracle unterstützt die folgenden Listener: + Verwenden Sie für Oracle APEX Version 5.0 und höher Oracle REST Data Services (ORDS) Version 19.1 und höher. Es wird empfohlen, die neueste unterstützte Version von Oracle APEX und ORDS zu verwenden. Diese Dokumentation beschreibt ältere Versionen nur aus Gründen der Abwärtskompatibilität. + Für Oracle APEX Version 4.1.1 können Sie Oracle APEX Listener Version 1.1.4 verwenden. + Sie können Oracle HTTP Server und `mod_plsql` Listener verwenden. **Anmerkung** Amazon RDS unterstützt den Oracle XML DB HTTP-Server mit dem eingebetteten PL/SQL-Gateway nicht als Listener für Oracle APEX. Grundsätzlich rät Oracle davon ab, das eingebettete PL/SQL-Gateway für Anwendungen zu verwenden, die im Internet ausgeführt werden. Weitere Informationen zu diesen Listener-Typen finden Sie unter [Auswahl eines Web-Listeners](https://docs.oracle.com/database/apex-5.1/HTMIG/choosing-web-listener.htm#HTMIG29321) in der Oracle-Dokumentation. Wenn Sie der DB-Instance von RDS für Oracle die Optionen `APEX` und `APEX-DEV` hinzufügen, installiert Amazon RDS nur das Oracle-APEX-Repository. Installieren Sie Ihren Listener auf einem separaten Host. # Anforderungen und Einschränkungen Im folgenden Thema werden die Anforderungen und Einschränkungen für Oracle APEX und ORDS aufgeführt. ## Oracle APEX-Versionsanforderungen Die `APEX`-Option verwendet Speicher auf der DB-Instance-Klasse für Ihre DB-Instance. Nachfolgend finden Sie die unterstützten Versionen und die ungefähren Speicheranforderungen für Oracle APEX. **** | Oracle APEX-Version | Speicheranforderungen | Unterstützte Oracle-Database-Versionen | Hinweise | | --- | --- | --- | --- | | Oracle APEX Version 24.2.v1 | 114 MiB | Alle | Diese Version enthält Patch 37885097: PSE-BUNDLE FÜR APEX 24.2 (PSES ZUSÄTZLICH ZU 24.2.0), PATCH\$1VERSION 4. | | Oracle APEX Version 24.1.v1 | 112 MiB | Alle | Diese Version enthält Patch 36695709: PSE-BUNDLE FÜR APEX 24.1 (PSES ZUSÄTZLICH ZU 24.1.0), PATCH\$1VERSION 3. Wenn Sie genau dieselbe APEX-Image-Version für die Installation auf Ihrer EC2-Instance benötigen, laden Sie Patch 37544819:24.1.3 PSE BUNDLE FOR APEX 24.1 (PSES ON TOP OF 24.1.0) herunter. | | Oracle APEX Version 23.2.v1 | 110 MiB | Alle | Diese Version enthält Patch 35895964: PSE-BUNDLE FÜR APEX 23.2 (PSES ZUSÄTZLICH ZU 23.2.0), PATCH\$1VERSION 6. Wenn Sie genau dieselbe APEX-Image-Version für die Installation auf Ihrer EC2-Instance benötigen, laden Sie Patch 37593125:23.2.6 PSE BUNDLE FOR APEX 23.2 (PSES ON TOP OF 23.2.0) herunter. | | Oracle APEX-Version 23.1.v1 | 106 MiB | Alle | Diese Version enthält Patch 35283657: PSE BUNDLE FOR APEX 23.1 (PSES ON TOP OF 23.1.0), PATCH\$1VERSION 2. | | Oracle APEX Version 22.2.v1 | 106 MiB | Alle | Diese Version enthält Patch 34628174: PSE BUNDLE FOR APEX 22.2 (PSES ON TOP OF 22.2.0), PATCH\$1VERSION 4. | | Oracle APEX-Version 22.1.v1 | 124 MiB | Alle | Diese Version enthält Patch 34020981: PSE BUNDLE FOR APEX 22.1 (PSES ON TOP OF 22.1.0), PATCH\$1VERSION 6. | | Oracle-APEX-Version 21.2.v1 | 125 MiB | Alle | Diese Version enthält Patch 33420059: PSE BUNDLE FOR APEX 21.2 (PSES ON TOP OF 21.2.0), PATCH\$1VERSION 8. | | Oracle APEX-Version 21.1.v1 | 125 MiB | Alle | Diese Version enthält Patch 32598392: PSE BUNDLE FOR APEX 21.1, PATCH\$1VERSION 3. | | Oracle APEX-Version 20.2.v1 | 148 MiB | Alle außer Oracle Database 21c | Diese Version enthält Patch 32006852: PSE BUNDLE FOR APEX 20.2, PATCH\$1VERSION 2020.11.12. Sie können die Patch-Nummer und das Datum sehen, indem Sie die folgende Abfrage ausführen: 
SELECT PATCH_VERSION, PATCH_NUMBER 
FROM   APEX_PATCHES;
| | Oracle APEX-Version 20.1.v1 | 173 MiB | Alle außer Oracle Database 21c | Diese Version enthält Patch 30990551: PSE BUNDLE FOR APEX 20.1, PATCH\$1VERSION 2020.07.15. | | Oracle APEX Version 19.2.v1 | 149 MiB | Alle außer Oracle Database 21c | | | Oracle APEX Version 19.1.v1 | 148 MiB | Alle außer Oracle Database 21c | | Informationen zu APEX-ZIP-Dateien zum Herunterladen finden Sie unter [Oracle APEX – Prior Release Archives](https://www.oracle.com/tools/downloads/apex-all-archives-downloads.html) auf der Oracle-Website. ## Voraussetzungen für Oracle APEX und ORDS Beachten Sie die folgenden Voraussetzungen für die Verwendung von Oracle APEX und ORDS: + Ihr System muss die Java-Laufzeitumgebung (JRE) verwenden. + Ihre Oracle-Client-Installation muss Folgendes beinhalten: + SQL\$1Plus oder SQL Developer für Administrationsaufgaben + Oracle Net Services zum Konfigurieren von Verbindungen zu Ihrer DB-Instance von RDS für Oracle ## Beschränkungen für Oracle APEX Sie können das das von Amazon RDS verwaltete `APEX_version`-Benutzerkonto nicht ändern. Daher können Sie für diesen Benutzer keine Datenbankprofile anwenden oder Kennwortregeln durchsetzen. Die Profile und Passworteinstellungen für `APEX_version` sind von Oracle vordefiniert AWS und so konzipiert, dass sie die Sicherheitsanforderungen für Amazon RDS erfüllen. # 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. # Konfigurieren von Oracle Rest Data Services (ORDS) Das folgende Thema listet die Konfigurationsoptionen für ORDS 21 und 22 auf: **Topics** + [ ## Installieren und Konfigurieren von ORDS 21 und niedriger ](#Appendix.Oracle.Options.APEX.ORDS) + [ ## Installieren und Konfigurieren von ORDS 22 und niedriger ](#Appendix.Oracle.Options.APEX.ORDS22) ## Installieren und Konfigurieren von ORDS 21 und niedriger Sie können jetzt Oracle Rest Data Services (ORDS) für die Verwendung mit Oracle APEX installieren und konfigurieren. Verwenden Sie für Oracle APEX Version 5.0 und höher ORDS-Versionen 19.1 bis 21. Weitere Informationen zum Installieren von ORDS 22 und höher finden Sie unter [Installieren und Konfigurieren von ORDS 22 und niedriger](#Appendix.Oracle.Options.APEX.ORDS22). Installieren Sie den Listener auf einem separaten Host wie beispielsweise einer Amazon EC2-Instance, einem lokalen Server in Ihrem Unternehmen oder Ihrem Desktopcomputer. Für die Beispiele in diesem Abschnitt gehen wir davon aus, dass der Name Ihres Hosts `myapexhost.example.com` lautet und dass auf Ihrem Host Linux ausgeführt wird. **So installieren und konfigurieren Sie ORDS für die Verwendung mit Oracle APEX** 1. Gehen Sie zu [Oracle REST Data Services](https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads-212.html) und lesen Sie die Readme-Datei. Stellen Sie sicher, dass die erforderliche Version von Java installiert ist. 1. Erstellen Sie ein neues Verzeichnis für Ihre ORDS-Installation. ``` mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS ``` 1. Laden Sie die Datei `ords.version.number.zip` von [Oracle REST Data Services](https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads-212.html) herunter. 1. Entpacken Sie die Datei im Verzeichnis `/home/apexuser/ORDS`. 1. Wenn Sie ORDS in einer Mehrmandantendatenbank installieren, fügen Sie der Datei `/home/apexuser/ORDS/params/ords_params.properties` die folgende Zeile hinzu: ``` pdb.disable.lockdown=false ``` 1. Gewährt dem Master-Benutzer die erforderlichen Berechtigungen für die Installation von ORDS. Nachdem die APEX-Option installiert wurde, erteilen Sie dem Masterbenutzer die erforderlichen Berechtigungen für die Installation des ORDS-Schemas. Sie können dies tun, indem Sie sich mit der Datenbank verbinden und die folgenden Befehle ausführen. Ersetzen Sie `MASTER_USER` durch den Großbuchstaben Ihres Hauptbenutzers. **Wichtig** Verwenden Sie bei der Eingabe des Benutzernamens Großbuchstaben, es sei denn, Sie haben den Benutzer mit einer Kennung mit Groß- und Kleinschreibung erstellt. Wenn Sie z. B. `CREATE USER myuser` oder `CREATE USER MYUSER` ausführen , wird im Datenwörterbuch `MYUSER` gespeichert. Wenn Sie jedoch doppelte Anführungszeichen in `CREATE USER "MyUser"` verwenden, speichert das Datenwörterbuch `MyUser`. Weitere Informationen finden Sie unter [Erteilen von SELECT- oder EXECUTE-Berechtigungen für SYS-Objekte](Appendix.Oracle.CommonDBATasks.TransferPrivileges.md). ``` exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SESSION', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY', 'MASTER_USER', 'EXECUTE', true); ``` **Anmerkung** Diese Befehle gelten für ORDS Version 19.1 und später. 1. Installieren Sie das ORDS-Schema mit Hilfe der heruntergeladenen ords.war-Datei. ``` java -jar ords.war install advanced ``` Das Programm fordert Sie zur Eingabe der folgenden Informationen auf. Die Standardwerte stehen in eckigen Klammern. Weitere Informationen finden Sie unter [Introduction to Oracle REST Data Services](https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/20.2/aelig/installing-REST-data-services.html#GUID-6F7B4E61-B730-4E73-80B8-F53299123730) in der Oracle-Dokumentation. + Geben Sie den Speicherort für die Konfigurationsdaten ein: Geben Sie ei */home/apexuser/ORDS*. Dies ist der Speicherort der ORDS-Konfigurationsdateien. + Geben Sie den zu verwendenden Datenbankverbindungstyp an. Geben Sie die Nummer für [1] Basic [2] TNS [3] Benutzerdefinierte URL [1] ein: Wählen Sie den gewünschten Verbindungstyp. + Geben Sie den Namen des Datenbankservers [localhost] ein: *DB\$1instance\$1endpoint* Wählen Sie den Standardwert aus oder geben Sie den richtigen Wert ein. + Geben Sie den Datenbank-Listener-Port [1521] ein: *DB\$1instance\$1port* Wählen Sie den Standardwert aus oder geben Sie den richtigen Wert ein. + Geben Sie 1 zum Angeben des Datenbank-Service-Namens und 2 zum Angeben der Datenbank-SID [1] ein. Wählen Sie `2`, um die Datenbank-SID anzugeben. + Datenbank-SID [xe] Wählen Sie den Standardwert aus oder geben Sie den richtigen Wert ein. + Geben Sie 1 ein, wenn Sie das verify/install Oracle REST Data Services-Schema verwenden möchten, oder 2, um diesen Schritt zu überspringen [1]: Wählen Sie `1`. In diesem Schritt wird der Oracle REST Data Services-Proxy-Benutzer mit dem Namen ORDS\$1PUBLIC\$1USER erstellt. + Geben Sie das Datenbankpasswort für ORDS\$1PUBLIC\$1USER ein: Geben Sie das Passwort ein und bestätigen Sie es. + Erfordert für die Anmeldung mit Administratorrechten, um das Oracle REST Data Services-Schema zu überprüfen. Geben Sie den Administrator-Benutzernamen ein: *master\$1user* Geben Sie das Datenbankkennwort ein für*master\$1user*: *master\$1user\$1password* Bestätigen Sie das Passwort: *master\$1user\$1password* **Anmerkung** Geben Sie aus Sicherheitsgründen ein anderes Passwort als hier angegeben an. + Geben Sie den Standard-Tablespace für ORDS\$1METADATA [SYSAUX] ein. Geben Sie den temporären Tablespace für ORDS\$1METADATA [TEMP] ein. Geben Sie den Standard-Tablespace für ORDS\$1PUBLIC\$1USER [USERS] ein. Geben Sie den temporären Tablespace für ORDS\$1PUBLIC\$1USER [TEMP] ein. + Geben Sie 1 ein, wenn Sie PL/SQL Gateway verwenden möchten, oder 2, um diesen Schritt zu überspringen. Wenn Sie Oracle Application Express verwenden oder von mod\$1plsql migrieren, müssen Sie 1 [1] eingeben. Wählen Sie den Standardwert aus. + Geben Sie den PL/SQL Gateway-Datenbankbenutzernamen [APEX\$1PUBLIC\$1USER] ein Wählen Sie den Standardwert aus. + Geben Sie das Datenbankpasswort für APEX\$1PUBLIC\$1USER ein: Geben Sie das Passwort ein und bestätigen Sie es. + Geben Sie 1 ein, um Passwörter für Application Express RESTful Services-Datenbankbenutzer (APEX\$1LISTENER, APEX\$1REST\$1PUBLIC\$1USER) anzugeben, oder 2, um diesen Schritt zu überspringen [1]: Wählen Sie `2` für APEX 4.1.1.V1 und `1` für alle anderen APEX-Versionen. + [Nicht erforderlich für APEX 4.1.1.v1] Datenbankpasswort für APEX\$1LISTENER Geben Sie das Passwort ein (falls erforderlich) und bestätigen Sie es. + [Nicht erforderlich für APEX 4.1.1.v1] Datenbankpasswort für APEX\$1REST\$1PUBLIC\$1USER Geben Sie das Passwort ein (falls erforderlich) und bestätigen Sie es. + Geben Sie eine Zahl ein, um eine Funktion auszuwählen, die aktiviert werden soll: Geben Sie `1` ein, um alle Funktionen zu aktivieren: SQL Developer Web, REST Enabled SQL und Datenbank-API. + Geben Sie 1 ein, wenn Sie im Standalone-Modus starten möchten, oder 2, um [1] zu beenden: Geben Sie ei `1`. + Geben Sie den Speicherort für statische APEX-Ressourcen ein: Wenn Sie APEX-Installationsdateien in `/home/apexuser` entpackt haben, geben Sie `/home/apexuser/apex/images` ein. Geben Sie andernfalls ein, wo sich das Verzeichnis befindet, in dem Sie die Datei entpackt `unzip_path/apex/images` haben. *unzip\$1path* + Geben Sie 1 ein, wenn HTTP verwendet wird, oder 2 bei Verwendung von HTTPS [1]: Geben Sie bei Eingabe von `1` den HTTP-Port an. Geben Sie bei Eingabe von `2` den HTTPS-Port und den SSL-Hostnamen an. Die HTTPS-Option fordert Sie dazu auf, anzugeben, wie Sie das Zertifikat bereitstellen möchten: + Geben Sie `1` ein, um das selbstsignierte Zertifikat zu verwenden. + Geben Sie `2` ein, um Ihr eigenes Zertifikat vorzulegen. Geben Sie bei der Eingabe von `2` den Pfad für das SSL-Zertifikat und den Pfad für den privaten Schlüssel des SSL-Zertifikats an. 1. Legen Sie ein Passwort für den 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. Starten Sie den ORDS-Listener. Führen Sie folgenden Code aus. ``` java -jar ords.war ``` Wenn Sie ORDS erstmals starten, werden Sie aufgefordert, die Position der APEX Static-Ressourcen anzugeben. Dieser Ordner für Abbilder befindet sich im Verzeichnis `/apex/images` im Installationsverzeichnis von APEX. 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. ## Installieren und Konfigurieren von ORDS 22 und niedriger Sie können jetzt Oracle Rest Data Services (ORDS) für die Verwendung mit Oracle APEX installieren und konfigurieren. Für die Beispiele in diesem Abschnitt gehen wir davon aus, dass der Name Ihres separaten Hosts `myapexhost.example.com` lautet und dass auf Ihrem Host Linux ausgeführt wird. Die Anleitungen für ORDS 22 unterscheiden sich von den Anweisungen für frühere Versionen. **So installieren und konfigurieren Sie ORDS für die Verwendung mit Oracle APEX** 1. Gehen Sie zu [Oracle REST Data Services](http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html) und lesen Sie die Readme-Datei für die ORDS-Version, die Sie herunterladen möchten. Stellen Sie sicher, dass die erforderliche Version von Java installiert ist. 1. Erstellen Sie ein neues Verzeichnis für Ihre ORDS-Installation. ``` mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS ``` 1. Laden Sie die Datei `ords.version.number.zip` oder `ords-latest.zip` von [Oracle REST Data Services](http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html) herunter. 1. Entpacken Sie die Datei im Verzeichnis `/home/apexuser/ORDS`. 1. Gewährt dem Master-Benutzer die erforderlichen Berechtigungen für die Installation von ORDS. Nachdem die `APEX`-Option installiert wurde, erteilen Sie dem Masterbenutzer die erforderlichen Berechtigungen für die Installation des ORDS-Schemas. Sie erreichen dies, indem Sie sich bei der Datenbank anmelden und die folgenden Befehle ausführen. Ersetzen Sie `MASTER_USER` durch den Großbuchstaben Ihres Hauptbenutzers. **Wichtig** Verwenden Sie bei der Eingabe des Benutzernamens Großbuchstaben, es sei denn, Sie haben den Benutzer mit einer Kennung mit Groß- und Kleinschreibung erstellt. Wenn Sie z. B. `CREATE USER myuser` oder `CREATE USER MYUSER` ausführen , wird im Datenwörterbuch `MYUSER` gespeichert. Wenn Sie jedoch doppelte Anführungszeichen in `CREATE USER "MyUser"` verwenden, speichert das Datenwörterbuch `MyUser`. Weitere Informationen finden Sie unter [Erteilen von SELECT- oder EXECUTE-Berechtigungen für SYS-Objekte](Appendix.Oracle.CommonDBATasks.TransferPrivileges.md). ``` exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SESSION', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_LOB', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_ASSERT', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_OUTPUT', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SCHEDULER', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('HTP', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('OWA', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('WPG_DOCLOAD', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_CRYPTO', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_METADATA', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SQL', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('UTL_SMTP', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_NETWORK_ACL_ADMIN', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('SESSION_PRIVS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_USERS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACL_PRIVILEGES', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACLS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_REGISTRY', 'MASTER_USER', 'SELECT', true); ``` **Anmerkung** Die vorherigen Befehle gelten für ORDS 22 und später. 1. Installieren Sie das ORDS-Schema mithilfe desheruntergeladenen `ords`-Skripts. Geben Sie Verzeichnisse an, die Konfigurationsdateien und Protokolldateien enthalten sollen. Die Oracle Corporation empfiehlt, diese Verzeichnisse nicht in dem Verzeichnis zu platzieren, das die ORDS-Produktsoftware enthält. ``` mkdir -p /home/apexuser/ords_config /home/apexuser/ords_logs /home/apexuser/ORDS/bin/ords \ --config /home/apexuser/ords_config \ install --interactive --log-folder /home/apexuser/ords_logs ``` Verwenden Sie für DB-Instances, auf denen die Container-Datenbank-Architektur (CDB) ausgeführt wird, ORDS 23.3 oder höher und übergeben Sie das Argument `--pdb-skip-disable-lockdown` bei der Installation von ORDS. ``` /home/apexuser/ORDS/bin/ords \ --config /home/apexuser/ords_config \ install --interactive --log-folder /home/apexuser/ords_logs --pdb-skip-disable-lockdown ``` Das Programm fordert Sie zur Eingabe der folgenden Informationen auf. Die Standardwerte stehen in eckigen Klammern. Weitere Informationen finden Sie unter [Introduction to Oracle REST Data Services](https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/20.2/aelig/installing-REST-data-services.html#GUID-6F7B4E61-B730-4E73-80B8-F53299123730) in der Oracle-Dokumentation. + `Choose the type of installation:` Wählen Sie **2** aus, um ORDS-Schemas in der Datenbank zu installieren und erstellen Sie einen Datenbankverbindungspool in den lokalen ORDS-Konfigurationsdateien. + `Specify the database connection type to use. Enter number for [1] Basic [2] TNS [3] Custom URL:` Wählen Sie den gewünschten Verbindungstyp. In diesem Beispiel wird davon ausgegangen, dass Sie **1** auswählen. + `Enter the name of the database server [localhost]:` ***DB\$1instance\$1endpoint*** Wählen Sie den Standardwert aus oder geben Sie den richtigen Wert ein. + `Enter the database listener port [1521]:` ***DB\$1instance\$1port*** Wählen Sie den Standardwert **1521** aus oder geben Sie den richtigen Wert ein. + `Enter the database service name [orcl]:` Geben Sie den Datenbanknamen ein, der von Ihrer DB-Instance von RDS für Oracle verwendet wird. + `Provide database user name with administrator privileges` Geben Sie den Namen des Masterbenutzers für die DB-Instance von RDS für Oracle ein. + `Enter the database password for [username]:` Geben Sie das Passwort des Masterbenutzers für die DB-Instance von RDS für Oracle ein. + `Enter the default tablespace for ORDS_METADATA and ORDS_PUBLIC_USER [SYSAUX]:` + `Enter the temporary tablespace for ORDS_METADATA [TEMP]. Enter the default tablespace for ORDS_PUBLIC_USER [USERS]. Enter the temporary tablespace for ORDS_PUBLIC_USER [TEMP].` + `Enter a number to select additional feature(s) to enable [1]:` + `Enter a number to configure and start ORDS in standalone mode [1]: ` Wählen Sie **2** aus, um das sofortige Starten von ORDS im Standalone-Modus zu überspringen. + `Enter a number to select the protocol [1] HTTP` + `Enter the HTTP port [8080]:` + `Enter the APEX static resources location:` Geben Sie den Pfad zu den Oracle-APEX-Installationsdateien ein (`/home/apexuser/apex/images`). 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. Führen Sie ORDS im Standalone-Modus aus, indem Sie das `ords`-Skript mit dem Befehl `serve` verwenden. Für Produktionsbereitstellungen sollten Sie die Verwendung unterstützter Java EE-Anwendungsserver wie Apache Tomcat oder Oracle Server in Betracht ziehen. WebLogic Weitere Informationen finden Sie unter [Deploying and Monitoring Oracle REST Data Services](https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/23.1/ordig/deploying-and-monitoring-oracle-rest-data-services.html#GUID-6791F5DF-AC67-4885-BFFA-B80964C17EC9) in der Oracle-Dokumentation. ``` /home/apexuser/ORDS/bin/ords \ --config /home/apexuser/ords_config serve \ --port 8193 \ --apex-images /home/apexuser/apex/images ``` Wenn ORDS ausgeführt wird, aber nicht auf die Oracle APEX-Installation zugreifen kann, wird möglicherweise der folgende Fehler angezeigt, insbesondere bei Nicht-CDB-Instances. ``` The procedure named apex_admin could not be accessed, it may not be declared, or the user executing this request may not have been granted execute privilege on the procedure, or a function specified by security.requestValidationFunction configuration property has prevented access. ``` Um diesen Fehler zu beheben, ändern Sie die von ORDS verwendete Anforderungsvalidierungsfunktion, indem Sie das `ords`-Skript mit dem Befehl `config` ausführen. Standardmäßig verwendet ORDS das `ords_util.authorize_plsql_gateway`-Verfahren, das nur auf CDB-Instances unterstützt wird. Für Nicht-CDB-Instances können Sie dieses Verfahren im `wwv_flow_epg_include_modules.authorize`-Paket ändern. Bewährte Methoden zur Konfiguration der richtigen Anforderungsvalidierungsfunktion für Ihren Anwendungsfall finden Sie in der Oracle Database-Dokumentation und im Oracle Support. 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. # Aktualisieren und Entfernen von Oracle APEX Folgen Sie den Anleitungen in diesem Thema, um Oracle APEX zu aktualisieren oder zu entfernen: **Topics** + [ ## Aktualisieren der Oracle-APEX-Version ](#Appendix.Oracle.Options.APEX.Upgrade) + [ ## Entfernen der Optionen APEX und APEX-DEV ](#Appendix.Oracle.Options.APEX.Remove) ## Aktualisieren der Oracle-APEX-Version **Wichtig** Sichern Sie Ihre DB-Instance vor dem Upgrade von Oracle APEX. Weitere Informationen erhalten Sie unter [Erstellen eines DB-Snapshots für eine DB-Instance mit Single-AZ für Amazon RDS](USER_CreateSnapshot.md) und [Testen eines Oracle DB-Upgrades](USER_UpgradeDBInstance.Oracle.UpgradeTesting.md). Um Oracle APEX zusammen mit Ihrer DB-Instance zu aktualisieren, gehen Sie wie folgt vor: + Erstellen Sie eine neue Optionsgruppe für die aktualisierte Version Ihrer DB-Instance. + Fügen Sie der neuen Optionsgruppe die aktualisierten Versionen der Optionen von `APEX` und `APEX-DEV` hinzu. Achten Sie darauf, alle anderen Optionen aufzunehmen, die Ihre DB-Instance verwendet. Weitere Informationen finden Sie unter [Überlegungen zu Optionsgruppen](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.OG). + Geben Sie beim Aktualisieren der DB-Instance die neue Optionsgruppe für Ihre aktualisierte DB-Instance an. Nachdem Sie Ihre Oracle-APEX-Version aktualisiert haben, ist das APEX-Schema für die vorherige Version möglicherweise noch in Ihrer Datenbank vorhanden. Wenn Sie es nicht mehr benötigen, können Sie nach dem Upgrade das alte Oracle-APEX-Schema aus Ihrer Datenbank löschen. Wenn Sie die Oracle APEX-Version aktualisieren und RESTful Dienste in der vorherigen Oracle APEX-Version nicht konfiguriert wurden, empfehlen wir Ihnen, Dienste zu konfigurieren RESTful . Weitere Informationen finden Sie unter [RESTful Dienste für Oracle APEX konfigurieren](Appendix.Oracle.Options.APEX.settingUp.md#Appendix.Oracle.Options.APEX.ConfigureRESTful). In einigen Fällen, wenn Sie ein größeres Versions-Upgrade Ihrer DB-Instance planen, werden Sie möglicherweise feststellen, dass Sie eine Oracle-APEX-Version verwenden, die nicht mit Ihrer Zieldatenbankversion kompatibel ist. In diesen Fällen können Sie Ihre Oracle-APEX-Version upgraden, bevor Sie Ihre DB-Instance aktualisieren. Dadurch dass Sie die Oracle-APEX-Version zuerst aktualisieren, kann sich die Zeit für das Upgrade Ihrer DB-Instance verkürzen. **Anmerkung** Nach dem Upgrade von Oracle-APEX installieren und konfigurieren Sie einen Listener für die Verwendung mit der aktualisierten Version. Anleitungen finden Sie unter [Einrichten von Oracle APEX Listener](Appendix.Oracle.Options.APEX.settingUp.md#Appendix.Oracle.Options.APEX.Listener). ## Entfernen der Optionen APEX und APEX-DEV Sie können die Optionen `APEX` und `APEX-DEV` aus einer DB-Instance entfernen. Führen Sie eine der folgenden Maßnahmen durch, um diese Optionen aus einer DB-Instance zu entfernen: + Um die Optionen `APEX` und `APEX-DEV` aus mehreren DB-Instances zu entfernen, löschen Sie sie aus der zugehörigen Optionsgruppe. Diese Änderung wirkt sich auf alle DB-Instances aus, welche die betreffende Optionsgruppe verwenden. Wenn Sie die Optionen aus einer Optionsgruppe entfernen, die mit mehreren DB-Instances verknüpft ist, kommt es zu einem kurzen Nutzungsaufall, während die DB-Instances neu gestartet werden. Weitere Informationen finden Sie unter [Entfernen einer Option aus einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). + Um die Optionen `APEX` und `APEX-DEV` aus einer einzelnen DB-Instance zu entfernen, ändern Sie die DB-Instance und geben Sie eine andere Optionsgruppe an, in der diese Optionen nicht enthalten sind. Sie können die (leere) Standardoptionsgruppe oder eine andere benutzerdefinierte Optionsgruppe angeben. Wenn Sie die Optionen entfernen, 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). Wenn Sie die Optionen `APEX` und `APEX-DEV` aus einer DB-Instance entfernen, wird das APEX-Schema aus Ihrer Datenbank entfernt.