Depuis la version 1.6, il est possible d'installer automatiquement un tomcat par module ou d'installer tous les modules sur un seul Tomcat.

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.

Installation de plusieurs Tomcat

Installation et déploiement des Tomcat

Pour des raisons de performances et d'indépendance des modules, nous préconisons dans un premier temps l'utilisation d'un serveur Tomcat pour chaque module ORI-OAI. Une fois l'installation complète terminée ainsi que la configuration avancée de tous les modules, vous pourrez regrouper si vous le souhaitez plusieurs modules dans un même Tomcat.

En plus de proposer une installation rapide et simplifiée de ORI-OAI, ORI-OAI-quick-install vous propose l'installation de différents serveurs Tomcat pour l'installation de vos modules.

En effet, dans le cas où vous souhaitez installer un Tomcat par module dans une première étape, ou même regrouper différents modules sur un même Tomcat, il existe une procédure d'installation automatique.

Cette fonctionnalité est bien entendu optionnelle. Elle n'entre nullement en jeu dans l'installation de ORI-OAI et vous pouvez par conséquent utiliser un Tomcat que vous aurez vous-même installé en dehors de ORI-OAI-quick-install.

Dans le dossier utils de ORI-OAI-quick-install, vous pouvez trouver un Tomcat 6.0.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.
• [PORT_xxx_SHUTDOWN] Port pour le shutdown.
• [PORT_xxx_AJP] Port pour l'AJP.
• [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 :

...

###########################################################
# 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ègre son propre serveur Tomcat.
Voici pour information les chemins à renseigner pour l'installation :

###########################################################
# 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 tomcat sur lequel est déployé ori-oai-nuxeo
PATH_TOMCAT_NUXEO=[ORI_HOME]/esup-ecm/nuxeo-dm-5.4.1-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-tomcats pour lancer l'installation d'un serveur Tomcat pour chaque module (sauf pour Nuxeo (ESUP-ECM) 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].

Tous les Tomcat sont donc maintenant installés et prêts à l'emploi avec les configurations suivantes:

Vous pouvez passer à la phase de test.

Test des serveurs

Vous pouvez maintenant lancer et tester les serveurs Tomcat pour savoir si l'installation s'est bien déroulée.

Exécutez les commandes suivantes:

Vous devriez obtenir l'affichage suivant :

Ouvrez un navigateur web à l'adresse :

http://[HOST_INSTALL]:8180

Vous devriez obtenir l'affichage suivant :

Recommencez la manipulation en exécutant successivement les commandes:

puis testez l'url : http:// [HOST_INSTALL] :8186

puis testez l'url : http:// [HOST_INSTALL] :8185

puis testez l'url : http:// [HOST_INSTALL] :8184

puis testez l'url : http:// [HOST_INSTALL] :8183

puis testez l'url : http:// [HOST_INSTALL] :8182

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 :

ou

ou

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.
• [PORT_ONE_SHUTDOWN] Port pour le shutdown.
• [PORT_ONE_AJP] Port pour l'AJP.
• [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 :

...

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

...

A cette étape, vous n'avez donc qu'à lancer l'installation du Tomcat par la commande :

Le Tomcat sera donc maintenant installés et prêt à l'emploi avec les configurations suivantes :