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 RESTful servicesPréparation à l'installation d'ORDS sur un hôte distinctConfiguration du processus d'écoute Oracle APEX

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.

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 APEX-DEV options APEX et à votre instance de base de données RDS pour 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 APEX-DEV options APEX et, une brève interruption 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 APEX-DEV options APEX et 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 uniquement l'APEXoption. Pour déployer l'environnement de développement complet, ajoutez à la fois les APEX-DEV options APEX et.

    Dans Version, choisissez la version d'Oracle APEX que vous souhaitez utiliser.

    Important

    Si vous ajoutez les APEX-DEV options APEX ou à un groupe d'options existant déjà attaché à une ou plusieurs instances de base de données, une brève interruption 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 APEX-DEV options APEX or à une instance de base de données existante, une brève interruption se produit pendant le redémarrage automatique de votre instance de base de données. Pour de plus amples informations, veuillez consulter Modification d'une RDS instance de base de données Amazon.

Déverrouillage du compte utilisateur public sur votre instance de base de données

Après avoir installé les APEX-DEV options APEX ou sur votre instance de base de données, veillez à effectuer les opérations suivantes :

  1. Modifiez le mot de passe du APEX_PUBLIC_USER compte.

  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 RESTful services pour Oracle APEX

Pour configurer les RESTful services dans Oracle APEX (ce n'est pas 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 à l'installation d'ORDS sur un hôte distinct

Installez ORDS sur un hôte distinct tel qu'une EC2 instance Amazon, un serveur local 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 porte un nommyapexhost.example.com.

Avant d'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 d'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 as apexuser et téléchargez le fichier d'installation d'Oracle APEX depuis Oracle /home/apexuser dans votre répertoire :

  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é en myapexhost.example.com tant queapexuser, téléchargez le fichier Oracle REST Data Services depuis Oracle /home/apexuser dans votre répertoire : 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 pour Oracle continue de 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 Oracle APEX Listener sur un hôte distinct tel qu'une EC2 instance Amazon, un serveur local 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 d'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 d'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 as apexuser et téléchargez le fichier d'installation d'Oracle APEX depuis Oracle /home/apexuser dans votre répertoire :

  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 apex.war fichier, 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. Dans 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. Ce mot de passe est celui que vous avez spécifié précédemment lors de la configuration du référentiel Oracle APEX. Pour de plus amples informations, veuillez consulter 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 d'Oracle APEX s'affiche.

  7. Définissez un mot de passe pour l'adminutilisateur 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 d'Oracle APEX dans votre navigateur et sélectionnez 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é.