Oracle Application Express (APEX) - Amazon Relational Database Service
Composants APEXVersion requise pour APEXExigences relatives à APEX et à ORDSAjout d'options APEXDéverrouillage du compte utilisateur public Configuration des services RESTfulConfiguration d'ORDSConfiguration du processus d'écoute Oracle APEXMise à niveau de la version d'APEXSuppression de l'option

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Oracle Application Express (APEX)

Amazon RDS prend en charge Oracle Application Express (APEX) à l'aide des options APEX et APEX-DEV. Vous pouvez déployer Oracle APEX en tant qu'environnement d'exécution ou de développement pour les applications web. A l'aide d'Oracle APEX, vous pouvez créer des applications entièrement dans le navigateur web. Pour plus d'informations, consultez Oracle Application Express dans la documentation d'Oracle.

Composants APEX

Oracle APEX comprend les principaux composants suivants :

  • Un référentiel qui stocke les métadonnées pour les composants et les applications APEX. Le référentiel se compose de tables, d'index et d'autres objets installés dans votre instance de base de données Amazon RDS.

  • Un écouteur qui gère les communications HTTP avec les clients Oracle APEX. L'écouteur réside sur un hôte distinct, tel qu'une instance Amazon EC2, un serveur sur site de votre entreprise ou votre ordinateur de bureau. L'écouteur accepte les connexions entrantes des navigateurs web et les transmet à l'instance de base de données Amazon RDS for traitement, puis renvoie les résultats du référentiel aux navigateurs. RDS for Oracle prend en charge les types d'écouteurs suivants :

    • Pour APEX version 5.0 et ultérieure, utilisez Oracle Rest Data Services (ORDS) version 19.1 et supérieure. Nous vous recommandons d'utiliser la dernière version prise en charge d'Oracle APEX et ORDS. Cette documentation décrit les anciennes versions à des fins de compatibilité descendante uniquement.

    • Pour APEX version 4.1.1, vous pouvez utiliser Oracle APEX Listener version 1.1.4.

    • Vous pouvez utiliser Oracle HTTP Server et les écouteurs mod_plsql.

      Note

      Amazon RDS ne prend pas en charge le serveur HTTP Oracle XML DB avec la passerelle PL/SQL incorporée ; vous ne pouvez pas l'utiliser en tant qu'écouteur pour APEX. En général, Oracle recommande de ne pas utiliser la passerelle PL/SQL incorporée pour les applications qui s'exécutent sur Internet.

    Pour plus d'informations sur ces types d'écouteur, consultez About Choosing a Web Listener dans la documentation Oracle.

Lorsque vous ajoutez les options Amazon RDS APEX à votre instance de base de données RDS for Oracle, Amazon RDS installe uniquement le référentiel Oracle APEX. Installez votre écouteur sur un hôte distinct.

Version requise pour APEX

L'option APEX utilise le stockage dans la classe d'instance de base de données pour votre instance de base de données. Voici les versions prises en charge et les besoins approximatifs en stockage pour Oracle APEX.

Version APEX Besoins de stockage Versions de Oracle Database prises en charge Remarques

Oracle APEX version 23.1.v1

106 Mio

19c et plus, non-CDBS

Cette version inclut le correctif 35283657 : PSE BUNDLE FOR APEX 23.1 (PSES ON TOP OF 23.1.0), PATCH_VERSION 2.

Oracle APEX version 22.2.v1

106 Mio

Tous les non-CDB

Cette version inclut le correctif 34628174 : PSE BUNDLE FOR APEX 22.2 (PSES ON TOP OF 22.2.0), PATCH_VERSION 4.

Oracle APEX version 21.1.v1

124 Mio

Tous les non-CDB

Cette version inclut le correctif 34020981 : PSE BUNDLE FOR APEX 22.1 (PSES ON TOP OF 22.1.0), PATCH_VERSION 6.

Oracle APEX version 21.2.v1

125 Mio

Tous

Cette version inclut le correctif 33420059 : PSE BUNDLE FOR APEX 21.2 (PSES ON TOP OF 21.2.0), PATCH_VERSION 8.

Oracle APEX version 21.1.v1

125 Mio

Tous

Cette version inclut le patch 32598392: PSE BUNDLE FOR APEX 21.1, PATCH_VERSION 3.

