

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)
<a name="Appendix.Oracle.Options.APEX"></a>

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](https://apex.oracle.com/) dans la documentation d'Oracle.

**Topics**
+ [

## Composants Oracle APEX
](#Appendix.Oracle.Options.APEX.components)
+ [

# Exigences et limitations
](Appendix.Oracle.Options.APEX.Requirements.md)
+ [

# Configuration d’Oracle APEX et d’Oracle Rest Data Services (ORDS)
](Appendix.Oracle.Options.APEX.settingUp.md)
+ [

# Configuration d’Oracle Rest Data Services (ORDS)
](Appendix.Oracle.Options.APEX.ORDSConf.md)
+ [

# Mise à niveau et suppression d’Oracle APEX
](Appendix.Oracle.Options.APEX.UpgradeandRemove.md)

## Composants Oracle APEX
<a name="Appendix.Oracle.Options.APEX.components"></a>

Oracle APEX comprend les principaux composants suivants :
+ Un *référentiel* qui stocke les métadonnées pour les composants et les applications Oracle 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 Oracle APEX versions 5.0 et ultérieures, utilisez Oracle Rest Data Services (ORDS) versions 19.1 et ultérieures. 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 Oracle 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 en tant qu’écouteur pour Oracle 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](https://docs.oracle.com/database/apex-5.1/HTMIG/choosing-web-listener.htm#HTMIG29321) dans la documentation Oracle.

Lorsque vous ajoutez les options `APEX` et `APEX-DEV` à 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.

# Exigences et limitations
<a name="Appendix.Oracle.Options.APEX.Requirements"></a>

La rubrique suivante répertorie les exigences et les limitations relatives à Oracle APEX et ORDS.

## Exigences relatives à Oracle APEX
<a name="Appendix.Oracle.Options.APEX.versions"></a>

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 d’Oracle APEX | Besoins de stockage | Versions de Oracle Database prises en charge | Remarques | 
| --- | --- | --- | --- | 
|  Oracle APEX version 24.2.v1  |  114 Mio  |  Tous  |  Cette version inclut le correctif 37885097 : PSE BUNDLE FOR APEX 24.2 (PSES ON TOP OF 24.2.0), PATCH\$1VERSION 4.  | 
|  Oracle APEX version 24.1.v1  |  112 Mio  |  Tous  |  Cette version inclut le correctif 36695709 : PSE BUNDLE FOR APEX 24.1 (PSES ON TOP OF 24.1.0), PATCH\$1VERSION 3. Si vous avez besoin d’installer exactement la même version d’images APEX sur votre instance EC2, téléchargez le correctif 37544819 : 24.1.3 PSE BUNDLE FOR APEX 24.1 (PSES ON TOP OF 24.1.0).  | 
|  Oracle APEX version 23.2.v1  |  110 Mio  |  Tous  |  Cette version inclut le correctif 35895964 : PSE BUNDLE FOR APEX 23.2 (PSES ON TOP OF 23.2.0), PATCH\$1VERSION 6. Si vous avez besoin d’installer exactement la même version d’images APEX sur votre instance EC2, téléchargez le correctif 37593125 : 23.2.6 PSE BUNDLE FOR APEX 23.2 (PSES ON TOP OF 23.2.0).  | 
|  Oracle APEX version 23.1.v1  |  106 Mio  |  Tous  |  Cette version inclut le correctif 35283657 : PSE BUNDLE FOR APEX 23.1 (PSES ON TOP OF 23.1.0), PATCH\$1VERSION 2.  | 
|  Oracle APEX version 22.2.v1  |  106 Mio  |  Tous  |  Cette version inclut le correctif 34628174 : PSE BUNDLE FOR APEX 22.2 (PSES ON TOP OF 22.2.0), PATCH\$1VERSION 4.  | 
|  Oracle APEX version 21.1.v1  |  124 Mio  |  Tous  |  Cette version inclut le correctif 34020981 : PSE BUNDLE FOR APEX 22.1 (PSES ON TOP OF 22.1.0), PATCH\$1VERSION 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\$1VERSION 8.  | 
|  Oracle APEX version 21.1.v1  |  125 Mio  |  Tous  |  Cette version inclut le patch 32598392: PSE BUNDLE FOR APEX 21.1, PATCH\$1VERSION 3.  | 
|  Oracle APEX version 20.2.v1  |  148 Mio  |  Toutes sauf Oracle Database 21c  |  Cette version inclut le patch 32006852: PSE BUNDLE FOR APEX 20.2, PATCH\$1VERSION 2020.11.12. Vous pouvez voir le numéro et la date du correctif en exécutant la requête suivante : <pre>SELECT PATCH_VERSION, PATCH_NUMBER <br />FROM   APEX_PATCHES;</pre>  | 
|  Oracle APEX version 20.1.v1  |  173 Mio  |  Toutes sauf Oracle Database 21c  |  Cette version inclut le patch 30990551: PSE BUNDLE FOR APEX 20.1, PATCH\$1VERSION 2020.07.15.  | 
|  Oracle APEX version 19.2.v1  |  149 Mio  |  Toutes sauf Oracle Database 21c  |  | 
|  Oracle APEX version 19.1.v1  |  148 Mio  |  Toutes sauf Oracle Database 21c  |  | 

Pour les fichiers Oracle APEX .zip téléchargeables, consultez [Oracle APEX Prior Release Archives](https://www.oracle.com/tools/downloads/apex-all-archives-downloads.html) sur le site Web d’Oracle.

## Prérequis pour Oracle APEX et ORDS
<a name="Appendix.Oracle.Options.APEX.PreReqs"></a>

Notez les prérequis suivants pour utiliser Oracle APEX et ORDS :
+ Votre système doit utiliser l’environnement d’exécution Java (JRE).
+ Votre installation client Oracle doit comprendre les éléments suivants :
  + SQL\$1Plus 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

## Limitations relatives à Oracle APEX
<a name="Appendix.Oracle.Options.APEX.limitations"></a>

Vous ne pouvez pas modifier le compte utilisateur `APEX_version`, qui est géré par Amazon RDS. Vous ne pouvez donc pas appliquer de profils de base de données ni appliquer de règles de mot de passe à cet utilisateur. Les profils et les paramètres de mot de passe `APEX_version` sont prédéfinis par Oracle AWS et sont conçus pour répondre aux exigences de sécurité d'Amazon RDS.

# Configuration d’Oracle APEX et d’Oracle Rest Data Services (ORDS)
<a name="Appendix.Oracle.Options.APEX.settingUp"></a>

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

**Topics**
+ [

## Ajout des options APEX et APEX-DEV à votre instance de base de données
](#Appendix.Oracle.Options.APEX.Add)
+ [

## Déverrouillage du compte utilisateur public sur votre instance de base de données
](#Appendix.Oracle.Options.APEX.PublicUser)
+ [

## Configuration des RESTful services pour Oracle APEX
](#Appendix.Oracle.Options.APEX.ConfigureRESTful)
+ [

## Préparation de l’installation d’ORDS sur un hôte distinct
](#Appendix.Oracle.Options.APEX.ORDS.ords-setup)
+ [

## Configuration du processus d'écoute Oracle APEX
](#Appendix.Oracle.Options.APEX.Listener)

## Ajout des options APEX et APEX-DEV à votre instance de base de données
<a name="Appendix.Oracle.Options.APEX.Add"></a>

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.

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

1. 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. 

   1. 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](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 

1. 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](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). 

1. 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](USER_CreateDBInstance.md). 
   + 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 de plus amples informations, veuillez consulter [Modification d'une instance de base de données Amazon RDS](Overview.DBInstance.Modifying.md). 

## Déverrouillage du compte utilisateur public sur votre instance de base de données
<a name="Appendix.Oracle.Options.APEX.PublicUser"></a>

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`.

1. Déverrouillez le compte.

Pour cela, vous pouvez utiliser l'utilitaire de ligne de commande SQL\$1Plus 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. 

```
1. ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
2. ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;
```

## Configuration des RESTful services pour Oracle APEX
<a name="Appendix.Oracle.Options.APEX.ConfigureRESTful"></a>

Pour configurer les RESTful services dans Oracle APEX (ce n'est pas nécessaire pour Oracle APEX 4.1.1.V1), utilisez SQL\$1Plus 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.

```
1. 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
<a name="Appendix.Oracle.Options.APEX.ORDS.ords-setup"></a>

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`. 

1. 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;
   ```

1. 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` : 
   + [http://www.oracle. com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html) 
   + [Archives de versions antérieures d'Oracle Application Express](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html) 

1. 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`.

1. Pendant que vous êtes toujours connecté en `myapexhost.example.com` tant que`apexuser`, 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](http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html).

## Configuration du processus d'écoute Oracle APEX
<a name="Appendix.Oracle.Options.APEX.Listener"></a>

**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
<a name="Appendix.Oracle.Options.APEX.Listener.preparing"></a>

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`. 

1. 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;
   ```

1. 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` : 
   + [http://www.oracle. com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html) 
   + [Archives de versions antérieures d'Oracle Application Express](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html) 

1. 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`.

1. 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
<a name="Appendix.Oracle.Options.APEX.Listener.installing"></a>

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
   ```

1. Exécutez le code suivant.

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

1. 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
   ```

1. 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. 

1. 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\$1PUBLIC\$1USER*. 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 de plus amples informations, veuillez consulter [Déverrouillage du compte utilisateur public sur votre instance de base de données](#Appendix.Oracle.Options.APEX.PublicUser). 
   + **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`. 

1. Choisissez **Apply**. La fenêtre d’administration Oracle APEX s’affiche. 

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

   ```
   1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
   2. grant APEX_ADMINISTRATOR_ROLE to master;
   3. @/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`. 

1. 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`. 

   Choisissez**Login**, puis définissez un nouveau mot de passe pour l'utilisateur `admin`. 

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

# Configuration d’Oracle Rest Data Services (ORDS)
<a name="Appendix.Oracle.Options.APEX.ORDSConf"></a>

La rubrique suivante répertorie les options de configuration pour ORDS 21 et 22 :

**Topics**
+ [

## Installation et configuration d’ORDS versions 21 et inférieures
](#Appendix.Oracle.Options.APEX.ORDS)
+ [

## Installation et configuration d’ORDS versions 22 et ultérieures
](#Appendix.Oracle.Options.APEX.ORDS22)

## Installation et configuration d’ORDS versions 21 et inférieures
<a name="Appendix.Oracle.Options.APEX.ORDS"></a>

Vous êtes maintenant prêt à installer et à configurer Oracle Rest Data Services (ORDS) pour une utilisation avec Oracle APEX. Pour Oracle APEX versions 5.0 et ultérieures, utilisez ORDS versions 19.1 à 21. Pour savoir comment installer ORDS versions 22 et ultérieures, consultez [Installation et configuration d’ORDS versions 22 et ultérieures](#Appendix.Oracle.Options.APEX.ORDS22).

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.

**Pour installer et configurer ORDS versions 21 et inférieures en vue d’une utilisation avec Oracle APEX**

1. Accédez aux [services de données Oracle REST](https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads-212.html) et examinez le fichier Readme. Vérifiez que vous avez la version requise de Java installée.

1. Créez un nouveau répertoire pour votre installation ORDS.

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

1. Téléchargez le fichier `ords.version.number.zip` à partir de [Oracle REST data services](https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads-212.html).

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

1. 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
   ```

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

   Une fois les options pour Oracle APEX installées, 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](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);
   ```
**Note**  
Ces commandes s'appliquent à ORDS versions 19.1 et ultérieures.

1. 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](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) 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\$1instance\$1endpoint*

     Choisissez la valeur par défaut ou entrez la valeur correcte.
   + Entrez le port de l'écouteur de base de données [1521] : *DB\$1instance\$1port*

     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 utiliser le schéma verify/install 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\$1PUBLIC\$1USER.
   + Entrez le mot de passe de base de données pour ORDS\$1PUBLIC\$1USER :

     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\$1user*

     Entrez le mot de passe de base de données pour *master\$1user* : *master\$1user\$1password*

     Confirmez le mot de passe : *master\$1user\$1password*
**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\$1METADATA [SYSAUX].

     Entrez l'espace de table temporaire pour ORDS\$1METADATA [TEMP].

     Entrez l'espace de table par défaut pour ORDS\$1PUBLIC\$1USER [USERS].

     Entrez l'espace de table temporaire pour ORDS\$1PUBLIC\$1USER [TEMP].
   + Entrez 1 si vous souhaitez utiliser PL/SQL Gateway ou 2 pour ignorer cette étape. Si vous utilisez Oracle Application Express ou migrez à partir de mod\$1plsql, vous devez entrer 1 [1].

     Choisissez la valeur par défaut.
   + Entrez le nom d'utilisateur de la base de données PL/SQL Gateway [APEX\$1PUBLIC\$1USER]

     Choisissez la valeur par défaut.
   + Entrez le mot de passe de base de données pour APEX\$1PUBLIC\$1USER :

     Entrez le mot de passe, puis confirmez-le.
   + Entrez 1 pour spécifier les mots de passe des utilisateurs de la base de données Application Express RESTful Services (APEX\$1LISTENER, APEX\$1REST\$1PUBLIC\$1USER) 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\$1LISTENER

     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\$1REST\$1PUBLIC\$1USER

     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`unzip_path/apex/images`, entrez où se *unzip\$1path* trouve 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.

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

   ```
   1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
   2. grant APEX_ADMINISTRATOR_ROLE to master;
   3. @/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`. 

1. 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. 

1. 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`. 

   Choisissez**Login**, puis définissez un nouveau mot de passe pour l'utilisateur `admin`. 

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

## Installation et configuration d’ORDS versions 22 et ultérieures
<a name="Appendix.Oracle.Options.APEX.ORDS22"></a>

Vous êtes maintenant prêt à installer et à configurer Oracle Rest Data Services (ORDS) pour une utilisation avec Oracle APEX. 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. Les instructions relatives à ORDS 22 sont différentes de celles des versions précédentes.

**Pour installer et configurer ORDS versions 22 et ultérieures en vue d’une utilisation avec Oracle APEX**

1. Accédez à [Services de données Oracle REST](http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html) et examinez le fichier Readme correspondant à la version ORDS que vous prévoyez de télécharger. Vérifiez que vous avez la version requise de Java installée.

1. Créez un nouveau répertoire pour votre installation ORDS.

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

1. Téléchargez le fichier `ords.version.number.zip` ou `ords-latest.zip` à partir de [Services de données Oracle REST](http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html).

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

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

   Une fois l’option `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 de plus amples informations, veuillez consulter [Octroi des privilèges SELECT ou EXECUTE aux objets SYS](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);
   ```
**Note**  
Les commandes précédentes s’appliquent à ORDS versions 22 et ultérieures.

1. Installez le schéma ORDS à l’aide du script `ords` téléchargé. Spécifiez les répertoires qui contiendront les fichiers de configuration et les fichiers journaux. Oracle Corporation recommande de ne pas placer ces répertoires dans le répertoire qui contient le logiciel du produit ORDS.

   ```
   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
   ```

   Pour les instances de base de données exécutant l’architecture de base de données de conteneurs (CDB), utilisez ORDS version 23.3 ou supérieure et transmettez l’argument `--pdb-skip-disable-lockdown` lors de l’installation d’ORDS.

   ```
   /home/apexuser/ORDS/bin/ords \
     --config /home/apexuser/ords_config \
     install --interactive --log-folder /home/apexuser/ords_logs --pdb-skip-disable-lockdown
   ```

   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](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) dans la documentation Oracle.
   + `Choose the type of installation:`

     Choisissez **2** pour installer les schémas ORDS dans la base de données et de créer un groupe de connexions à la base de données dans les fichiers de configuration ORDS locaux.
   + `Specify the database connection type to use. Enter number for [1] Basic [2] TNS [3] Custom URL:`

     Choisissez le type de connexion souhaité. Cet exemple part du principe que vous choisissez **1**.
   + `Enter the name of the database server [localhost]:` ***DB\$1instance\$1endpoint***

     Choisissez la valeur par défaut ou entrez la valeur correcte.
   + `Enter the database listener port [1521]:` ***DB\$1instance\$1port***

     Choisissez la valeur par défaut **1521** ou entrez la valeur correcte.
   + `Enter the database service name [orcl]:`

     Entrez le nom de base de données utilisé par votre instance de base de données RDS for Oracle.
   + `Provide database user name with administrator privileges`

      Entrez le nom d’utilisateur principal pour votre instance de base de données RDS for Oracle.
   + `Enter the database password for [username]:`

     Entrez le mot de passe d’utilisateur principal pour votre instance de base de données RDS for Oracle.
   + `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]: `

      Choisissez **2** pour ne pas démarrer ORDS immédiatement en mode autonome.
   + `Enter a number to select the protocol [1] HTTP`
   + `Enter the HTTP port [8080]:`
   + `Enter the APEX static resources location:`

     Entrez le chemin d’accès aux fichiers d’installation d’Oracle APEX (`/home/apexuser/apex/images`).

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

   ```
   1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
   2. grant APEX_ADMINISTRATOR_ROLE to master;
   3. @/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`. 

1. Exécutez ORDS en mode autonome à l’aide du script `ords` associé à la commande `serve`. Pour les déploiements de production, pensez à utiliser des serveurs d'applications Java EE compatibles tels qu'Apache Tomcat ou Oracle WebLogic Server. Pour plus d’informations, consultez [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) dans la documentation Oracle Database.

   ```
   /home/apexuser/ORDS/bin/ords \
     --config /home/apexuser/ords_config serve \
     --port 8193 \
     --apex-images /home/apexuser/apex/images
   ```

   Si ORDS est en cours d’exécution mais ne parvient pas à accéder à l’installation d’Oracle APEX, l’erreur suivante peut s’afficher, en particulier sur les instances non CDB. 

   ```
   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.
   ```

   Pour corriger cette erreur, modifiez la fonction de validation des demandes utilisée par ORDS en exécutant le script `ords` avec la commande `config`. Par défaut, ORDS utilise la procédure `ords_util.authorize_plsql_gateway`, qui n’est prise en charge que sur les instances CDB. Pour les instances non CDB, vous pouvez modifier cette procédure pour le package `wwv_flow_epg_include_modules.authorize`. Consultez la documentation de la base de données Oracle et le support Oracle pour connaître les meilleures pratiques relatives à la configuration de la fonction de validation des demandes adaptée à votre cas d’utilisation.

1. 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`. 

   Choisissez**Login**, puis définissez un nouveau mot de passe pour l'utilisateur `admin`. 

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

# Mise à niveau et suppression d’Oracle APEX
<a name="Appendix.Oracle.Options.APEX.UpgradeandRemove"></a>

Pour mettre à niveau ou supprimer Oracle APEX, suivez les instructions de cette rubrique :

**Topics**
+ [

## Mise à niveau de la version d’Oracle APEX
](#Appendix.Oracle.Options.APEX.Upgrade)
+ [

## Suppression des options APEX et APEX-DEV
](#Appendix.Oracle.Options.APEX.Remove)

## Mise à niveau de la version d’Oracle APEX
<a name="Appendix.Oracle.Options.APEX.Upgrade"></a>

**Important**  
Faites une sauvegarde de votre instance de base de données avant de mettre à niveau Oracle 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 pour Amazon RDS](USER_CreateSnapshot.md) et [Test d'une mise à niveau de base de données Oracle](USER_UpgradeDBInstance.Oracle.UpgradeTesting.md). 

Pour mettre à niveau Oracle 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](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.OG). 
+ 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’Oracle APEX terminée, il est possible que le schéma Oracle 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 Oracle APEX de votre base de données après avoir procédé à la mise à niveau. 

Si vous mettez à niveau la version d'Oracle APEX et que les RESTful services n'étaient pas configurés dans la version précédente d'Oracle APEX, nous vous recommandons de configurer les RESTful services. Pour de plus amples informations, veuillez consulter [Configuration des RESTful services pour Oracle APEX](Appendix.Oracle.Options.APEX.settingUp.md#Appendix.Oracle.Options.APEX.ConfigureRESTful).

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’Oracle 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’Oracle APEX avant de mettre à niveau votre instance de base de données. La mise à niveau préalable d’Oracle 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 Oracle APEX, installez et configurez un écouteur à utiliser avec la version mise à niveau. Pour obtenir des instructions, veuillez consulter [Configuration du processus d'écoute Oracle APEX](Appendix.Oracle.Options.APEX.settingUp.md#Appendix.Oracle.Options.APEX.Listener).

## Suppression des options APEX et APEX-DEV
<a name="Appendix.Oracle.Options.APEX.Remove"></a>

Vous pouvez supprimer les options `APEX` et `APEX-DEV` d’une instance de base de données. Pour supprimer ces options d’une instance de base de données, effectuez l’une des actions suivantes : 
+ Pour supprimer les options `APEX` et `APEX-DEV` de plusieurs instances de base de données, supprimez les options 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 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 des instances de base de données. 

  Pour de plus amples informations, veuillez consulter [Suppression d’une option d’un groupe d’options](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). 
+ Pour supprimer les options `APEX` et `APEX-DEV` d’une instance de base de données particulière, modifiez l’instance et spécifiez un autre groupe d’options qui n’inclut pas ces options. 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, une brève interruption de service 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 instance de base de données Amazon RDS](Overview.DBInstance.Modifying.md). 

Lorsque vous supprimez les options `APEX` et `APEX-DEV` d’une instance de base de données, le schéma APEX est supprimé de votre base de données. 