...
Il est recommandé dans la phase d'installation et de prise en main d'installer un tomcat pour un module. Ceci permettra de mieux débugger en cas de problème. Une fois la configuration des modules faites, si vous le souhaitez, vous pourrez basculer sur un seul tomcat.
Table of Contents | ||||
---|---|---|---|---|
|
...
|
Installation de plusieurs Tomcat
...
Dans le dossier utils de ORI-OAI-quick-install, vous pouvez trouver un Tomcat 6.0.24 37 pré-configuré pour ORI-OAI (notamment pour un encodage UTF-8). Ce Tomcat est prêt au fonctionnement, mais les numéros de port utilisés ont été remplacés par des variables tout comme dans les fichiers de configuration de ORI-OAI. Il existe donc différentes tâches ANT qui vont permettre l'installation d'un ou plusieurs serveurs Tomcat à l'endroit que vous aurez défini et utilisant les numéros de port configurés dans tomcat.properties.
Les configurations des ports ne sont à priori pas à modifier. Ils se trouvent dans le fichier "tomcat.properties" et sont de la forme :
*\[PORT_xxx_HTTP\]* Port pour le HTTP.unmigrated-wiki-markupWiki Markup - *\[PORT_xxx_SHUTDOWN\]* Port pour le shutdown.
*\[PORT_xxx_AJP\]* Port pour l'AJP.unmigrated-wiki-markupWiki Markup - *\[PORT_xxx_SSL\]* Port pour le SSL.
En revanche, il est nécessaire de dire où seront installés les différents serveurs Tomcat, pour cela éditez le fichier de configuration commons-parameters.properties avec les données suivantes :
Code Block |
---|
...
###########################################################
# Paramètres ori-oai-repository
###########################################################
# Racine du serveur Tomcat sur lequel est déployé ori-oai-repository
PATH_TOMCAT_REPOSITORY=[ORI_HOME]/tomcat-repository
...
###########################################################
# Paramètres ori-oai-harvester
###########################################################
# Racine du serveur Tomcat sur lequel est déployé ori-oai-harvester
PATH_TOMCAT_HARVESTER=[ORI_HOME]/tomcat-harvesting
...
###########################################################
# Paramètres ori-oai-indexing
###########################################################
# Racine du serveur Tomcat sur lequel est déployé ori-oai-indexing
PATH_TOMCAT_INDEXING=[ORI_HOME]/tomcat-indexing
...
###########################################################
# Paramètres ori-oai-vocabulary
###########################################################
# Racine du serveur Tomcat sur lequel est déployé ori-oai-vocabulary
PATH_TOMCAT_VOCABULARY=[ORI_HOME]/tomcat-vocabulary
...
###########################################################
# Paramètres ori-oai-search
###########################################################
# Racine du serveur Tomcat sur lequel est déployé ori-oai-search
PATH_TOMCAT_SEARCH=[ORI_HOME]/tomcat-search
...
###########################################################
# Paramètres ori-oai-workflow
###########################################################
# Racine du serveur Tomcat sur lequel est déployé ori-oai-workflow
PATH_TOMCAT_WORKFLOW=[ORI_HOME]/tomcat-workflow
...
###########################################################
# Paramètres ori-oai-md-editor
###########################################################
# Racine du serveur Tomcat sur lequel est déployé ori-oai-md-editor
PATH_TOMCAT_MD_EDITOR=[ORI_HOME]/tomcat-md-editor
...
|
Notez qu'il vous est aussi demandé des chemins concernant l'installation de Nuxeo (ESUP-ECM) et ori-oai-nuxeo pour le stockage des documents. Ces chemins ne sont pas utilisés lors de l'installation des serveurs Tomcat étant donné que Nuxeo (ESUP-ECM intègrent un serveur JBOSS) intègre son propre serveur Tomcat.
Voici pour information les chemins à renseigner pour l'installation :
Code Block |
---|
########################################################### # Paramètres esup-ecm ########################################################### # Dossier parent dans lequel est installé esup-ecm PATH_ECM_PARENT=[ORI_HOME]/esup-ecm ... ########################################################### # Paramètres ori-oai-nuxeo ########################################################### # Racine du serveur jbosstomcat sur lequel est déployé ori-oai-nuxeo PATH_JBOSSTOMCAT_NUXEO=[ORI_HOME]/esup-ecm/nuxeo-dm-5.24.01-tomcat ... |
Les tâches ANT disponibles dans ORI-OAI-quick-install sont les suivantes:
...
- *install-tomcat-\[NOM_MODULE\]* pour lancer l'installation du Tomcat dans lequel sera déployé le module *\[NOM_MODULE\]*.
+
Exemple+: ant install-tomcat-workflow
...
Dans ce cas, le Tomcat sera installé dans le dossier spécifié par la variable \ [PATH_TOMCAT_WORKFLOW\] et configuré en utilisant les numéros de port \ [PORT_WORKFLOW_HTTP\], \ [PORT_WORKFLOW_SHUTDOWN\], \ [PORT_WORKFLOW_AJP\] et \ [PORT_WORKFLOW_SSL\] du fichier "tomcat.properties". Attention, l'installation du Tomcat ne se fera que si le paramètre ori-oai-\[NOM_MODULE\].src.dir est présent et non commenté.
- install-tomcat-alltomcats pour lancer l'installation d'un serveur Tomcat pour chaque module (sauf pour Nuxeo (ESUP-ECM et ori-oai-nuxeo qui intègrent un serveur JBOSS).) intègre son propre serveur Tomcat).
Note :
Il est possible de regrouper différents modules sur un même serveur Tomcat. Dans ce cas, vous pouvez spécifier les mêmes ports pour ces modules et ne lancer qu'une fois la tâche ant install-tomcat-[NOM_MODULE] +Note+ :
Il est possible de regrouper différents modules sur un même serveur Tomcat. Dans ce cas, vous pouvez spécifier les mêmes ports pour ces modules et ne lancer qu'une fois la tâche *ant install-tomcat-\[NOM_MODULE\]*. Wiki Markup
Tous les Tomcat sont donc maintenant installés et prêts à l'emploi avec les configurations suivantes:
MODULE / PORT | Shutdown | Non SSL (Valeur de la variable PORT* à modifier dans les configurations)_ | SSL | AJP 1.3 | Nom du contexte de déploiement du module |
Repository | 8280 | 8180 (PORT_REPOSITORY) | 8480 | 8380 | ori-oai-repository |
Harvester | 8281 | 8181 (PORT_HARVESTER) | 8481 | 8381 | ori-oai-harvester |
Indexing | 8282 | 8182 (PORT_INDEXING) | 8482 | 8382 | ori-oai-indexing |
Vocabulary | 8283 | 8183 (PORT_VOCABULARY) | 8483 | 8383 | ori-oai-vocabulary |
Search | 8284 | 8184 (PORT_SEARCH) | 8484 | 8384 | ori-oai-search |
Workflow / EXT | 8285 | 8185 (PORT_WORKFLOW) | 8485 | 8385 | ori-oai-workflow |
Editeur | 8286 | 8186 (PORT_MD_EDITOR) | 8486 | 8386 | ori-oai-md-editor |
Notez également les informations concernant le serveur JBOSS déployé automatiquement lors de l'installation de ESUP-ECM:
MODULE / PORT | Shutdown | Non SSL (Valeur de la variable PORT* à modifier dans les configurations)_ | SSL | AJP 1.3 | Proxy | Nom du contexte de déploiement du module |
ECM | 8287 | 8187 (PORT_ECM) | 8487 | 8387 | 8587 | nuxeo |
Vous pouvez passer à la phase de test.
...
Exécutez les commandes suivantes:
Panel | |
---|---|
|
Vous devriez obtenir l'affichage suivant :
...
Ouvrez un navigateur web à l'adresse :
Code Block |
---|
http://[HOST_INSTALL]:8180
|
...
Recommencez la manipulation en exécutant successivement les commandes:
Panel |
---|
unmigratedant start-wikimd-markupeditor |
puis testez l'url : *http:// \ [HOST_INSTALL\] :8186* Wiki Markup
Panel | |
---|---|
|
...
puis testez l'url : *http:// \ [HOST_INSTALL\] :8185*
Panel | |
---|---|
|
...
puis testez l'url : *http:// \ [HOST_INSTALL\] :8184*
Panel | |
---|---|
|
...
puis testez l'url : *http:// \ [HOST_INSTALL\] :8183*
Panel | |
---|---|
|
...
puis testez l'url : *http:// \ [HOST_INSTALL\] :8182*
Panel | |
---|---|
|
...
puis testez l'url : *http:// \ [HOST_INSTALL\] :8181*
Une fois que tous les tests sont validés et que tous vos serveurs Tomcat sont maintenant opérationnels, vous pouvez les stopper avant de commencer l'installation des modules ORI-OAI :
Panel |
---|
ant stop-repository |
ou
Panel |
---|
ant stop |
ou
Panel | |
---|---|
|
Installation d'un unique Tomcat
Les configurations des ports ne sont à priori pas à modifier. Ils se trouvent dans le fichier tomcat.properties et sont de la forme :
...
- *\[PORT_ONE_HTTP\]* Port pour le HTTP.unmigrated-wiki-markup
- *\[PORT_ONE_SHUTDOWN\]* Port pour le shutdown.unmigrated-wiki-markup
- *\[PORT_ONE_AJP\]* Port pour l'AJP.unmigrated-wiki-markup
- *\[PORT_ONE_SSL\]* Port pour le SSL.
En revanche, il est nécessaire de dire où sera installé le serveur Tomcat, pour cela éditez le fichier de configuration commons-parameters.properties avec les données suivantes :
Code Block |
---|
...
###########################################################
# Paramètres communs aux applications
###########################################################
# Chemin vers le serveur tomcat en cas d'utilisation d'un unique Tomcat pour tous les modules
PATH_TOMCAT=[ORI_HOME]/tomcat
...
|
...