Oracle APEX version 20.2.v1

148 Mio

Tous sauf 21c

Cette version inclut le patch 32006852: PSE BUNDLE FOR APEX 20.2, PATCH_VERSION 2020.11.12. Vous pouvez voir le numéro et la date du correctif en exécutant la requête suivante :

SELECT PATCH_VERSION, PATCH_NUMBER 
FROM   APEX_PATCHES;

Oracle APEX version 20.1.v1

173 Mio

Tous sauf 21c

Cette version inclut le patch 30990551: PSE BUNDLE FOR APEX 20.1, PATCH_VERSION 2020.07.15.

Oracle APEX version 19.2.v1

149 Mio

Tous sauf 21c

Oracle APEX version 19.1.v1

148 Mio

Tous sauf 21c

Oracle APEX version 18.2.v1

146 MIO

12.1 et 12.2 seulement

Oracle APEX version 18.1.v1

145 Mio

12.1 et 12.2 seulement

Oracle APEX version 5.1.4.v1

220 Mio

12.1 et 12.2 seulement

Oracle APEX version 5.1.2.v1

150 Mio

12.1 et 12.2 seulement

Oracle APEX version 5.0.4.v1

140 Mio

12.1 et 12.2 seulement

Oracle APEX version 4.2.6.v1

160 Mio

12.1 uniquement

Pour les fichiers APEX .zip téléchargeables, consultez Oracle APEX Prior Release Archives (Oracle APEX - Archives des versions antérieures) sur le site Web d'Oracle.

Exigences et limites relatives à Oracle APEX et ORDS

Notez les exigences suivantes relatives à APEX et ORDS :

  • Vous devez utiliser l'environnement d'exécution Java (JRE).

  • Votre installation client Oracle doit comprendre les éléments suivants :

    • SQL*Plus ou SQL Developer pour les tâches d'administration

    • Oracle Net Services pour configurer les connexions à votre instance de base de données RDS for Oracle

Notez les limites suivantes pour APEX et ORDS :

  • Vous ne pouvez pas utiliser une base de données CDB RDS for Oracle avec ORDS v22 ou version ultérieure. Pour contourner le problème, vous pouvez utiliser une version inférieure d'ORDS ou une base de données non-CDB Oracle Database 19c.

Ajout des options APEX et APEX-DEV

Pour ajouter les options APEX et APEX-DEV à une instance de base de données, procédez comme suit :

  1. Créer un groupe d'options ou copier ou modifier un groupe existant.

  2. Ajoutez les options APEX et APEX-DEV au groupe d'options.

  3. Associez le groupe d'options à l'instance de base de données.

Lorsque vous ajoutez les options APEX Amazon RDS, une brève panne se produit pendant le redémarrage automatique de votre instance de base de données.

Note

APEX_MAIL est disponible lorsque l'option APEX est installée. Le privilège d'exécution pour le package APEX_MAIL est accordé à PUBLIC et vous n'avez donc pas besoin du compte administratif APEX pour l'utiliser.

Pour ajouter les options APEX à une instance de base de données

  1. Déterminez le groupe d'options que vous voulez utiliser. Vous pouvez créer un groupe d'options ou utiliser un groupe d'options existant. Si vous souhaitez utiliser un groupe d'options existant, passez à l'étape suivante. Sinon, créez un groupe d'options DB personnalisé avec les paramètres suivants :

    1. Pour Moteur, sélectionnez l'édition d'Oracle que vous voulez utiliser. Les options APEX sont prises en charge sur toutes les éditions.

    2. Pour Version majeure du moteur, choisissez la version de votre instance de base de données.

    Pour plus d'informations, consultez Création d'un groupe d'options.

  2. Ajouter les options au groupe d'options. Si vous souhaitez déployer uniquement l'environnement d'exécution Oracle APEX, ajoutez seulement l'option APEX. Si vous souhaitez déployer l'environnement de développement complet, ajoutez les options APEX et APEX-DEV. Pour Oracle Database 12c, ajoutez les options APEX et APEX-DEV.

    Pour Version, choisissez la version d'APEX que vous souhaitez utiliser. Si vous ne sélectionnez pas une version, la version 4.2.6.v1 est la valeur par défaut de Oracle Database 12c.

    Important

    Si vous ajoutez les options APEX à un groupe d'options existant qui est déjà attaché à une ou plusieurs instances de base de données, une brève interruption de service a lieu. Pendant cette interruption, toutes les instances de base de données sont automatiquement redémarrées.

    Pour plus d'informations sur l'ajout d'options, consultez Ajout d'une option à un groupe d'options.

  3. Appliquez le groupe d'options à une instance de base de données nouvelle ou existante:

    • Pour une nouvelle instance de base de données, vous appliquez le groupe d'options lorsque vous lancez l'instance. Pour plus d'informations, consultez Création d'une instance de base de données Amazon RDS.

    • Pour une instance de base de données existante, vous appliquez le groupe d'options en modifiant l'instance et en attachant le nouveau groupe d'options. Lorsque vous ajoutez les options APEX à une instance de base de données existante, une brève interruption de service se produit pendant le redémarrage automatique de votre instance de base de données. Pour plus d'informations, consultez Modification d'une instance de base de données Amazon RDS.

