Configuration d’Oracle APEX et d’Oracle Rest Data Services (ORDS) - Amazon Relational Database Service
Ajout des options APEX et APEX-DEVDéverrouillage du compte utilisateur public Configuration des services RESTfulPréparation de l’installation d’ORDS sur un hôte distinctConfiguration du processus d'écoute Oracle APEX

Configuration d’Oracle APEX et d’Oracle Rest Data Services (ORDS)

La rubrique suivante répertorie les étapes requises pour configurer Oracle APEX et ORDS.

Ajout des options APEX et APEX-DEV à votre instance de base de données

Pour ajouter les options APEX et APEX-DEV à votre instance de base de données RDS for Oracle, 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 à votre instance de base de données.

Lorsque vous ajoutez les options APEX et APEX-DEV, une brève interruption de service 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 et APEX-DEV à 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 et APEX-DEV 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. Pour déployer l’environnement de développement complet, ajoutez les options APEX et APEX-DEV.

    Pour Version, choisissez la version d’Oracle APEX que vous souhaitez utiliser.

    Important

    Si vous ajoutez les options APEX ou APEX-DEV à 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 se produit. 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 ou APEX-DEV à 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 sur votre instance de base de données

Une fois que vous avez installé les options APEX-DEV ou APEX sur votre instance de base de données, veillez à effectuer les opérations suivantes :

  1. Modifie le mot de passe du compte APEX_PUBLIC_USER.

  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 Oracle APEX (non nécessaire pour Oracle 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');

Préparation de l’installation d’ORDS sur un hôte distinct

Installez ORDS sur un hôte distinct : une instance Amazon EC2, un serveur sur site de votre entreprise ou votre ordinateur de bureau. Les exemples présentés dans cette section supposent que votre hôte exécute Linux et qu’il s’appelle myapexhost.example.com.

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 Oracle 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’Oracle 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.

Configuration du processus d'écoute Oracle APEX

Note

L'écouteur Oracle APEX est obsolète.

Amazon RDS for Oracle continue à prendre en charge Oracle APEX version 4.1.1 et Oracle APEX Listener 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 Oracle APEX Listener, 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 Oracle 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’Oracle 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 Oracle APEX, vous devez télécharger le fichier apex.war, utiliser Java pour installer Oracle APEX Listener, 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 Oracle 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 Oracle APEX. Pour plus d’informations, consultez Déverrouillage du compte utilisateur public sur votre instance de base de données.

    • 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 Oracle APEX s’affiche.

  7. Définissez un mot de passe pour l’utilisateur admin Oracle 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 Oracle 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é.