Post on 28-Jul-2020
Oracle APEX 5.1 – Installations Oracle XE 11.2, Apex 5.1.3, Apache Tomcat et ORDS [591 d] Jean-Pierre LOISON, tous droits réservés
Document mis à jour le 2 juillet 2019
1 – Eléments logiciels à installer et versions Versions les plus récentes à la date du 31/10/2017
Oracle XE 11.2 Windows 64bits
version du 4/6/2014
http://www.oracle.com/technetwork/database/database-technologies/express-edition/downloads/index.html
Oracle Apex 5.1.3
version 5.1.3.00.05 du 26/9/2017
http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html
Oracle REST Data Services (appelé auparavant Oracle APEX Listener)
version 3.0.12.263.15.32 du 29/9/2017
http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html
Apache Tomcat, serveur HTTP
version 7.0.82
http://apache.crihan.fr/dist/tomcat/tomcat-7/v7.0.82/bin/apache-tomcat-7.0.82.exe
2 – Installation Oracle XE 11.2 pour Windows 64bits
2.1 - Décompression du document OracleXE112_Win64.zip
2.2 - Sélection du document
C:\Telechargements\OracleXE112_Win64\DISK1\setup.exe
et exécution en tant qu'administrateur
2.3 – Cliquer sur Next plusieurs fois
2.4 - Introduire un mot de passe
de 8 caractères au moins, avec majuscule/minuscule, chiffre(s), et au moins un caractère tel que _
2.5 - Cliquer sur Install
2.6 - Cliquer sur Finish
2.7 - Maintenant vérifions la bonne installation d' Oracle XE 11.2
Ouvrons une nouvelle fenêtre de commandes, et connectons nous à Oracle XE 11.2 avec sqlPlus :
sqlplus / as sysdba
Puis demandons l'affichage des produits installés et de leurs versions :
select product || ' --> ' || version from product_component_version;
Terminons par deux exit pour "sortir" de SQLplus, puis fermer la fenêtre de commandes.
3 - Installation Oracle APEX 5.1.3
3.1 - Décompression du document apex_5.1.3.zip
3.2 - Créons un répertoire (à usage temporaire) nommé apex513 au premier niveau d'un volume, par exemple c:\apex513
3.3 - Copions le répertoire décompressé nommé apex, et tous ses sous-répertoires, au premier niveau du répertoire c:\apex513
3.4 - Ouvrons une fenêtre de commandes en mode administrateur
3.5 - Dans cette fenêtre de commandes "plaçons nous dans le sous-répertoire apex" (du répertoire apex513):
3.6 - connectons nous à Oracle XE 11.2 en mode administration Oracle
sqlplus / as sysDBA
3.7 – Installation de la nouvelle version d’ Oracle Apex.
Une version antérieure d' Apex est pré-installée avec Oracle XE 11.2
La commande suivante va installer la version 5.1.4 d' Oracle Apex en convertissant automatiquement les éventuels espaces de travail et applications :
@apexins SYSAUX SYSAUX TEMP /i/
Un long script de commandes Oracle DDL et de blocs PL/SQL s'exécute alors.
Au bout de quelques minutes, l'écran suivant est affiché, qui fournit quelques informations utiles:
3.8 – Installation des images et éléments « statiques » de la nouvelle version d’ Oracle Apex.
- Il faut maintenant lancer la copie des images, feuilles de styles et scripts java depuis le répertoire images de la mise à jour vers le répertoire XDB / WebDAV où les fichiers "statiques" sont stockés dans Oracle XE.
- On se connecte à la base, en mode DOS ("invite de commande"), avec SQL Plus, en tant qu’administrateur Windows et DBA Oracle
cd C:\ap513\apex
sqlplus / as sysdba
- Le lancement de la copie des images vers XDB / WebDAV est effectué par le lancement d'un script SQL Plus :
@apxldimg.sql c:\apex513
- Il faut respecter exactement les espaces dans la syntaxe de cette commande :
Au bout de quelque temps, un message informe de la bonne recopie des images depuis le répertoire d'installation vers le dossier virtuel en technologie WebDAV, géré par Oracle avec son package XDB.
3.9 - Réinitialisation du mot de passe d'administration "générale" d' Apex
Une dernière commande à lancer en mode "DOS", depuis SQL Plus, est la réinitialisation du mot de passe d'administration d' Apex.
Ultérieurement il sera également possible de lancer cette commande à tout moment si vous avez "perdu" des mots de passe.
Vous pourrez à nouveau accéder ainsi à la fonction d'administration générale d'Apex, qui vous permettra si besoin d'intervenir sur les mots de passe des "espaces de travail".
Ouvrons une nouvelle fenêtre de commandes, en mode administration, et connectons nous à Oracle XE 11.2, depuis le répertoire c:\apex513\apex :
Introduisons la commande de réinitialisation de mot de passe:
@apxchpwd
Introduire un mode passe de 8 caractères au moins, avec majuscule/minuscule, chiffre(s), et au moins un caractère tel que _
3.10 - Connexion en tant qu'administrateur général d' Apex :
Cette connexion est effectuée en utilisant le serveur web intégré à Oracle, en indiquant le port 8080, celui spécifié lors de l’installation d’ Oracle XE :
http://localhost:8080/apex/apex_admin
Vérifions la version d’ Apex, il s’agit bien de la version 5.1.3 :
4 - Installation Apache Tomcat
1) Lancer l'exécutable pour Windows nommé apache-tomcat-7.0.82.exe, en tant qu'administrateur du poste de travail Windows
Accepter plusieurs fois, en cliquant sur « Next > »
Accepter en cliquant sur "I agree"
Tout sélectionner, puis cliquer sur Next
Indiquer le port 8081, puisque le port 8080 est déjà utilisé par le serveur HTTP intégré à Oracle.
Indiquer User name et Password (sans oublier de les noter !)
Indiquer l'adresse de la machine virtuelle JAVA (JRE)
En principe, elle est directement proposée
Indiquer le dossier dans lequel Apache Tomcat va être installé, au premier niveau du volume, on choisit de le nommer tomcat7078, puis cliquer sur
Etre au premier niveau du volume, rendra plus facile l'accès ultérieur à ce dossier.
L'installation est terminée:
Un répertoire a été créé:
Si on examine les services Windows, on trouve le service Tomcat7 , dans le statut "en cours d'exécution"
Depuis un navigateur web, on peut introduire :
localhost:8081
et on obtient:
Terminons en arrêtant le service Tomcat pour éviter un conflit de ports avec le mode "Standalone" d' Oracle REST, qui sera abordé ensuite
Ce sera effectué avec l'utilitaire "Configure Tomcat" :
Cliquer sur "Stop"
5 - Configuration ORDS et Apex Listener
5.1 - Réinitialisation du mot de passe du compte APEX_PUBLIC_USER et autres actions
Executer les commandes, depuis SQL Plus :
alter user apex_public_user account unlock;
alter user apex_public_user identified by ??? ; (où ??? est le mot de passe choisi par vous)
alter profile default limit failed_login_attempts unlimited password_life_time unlimited;
5.2 - Configuration du service RESTful
Exécuter la commande depuis SQL Plus :
@apex_rest_config.sql
Aux questions sur les mots de passe APEX_LISTENER et APEX_REST_PUBLIC_USER introduire ces mots de passe.
5.3 - Vérifier que ces deux schémas ont bien été créés dans la base Oracle:
Ici avec SQL Developer :
5.4 - Vérifions que l'accès à Apex via le serveur web intégré à Oracle fonctionne toujours
http://localhost:8080/apex/apex_admin
5.5 Décompression du document ords.3.0.12.263.15.32.zip
Copions le contenu décompressé de ce dossier dans un nouveau répertoire nommé
C:\ords3012
5.6 - Créons un sous-répertoire nommé conf au premier niveau du répertoire C:\ords3012
5.7 - Modifions le document ords_params.properties situé dans le répertoire C:\ords3012\params
De la façon suivante :
db.hostname=localhost
db.port=1521
db.servicename=XE
db.sid=
db.username=APEX_PUBLIC_USER
migrate.apex.rest=false
rest.services.apex.add=
rest.services.ords.add=true
schema.tablespace.default=SYSAUX
schema.tablespace.temp=TEMP
standalone.http.port=8081
standalone.static.images=C:/apex513/apex/images
user.tablespace.default=USERS
user.tablespace.temp=TEMP
5.8 - Lançons la construction du document ords.war, depuis une fenêtre de commandes, en mode administration
cd ords3012
java -jar c:\ords3012\ords.war
Répondre aux différentes questions:
emplacement dans lequel stocker les données de configuration: c:/ords3012/conf
mot de passe ORDS_PUBLIC_USER: xxx
confirmation: xxx
user avec privileges DBA: SYS
mot de passe: xxx
confirmation: xxx
Pour Apex, entrez: 1
mot de passe APEX_PUBLIC_USER: xxx
confirmation: xxx
Indication d'autres mots de passe, entrez: 1
mot de passe APEX_LISTENER: xxx
confirmation: xxx
mot de passe APEX_REST_PUBLIC_USER: xxx
confirmation: xxx
Affichage du compte-rendu:
5.9 - Entrer 1 pour lancer en mode autonome :
Affichage des commandes effectuées:
5.10 – Tester l’accès via un navigateur:
localhost:8081/ords/apex_admin
Apex Listener/ORDS fonctionne et permet d'accéder, en mode autonome, à Oracle Apex
6 - Intégration dans Apache Tomcat de la configuration ORDS / Apex Listener
6.1 - Arrêter le service TomCat
6.2 - Copier le document C:\ords3012\ords.war dans le dossier C:\tomcat7078\webapps
6.3 - Démarrer le service TomCat
Apache créée de façon automatique un répertoire nommé C:\tomcat7078\webapps\ords
à partir du document ords.war
6.4 - Copier le répertoire C:\apex513\apex\images vers un nouveau dossier
nommé C:\tomcat7078\webapps\i
Ce répertoire contient les images et documents statiques nécessaires à Oracle APEX
6.5 - Arrêter puis redémarrer le service Apache TomCat
6.6 - Lancer Apex en utilisant le serveur HTTP Apache Tomcat / ORDS :
http://localhost:8081/ords/
Cela fonctionne :
6.7 – Vérifier que l'accès via le serveur web intégré fonctionne toujours :
localhost:8080/apex/apex_admin
C’est utile de maintenir ces deux façons différentes d’accéder à Apex, en particulier dans le cas, où on va se livrer ensuite à des essais de configurations spécifiques d’Apache Tomcat.
Jean-Pierre LOISON, consultant
https://rcitools.eu/
Blog relatif à Oracle APEX, tenu à jour par Jean-Pierre LOISON depuis 2004: http://rcitools.blogspot.fr/