Déverrouillage du compte utilisateur public

Une fois que les options APEX Amazon RDS sont installées, veillez à effectuer les opérations suivantes :

  1. Modifiez le mot de passe du compte d'utilisateur public APEX.

  2. Déverrouillez le compte.

Pour cela, vous pouvez utiliser l'utilitaire de ligne de commande SQL*Plus Oracle. Connectez-vous à votre instance de base de données en tant qu'utilisateur principal et exécutez les commandes suivantes. Remplacez new_password par un mot de passe de votre choix. 

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

Configuration des services RESTful pour Oracle APEX

Pour configurer les services RESTful dans APEX (non nécessaire pour APEX 4.1.1.V1), utilisez SQL*Plus pour vous connecter à votre instance de base de données en tant qu'utilisateur principal. Ensuite, exécutez la procédure stockée rdsadmin.rdsadmin_run_apex_rest_config. Lorsque vous exécutez la procédure stockée, vous fournissez les mots de passe des utilisateurs suivants :

  • APEX_LISTENER

  • APEX_REST_PUBLIC_USER

La procédure stockée exécute le script apex_rest_config.sql, qui crée de nouveaux comptes de base de données pour ces utilisateurs.

Note

Aucune configuration n'est requise pour Oracle APEX version 4.1.1.v1. Pour cette version d'Oracle APEX uniquement, vous n'avez pas besoin d'exécuter la procédure stockée.

La commande suivante exécute la procédure stockée.

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

Configuration d'ORDS for Oracle APEX

Vous êtes maintenant prêt à installer et à configurer Oracle Rest Data Services (ORDS) pour une utilisation avec Oracle APEX. Pour APEX version 5.0 et ultérieure, utilisez Oracle Rest Data Services (ORDS) version 19.1 et supérieure.

Installez l'écouteur sur un hôte distinct : une instance Amazon EC2, un serveur sur site de votre entreprise ou votre ordinateur de bureau. Pour les exemples de cette section, nous supposons que le nom de votre hôte est myapexhost.example.com, et que votre hôte exécute Linux.

Préparation de l'installation d'ORDS

Avant de pouvoir installer ORDS, vous devez créer un utilisateur du système d'exploitation non privilégié, puis télécharger et décompresser le fichier d'installation APEX.

Pour préparer l'installation d'ORDS

  1. Connectez-vous à myapexhost.example.com en tant que root.

  2. Créez un utilisateur du système d'exploitation non privilégié qui sera propriétaire de l'installation de l'écouteur. La commande suivante crée un utilisateur nommé apexuser. 

    useradd -d /home/apexuser apexuser

    La commande suivante affecte un mot de passe au nouvel utilisateur. 

    passwd apexuser;

  3. Connectez-vous à myapexhost.example.com en tant qu'apexuser et téléchargez le fichier d'installation d'APEX à partir d'Oracle dans le répertoire /home/apexuser :

  4. Décompressez le fichier dans le répertoire /home/apexuser.

    unzip apex_<version>.zip

    Une fois le fichier décompressé, un répertoire apex se trouve dans le répertoire /home/apexuser.

  5. Pendant que vous êtes toujours connecté à myapexhost.example.com en tant que apexuser, téléchargez le fichier Oracle REST Data Services depuis Oracle vers votre le répertoire /home/apexuser : http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html.

