Un guide simple sur la façon d'installer Oracle Apex et ORDS sur les systèmes Linux en format autonome.
Versions à installer dans ce guide :
APEX 24.1
Java23
ORDS 24.4
Les téléchargements sont disponibles sur les liens suivants :
Télécharger les logiciels requis
1) Téléchargez la dernière version d'Oracle Apex, dans ce cas 24.1.
https://www.oracle.com/tools/downloads/apex-241-downloads/
Téléchargez le fichier : Oracle APEX 24.1 - All languages
2) Téléchargez la dernière version d'ORDS, dans ce cas 24.4.
https://www.oracle.com/database/sqldeveloper/technologies/db-actions/download/
Notre installation sera en mode autonome.
3) Téléchargez la version 11 du JDK ou une version plus récente. Dans notre cas, il s'agit de la version 23.
https://www.oracle.com/java/technologies/downloads/?er=221886#java23
ÉTAPES À SUIVRE POUR L'INSTALLATION D'APEX
Dans ce billet, nous supposons qu'une base de données Oracle est déjà installée, dans notre cas Oracle 19.20 sur le système d'exploitation Red Hat Enterprise Linux 9.
1) CRÉER LE TABLESPACE OÙ L'INSTALLATION D'APEX AURA LIEU
Nous créons un nouveau tablespace, que nous allons nommer APEX, dans lequel nous allons effectuer l'installation.
SQL> CREATE BIGFILE TABLESPACE APEX DATAFILE SIZE 500M AUTOEXTEND ON next 1G MAXSIZE UNLIMITED ;
- Nous vérifions qu'il a été installé correctement
SQL> select name from v$tablespace where name='APEX' ;
Une fois que vous avez téléchargé les ressources énumérées au début de l'article, vous devez extraire les fichiers d'installation d'Apex
et d'Ords dans un dossier spécifique pour chacune des installations.
2) INSTALLATION D'ORACLE APEX
Nous allons dans le dossier où les fichiers apex ont été extraits, où se trouve le fichier apexins.sql
Le format d'installation est le suivant :
- @apexins.sql tablespace_apex tablespace_files tablespace_temp images
SQL> @apexins.sql APEX APEX APEX TEMP /i/
Après quelques minutes, vous recevrez un message indiquant que l'installation est terminée.
3) CRÉATION D'UN COMPTE ADMINISTRATEUR APEX
Une fois l'exécution de la commande précédente terminée, exécutons le script apxchpwd.sql qui créera le compte administrateur de l'instance dont le nom par défaut est ADMIN. Dans notre cas, nous laissons l'utilisateur ADMIN.
Les éléments suivants doivent être pris en compte lors du choix du mot de passe de l'utilisateur administrateur :
* Password must contain at least one punctuation character (!»`’#$%&()[]{},.*+-/|\:;?_~).
SQL> @apxchpwd.sql
...set_appun.sql
Ce script peut être utilisé pour modifier le mot de passe d'un administrateur d'instance Oracle APEX. Si l'utilisateur n'existe pas encore, un enregistrement d'utilisateur sera créé.
Entrez le nom d'utilisateur de l'administrateur [ADMIN]
L'utilisateur "ADMIN" n'existe pas encore et sera créé.
Entrez l'adresse électronique de ADMIN [ADMIN] rgpinto@oracleconraul.com
Entrez le mot de passe de ADMIN []
L'administrateur d'instance ADMIN a été créé.
4) DÉVERROUILLER UN UTILISATEUR PUBLIC ET DÉFINIR UN MOT DE PASSE.
Déverrouillez l'utilisateur APEX_PUBLIC_USER et attribuez-lui un nouveau mot de passe, car ce compte est créé avec un mot de passe aléatoire lors de l'installation et laisse l'utilisateur verrouillé ; il doit donc être modifié avant de procéder aux configurations. Ce mot de passe ne peut pas contenir de caractères spéciaux.
L'utilisateur APEX_PUBLIC_USER a par défaut le profil DEFAULT, donc si vous voulez éviter l'expiration du mot de passe, vous devez changer le paramètre PASSWORD_LIFE_TIME. Dans mon cas, étant une instance de test, je vais créer un nouveau profil pour que le mot de passe n'expire pas, évidemment dans les environnements productifs ce n'est pas conseillé et pour des raisons de sécurité il est préférable de changer le mot de passe tous les 180 jours, la valeur établie dans le profil DEFAULT.
SQL> CREATE PROFILE "UNLIMITED_PWD_EXPIRATION" LIMIT
CPU_PER_SESSION UNLIMITED
CPU_PER_CALL UNLIMITED
CONNECT_TIME UNLIMITED
IDLE_TIME UNLIMITED
SESSIONS_PER_USER UNLIMITED
LOGICAL_READS_PER_SESSION UNLIMITED
LOGICAL_READS_PER_CALL ILLIMITÉ
PRIVATE_SGA ILLIMITÉ
COMPOSITE_LIMIT ILLIMITÉ
PASSWORD_LIFE_TIME ILLIMITÉ
PASSWORD_GRACE_TIME DEFAULT
PASSWORD_REUSE_MAX ILLIMITÉ
PASSWORD_REUSE_TIME ILLIMITÉ
PASSWORD_LOCK_TIME 1
FAILED_LOGIN_ATTEMPTS 10 ;
Attribuez le nouveau profil à l'utilisateur APEX_PUBLIC_USER. Modifiez le mot de passe et déverrouillez l'utilisateur.
SQL> ALTER USER APEX_PUBLIC_USER PROFILE UNLIMITED_PWD_EXPIRATION;
User altered.
SQL> ALTER USER APEX_PUBLIC_USER IDENTIFIED BY <password> ACCOUNT UNLOCK;
User altered.
5) CONFIGURATION DES SERVICES RESTful
Dans ce point, nous allons configurer Oracle REST Data Services comme un serveur web, où les fichiers statiques sont livrés par le module de service RESTful intégré dans Oracle APEX. Pour ce faire, nous devons exécuter le fichier apex_rest_config.sql.
Ce processus crée deux nouveaux comptes de base de données, nous devons donc attribuer le mot de passe aux utilisateurs nouvellement créés.
SQL> @apex_rest_config.sql
Procédure PL/SQL terminée avec succès.
.
.
.
Procédure PL/SQL terminée avec succès.
Entrez un mot de passe pour l'utilisateur APEX_LISTENER []
Entrez un mot de passe pour l'utilisateur APEX_REST_PUBLIC_USER []
6) DISABLE Oracle XML DB Protocol Server, s'il n'est pas déjà désactivé.
Nous désactivons le serveur de protocole XML pour éviter que le port à configurer ne soit utilisé.
6.1 - Nous vérifions qu'il est désactivé :
Dans le cas contraire, nous exécutons ce qui suit :
EXEC DBMS_XDB.SETHTTPPORT(0) ;
7. ACCÈS À LA BASE DE DONNÉES (ACL)
Par défaut, les services réseau qui vous permettent de vous connecter à l'utilisateur de la base de données qui possède le schéma APEX sont désactivés. Vous devez donc utiliser le paquet DBMS_NETWORK_ACL_ADMIN pour accorder des privilèges de connexion à cet utilisateur.
Avant de lancer la commande, vous devez déterminer quel hôte vous allez autoriser à se connecter à APEX.
- Si nous voulons accorder des privilèges de connexion à n'importe quel hôte pour la base de données propriétaire du schéma APEX, nous utiliserons *.
- Si nous voulons accorder des privilèges de connexion uniquement aux serveurs fonctionnant sur le même hôte que la base de données, nous utiliserons localhost.
Connecté en tant que DBA, nous exécutons la commande suivante. Dans notre cas, nous allons utiliser * pour donner des permissions de connexion à n'importe quel hôte.
SQL> BEGIN
DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
host => '*',
ace => xs$ace_type(privilege_list => xs$name_list('connect'),
principal_name => APEX_APPLICATION.g_flow_schema_owner,
main_type => xs_acl.ptype_db)) ;
END ;
/
La procédure PL/SQL s'est achevée avec succès.
SQL>
8) INSTALLATION du service de données ORACLE REST (ORDS)
Nous créons un répertoire dans lequel l'installation aura lieu. Dans notre cas, il s'agit de /u01/ords.
unzip ords-24.4.0.345.1601.zip -d /u01/ords/
8.1) En dehors du répertoire ords, suivant les spécifications d'Oracle, nous créons un répertoire config, où nous indiquerons plus tard la configuration ORDS.
mkdir -p /u01/ords_install/config
8.2) Nous créons un dossier d'images.
mkdir /u01/ords/images
Copiez toutes les images du répertoire "images" de votre installation APEX vers le répertoire "images" de votre ORDS.
cp -r images/ /u01/ords/
Créez un dossier log, en dehors du répertoire ords.
mkdir -p /u01/ords_install/logs
9) INSTALLATION DE JAVA
Avant de commencer l'installation d'ORDS, il est nécessaire d'avoir la version Java d'Oracle requise par la version d'Apex sur votre système. Selon la version d'Oracle Apex, la version supportée de Java change, pour notre version Java 11 ou 17 est nécessaire.
Nous vérifions notre version actuelle :
[oracle@localhost ords]$ java -version
openjdk version "1.8.0_272"
OpenJDK Runtime Environment (build 1.8.0_272-b10)
OpenJDK 64-Bit Server VM (build 25.272-b10, mixed mode)
[oracle@localhost ords]$
Nous mettons à jour la version Java comme suit :
[oracle@localhost softwareapex]$ sudo rpm -iv jdk-23_linux-x64_bin.rpm
Nous vérifions à nouveau la version et nous nous assurons qu'elle a été correctement mise à jour :
[oracle@localhost softwareapex]$ java -version
java version "23.0.2" 2025-01-21
Java(TM) SE Runtime Environment (build 23.0.2+7-58)
Java HotSpot(TM) 64-Bit Server VM (build 23.0.2+7-58, mixed mode, sharing)
10 CRÉATION DES MOTS.
Nous créons un nouveau tablespace pour contenir les données ORDS.
SQL> CREATE BIGFILE TABLESPACE ORDS DATAFILE SIZE 500M AUTOEXTEND ON next 1G MAXSIZE UNLIMITED ;
Tablespace créé.
Lancer l'installation. Dans le dossier bin du répertoire ords, nous lançons la commande suivante.
./ords --config /u01/ords_install/config install --interactive --log-folder /u01/ords_install/logs
Il est important de noter que le paramètre -config indique le répertoire de configuration : Le paramètre -config pointe vers le répertoire de configuration et le paramètre -log-folder indique où seront hébergés les fichiers journaux d'ords.
Nous choisissons la base de données où l'installation aura lieu.
Oracle REST Data Services - Interactive Install
Entrez un nombre pour sélectionner le nom du service TNS net à utiliser à partir de /u01/app/oracle/product/19/dbhome_1/network/admin/tnsnames.ora ou spécifiez la connexion à la base de données
[1] TEST SERVICE_NAME=test
[S] Spécifiez la connexion à la base de données
Choisissez [1] :
Nous passons en revue les valeurs d'installation et en modifions certaines pour les adapter à nos besoins. Une fois ces valeurs définies, nous utilisons l'option [A] et l'installation commence. Notre installation se fera avec le protocole HTTP.
Introduzca un número para actualizar el valor, o bien seleccione la opción A para aceptar y continuar
[1] Tipo de conexión: TNS
[2] Conexión TNS: TNS_NAME=TEST TNS_FOLDER=/u01/sw/network/admin
Usuario administrador: SYS AS SYSDBA
[3] Contraseña de base de datos para usuario de tiempo de ejecución de ORDS (ORDS_PUBLIC_USER): <contraseña especificada>
[4] Usuario de tiempo de ejecución de ORDS y tablespaces de esquema: Valor por defecto: ORDS Temporal TEMP
[5] Función adicional: Acciones de Base de Datos
[6] Configurar e iniciar ORDS en modo autónomo: Sí
[7] Protocolo: HTTP
[8] Puerto HTTP: 8080
[9] Ubicación de recursos estáticos de APEX:
[A] Aceptar y continuar - Crear configuración e instalar ORDS en la base de datos
[Q] Salir - No continuar. Sin cambios
Une fois l'installation terminée, nous pouvons lancer l'exécutable ORDS pour accéder à Apex via le Web.
Dans le dossier ords bin, nous lançons manuellement la commande suivante :
./ords --config /u01/ords_install/config serve --port 8080 --apex-images /u01/ords_install/config serve --port 8080 --apex-images /u01/ords/images
Si tout est correct, il serait pratique de créer un script de démarrage/arrêt pour le service.
Vous pouvez maintenant accéder à votre page d'accueil APEX.
http://localhost:8080/ords
Écran initial après l'installation d'Oracle Apex.