Installation et configuration d'ORDS

Avant de pouvoir utiliser APEX, vous devez télécharger le fichier ords.war, utiliser Java pour installer ORDS, puis démarrer l'écouteur.

. Pour installer et configurer ORDS en vue d'une utilisation avec Oracle APEX

  1. Créez un nouveau répertoire basé sur ORDS, puis décompressez le fichier du processus d'écoute.

    mkdir /home/apexuser/ORDS
cd /home/apexuser/ORDS

  2. Téléchargez le fichier ords.version.number.zip à partir de Oracle REST data services.

  3. Décompressez le fichier dans le répertoire /home/apexuser/ORDS.

  4. Si vous installez ORDS dans une base de données multi-locataires, ajoutez la ligne suivante au fichier /home/apexuser/ORDS/params/ords_params.properties :

    pdb.disable.lockdown=false

  5. Accordez à l'utilisateur principal les privilèges nécessaires à l'installation d'ORDS.

    Une fois l'option Amazon RDS APEX installée, octroyez à l'utilisateur principal les privilèges nécessaires à l'installation du schéma ORDS. Pour ce faire, connectez-vous à la base de données et exécutez les commandes suivantes. Remplacez MASTER_USER par le nom en majuscules de votre utilisateur principal.

    Important

    Lorsque vous entrez le nom d'utilisateur, utilisez des majuscules, sauf si vous avez créé l'utilisateur avec un identifiant sensible à la casse. Par exemple, si vous exécutez CREATE USER myuser ou CREATE USER MYUSER, le dictionnaire de données stocke MYUSER. Toutefois, si vous utilisez des guillemets doubles dans CREATE USER "MyUser", le dictionnaire de données stocke MyUser. Pour plus d'informations, consultez Octroi des privilèges SELECT ou EXECUTE aux objets SYS.

    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);
    Note

    Ces commandes s'appliquent à ORDS versions 19.1 et ultérieures.

  6. Installez le schéma ORDS à l'aide du fichier téléchargé ords.war.

    java -jar ords.war install advanced

    Le programme vous demande les informations suivantes. Les valeurs par défaut sont placées entre crochets. Pour de plus amples informations, veuillez consulter Introduction to Oracle REST Data Services dans la documentation Oracle.

    • Entrez l'emplacement de stockage des données de configuration :

      Saisissez /home/apexuser/ORDS. Il s'agit de l'emplacement des fichiers de configuration ORDS.

    • Spécifiez le type de connexion à la base de données à utiliser. Entrez le numéro pour [1] Basic [2] TNS [3] Custom URL [1] :

      Choisissez le type de connexion souhaité.

    • Entrez le nom du serveur de base de données [localhost] :DB_instance_endpoint

      Choisissez la valeur par défaut ou entrez la valeur correcte.

    • Entrez le port de l'écouteur de base de données [1521] : DB_instance_port

      Choisissez la valeur par défaut ou entrez la valeur correcte.

    • Entrez 1 pour spécifier le nom du service de base de données ou 2 pour spécifier le SID de base de données [1] :

      Choisissez 2 pour spécifier le SID de la base de données.

    • SID de base de données [xe]

      Choisissez la valeur par défaut ou entrez la valeur correcte.

    • Entrez 1 si vous souhaitez vérifier/installer le schéma Oracle REST Data Services ou 2 pour ignorer cette étape [1] :

      Choisissez 1. Cette étape crée l'utilisateur proxy Oracle REST Data Services nommé ORDS_PUBLIC_USER.

    • Entrez le mot de passe de base de données pour ORDS_PUBLIC_USER :

      Entrez le mot de passe, puis confirmez-le.

    • Nécessite une connexion avec des privilèges d'administrateur pour vérifier le schéma Oracle REST Data Services.

      Entrez le nom d'utilisateur de l'administrateur : master_user

      Entrez le mot de passe de la base de données pour master_user : master_user_password

      Confirmez le mot de passe : master_user_password

      Note

      Spécifiez un mot de passe autre que celui indiqué ici, en tant que bonne pratique de sécurité.

    • Entrez l'espace de table par défaut pour ORDS_METADATA [SYSAUX].

      Entrez l'espace de table temporaire pour ORDS_METADATA [TEMP].

      Entrez l'espace de table par défaut pour ORDS_PUBLIC_USER [USERS].

      Entrez l'espace de table temporaire pour ORDS_PUBLIC_USER [TEMP].

    • Entrez 1 si vous voulez utiliser PL/SQL Gateway ou 2 pour passer cette étape. Si vous utilisez Oracle Application Express ou migrez à partir de mod_plsql, vous devez entrer 1 [1].

      Choisissez la valeur par défaut.

    • Entrez le nom d'utilisateur de base de données de la passerelle PL/SQL [APEX_PUBLIC_USER]

      Choisissez la valeur par défaut.

    • Entrez le mot de passe de base de données pour APEX_PUBLIC_USER :

      Entrez le mot de passe, puis confirmez-le.

    • Entrez 1 pour spécifier les mots de passe des utilisateurs de base de données des services Application Express RESTful (APEX_LISTENER, APEX_REST_PUBLIC_USER) ou 2 pour ignorer cette étape [1] :

      Choisissez 2 pour APEX 4.1.1.V1 ou 1 pour toutes les autres versions d'APEX.

    • [Non nécessaire pour APEX 4.1.1.v1] Mot de passe de base de données pour APEX_LISTENER

      Entrez le mot de passe (si nécessaire), puis confirmez-le.

    • [Non nécessaire pour APEX 4.1.1.v1] Mot de passe de base de données pour APEX_REST_PUBLIC_USER

      Entrez le mot de passe (si nécessaire), puis confirmez-le.

    • Entrez un nombre pour sélectionner une fonction à activer :

      Entrez 1 pour activer toutes les fonctions : SQL Developer Web, REST Enabled SQL et Database API.

    • Entrez 1 si vous souhaitez démarrer en mode autonome ou 2 pour quitter [1] :

      Saisissez 1.

    • Entrez l'emplacement des ressources statiques APEX :

      Si vous avez décompressé les fichiers d'installation APEX dans /home/apexuser, entrez /home/apexuser/apex/images. Sinon, entrez unzip_path/apex/images, où unzip_path est le répertoire dans lequel vous avez décompressé le fichier.

    • Entrez 1 si vous utilisez HTTP ou 2 si vous utilisez HTTPS [1] :

      Si vous entrez 1, spécifiez le port HTTP. Si vous entrez 2, spécifiez le port HTTPS et le nom d'hôte SSL. L'option HTTPS vous invite à spécifier comment vous fournirez le certificat :

      • Entrez 1 pour utiliser le certificat auto-signé.

      • Entrez 2 pour fournir votre propre certificat. Si vous entrez 2, spécifiez le chemin d'accès du certificat SSL et le chemin d'accès de la clé privée du certificat SSL.

  7. Définissez un mot de passe pour l'utilisateur admin APEX. Pour ce faire, utilisez SQL*Plus pour vous connecter à votre instance de base de données en tant qu'utilisateur principal, puis exécutez les commandes suivantes.

    EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/home/apexuser/apex/apxchpwd.sql

    Remplacez master par votre identifiant principal. Lorsque le script apxchpwd.sql vous y invite, entrez un nouveau mot de passe admin.

  8. Démarrez l'écouteur ORDS. Exécutez le code suivant.

    java -jar ords.war

    La première fois que vous démarrez ORDS, vous devez fournir l'emplacement des ressources statiques APEX. Ce dossier d'images se trouve dans le répertoire /apex/images du répertoire d'installation d'APEX.

  9. Revenez à la fenêtre d'administration APEX de votre navigateur et choisissez Administration. Ensuite, choisissez Application Express Internal Administration. Lorsque vous êtes invité à saisir les informations d'identification, entrez les informations suivantes :

    • Nom d'utilisateur – admin

    • Mot de passe – Mot de passe que vous avez défini en utilisant le script apxchpwd.sql.

    ChoisissezLogin, puis définissez un nouveau mot de passe pour l'utilisateur admin.

L'écouteur est maintenant prêt à être utilisé.

Configuration du processus d'écoute Oracle APEX

Note

L'écouteur Oracle APEX est obsolète.

Amazon RDS for Oracle continue à prendre en charge APEX version 4.1.1 et l'écouteur Oracle APEX version 1.1.4. Nous vous recommandons d'utiliser les dernières versions prises en charge d'Oracle APEX et d'ORDS.

Installez l'écouteur Oracle APEX sur un hôte distinct, tel qu'une instance Amazon EC2, un serveur sur site de votre entreprise ou votre ordinateur de bureau. Nous partons du principe que le nom de votre hôte est myapexhost.example.com et qu'il exécute Linux.

Préparation de l'installation d'un écouteur Oracle APEX

Avant de pouvoir installer l'écouteur Oracle APEX, vous devez créer un utilisateur du système d'exploitation non privilégié, puis télécharger et décompresser le fichier d'installation APEX.

Pour préparer l'installation de l'écouteur Oracle APEX

  1. Connectez-vous à myapexhost.example.com en tant que root.

  2. Créez un utilisateur du système d'exploitation non privilégié qui sera propriétaire de l'installation de l'écouteur. La commande suivante crée un utilisateur nommé apexuser. 

    useradd -d /home/apexuser apexuser

    La commande suivante affecte un mot de passe au nouvel utilisateur. 

    passwd apexuser;

  3. Connectez-vous à myapexhost.example.com en tant qu'apexuser et téléchargez le fichier d'installation d'APEX à partir d'Oracle dans le répertoire /home/apexuser :

  4. Décompressez le fichier dans le répertoire /home/apexuser.

    unzip apex_<version>.zip

    Une fois le fichier décompressé, un répertoire apex se trouve dans le répertoire /home/apexuser.

  5. Pendant que vous êtes toujours connecté à myapexhost.example.com en tant que apexuser, téléchargez le fichier de l'écouteur Oracle APEX depuis Oracle vers votre répertoire /home/apexuser.

Installation et configuration de l'écouteur Oracle APEX

Avant de pouvoir utiliser APEX, vous devez télécharger le fichier apex.war, utiliser Java pour installer l'écouteur Oracle APEX, puis démarrer l'écouteur.

Pour installer et configurer l'écouteur Oracle APEX

  1. Créez un répertoire basé sur l'écouteur Oracle APEX et ouvrez le fichier de l'écouteur.

    Exécutez le code suivant :

    mkdir /home/apexuser/apexlistener
cd /home/apexuser/apexlistener 
unzip ../apex_listener.version.zip

  2. Exécutez le code suivant.

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

  3. Entrez les informations suivantes à l'invitation du programme :

    • Nom d'utilisateur de l'administrateur APEX Listener. Le paramètre par défaut est adminlistener.

    • Un mot de passe pour l'administrateur APEX Listener.

    • Nom d'utilisateur du gestionnaire APEX Listener. La valeur par défaut est managerlistener.

    • Un mot de passe pour l'administrateur APEX Listener.

    Le programme imprime une URL dont vous avez besoin pour terminer la configuration, comme ci-dessous.

    INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure
Database is not yet configured

  4. Continuez à exécuter l'écouteur Oracle APEX pour pouvoir utiliser Oracle Application Express. Lorsque vous avez terminé la procédure de configuration, vous pouvez exécuter l'écouteur à l'arrière-plan.

  5. Depuis votre navigateur web, accédez à l'URL fournie par le programme APEX Listener. La fenêtre d'administration d'Oracle Application Express Listener s'affiche. Entrez les informations suivantes :

    • Nom d'utilisateur – APEX_PUBLIC_USER

    • Mot de passe – le mot de passe pour APEX_PUBLIC_USER. Il s'agit du mot de passe que vous avez spécifié précédemment, lorsque vous avez configuré le référentiel APEX. Pour plus d'informations, consultez Déverrouillage du compte utilisateur public.

    • Type de connexion – Basic

    • Nom d'hôte – le point de terminaison de votre instance de base de données Amazon RDS, par exemple mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com.

    • Port – 1521

    • SID – le nom de la base de données sur votre instance de base de données Amazon RDS, tel que mydb.

  6. Choisissez Apply. La fenêtre d'administration APEX s'affiche.

  7. Définissez un mot de passe pour l'utilisateur admin APEX. Pour ce faire, utilisez SQL*Plus pour vous connecter à votre instance de base de données en tant qu'utilisateur principal, puis exécutez les commandes suivantes.

    EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/home/apexuser/apex/apxchpwd.sql

    Remplacez master par votre identifiant principal. Lorsque le script apxchpwd.sql vous y invite, entrez un nouveau mot de passe admin.

  8. Revenez à la fenêtre d'administration APEX de votre navigateur et choisissez Administration. Ensuite, choisissez Application Express Internal Administration. Lorsque vous êtes invité à saisir les informations d'identification, entrez les informations suivantes :

    • Nom d'utilisateur – admin

    • Mot de passe – Mot de passe que vous avez défini en utilisant le script apxchpwd.sql.

    ChoisissezLogin, puis définissez un nouveau mot de passe pour l'utilisateur admin.

L'écouteur est maintenant prêt à être utilisé.

Mise à niveau de la version d'APEX

Important

Faites une sauvegarde de votre instance de base de données avant de mettre à niveau APEX. Pour plus d’informations, consultez Création d'un instantané de base de données pour une instance de base de données mono-AZ et Test d'une mise à niveau de base de données Oracle.

Pour mettre à niveau APEX et votre instance de base de données, procédez comme suit :

  • Créez un nouveau groupe d'options pour la version mise à niveau de votre instance de base de données.

  • Ajoutez les versions mises à niveau d'APEX et d'APEX-DEV au nouveau groupe d'options. Assurez-vous d'ajouter toutes les autres options utilisées par votre instance de base de données. Pour plus d'informations, consultez Considérations relatives au groupe d'options.

  • Lorsque vous mettez à niveau votre instance de base de données, spécifiez le nouveau groupe d'options pour l'instance de base de données mise à niveau.

Une fois la mise à niveau de votre version d'APEX terminée, il est possible que le schéma APEX de la version précédente existe toujours dans votre base de données. Si vous n'en avez plus besoin, vous pouvez supprimer l'ancien schéma APEX de votre base de données après avoir procédé à la mise à niveau.

Si vous effectuez une mise à niveau de la version d'APEX et que les services RESTful n'ont pas été configurés dans la version antérieure d'APEX, nous vous recommandons de les configurer. Pour plus d'informations, consultez Configuration des services RESTful pour Oracle APEX.

Dans certains cas, lorsque vous planifiez d'effectuer une mise à niveau de version majeure de votre instance de base de données, vous pouvez vous rendre compte que vous utilisez une version d'APEX qui n'est pas compatible avec votre version de base de données cible. Dans ce cas, vous pouvez mettre à niveau votre version d'APEX avant de mettre à niveau votre instance de base de données. La mise à niveau préalable d'APEX permet de réduire le temps nécessaire à la mise à niveau de votre instance de base de données.

Note

Après avoir mis à niveau APEX, installez et configurez un écouteur à utiliser avec la version mise à niveau. Pour obtenir des instructions, consultez Configuration du processus d'écoute Oracle APEX.

Suppression de l'option APEX

Vous pouvez supprimer les options APEX Amazon RDS d'une instance de base de données. Pour supprimer les options APEX d'une instance de base de données, effectuez l'une des actions suivantes :

  • Pour supprimer les options APEX de plusieurs instances de base de données, supprimez l'option APEX du groupe d'options auquel elles appartiennent. Ce changement affecte toutes les instances de bases de données qui utilisent le groupe d'options. Lorsque vous supprimez les options APEX d'un groupe d'options qui est attaché à plusieurs instances de base de données, une brève interruption de service a lieu pendant le redémarrage de toutes les instances de base de données.

    Pour plus d'informations, consultez Suppression d'une option d'un groupe d'options.

  • Pour supprimer les options APEX d'une seule instance de base de données, modifiez l'instance de base de données et spécifiez un autre groupe d'options qui n'inclut pas les options APEX. Vous pouvez spécifier le groupe d'options (vide) par défaut, ou un groupe d'options personnalisées différent. Lorsque vous supprimez les options APEX, une brève interruption de service se produit pendant le redémarrage automatique de votre instance de base de données.

    Pour plus d'informations, consultez Modification d'une instance de base de données Amazon RDS.

Lorsque vous supprimez les options APEX d'une instance de base de données, le schéma APEX est supprimé de votre base de données.