Page History

Versions Compared

Old Version 6

changes.mady.by.user Yohan Colmant

Saved on

compared with

New Version Current

changes.mady.by.user Yohan Colmant

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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
maxLevel2
minLevel1

...

indent20px
styledisc

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 :

  • Wiki Markup*\[PORT_xxx_HTTP\]* Port pour le HTTP.unmigrated-wiki-markup
  • *\[PORT_xxx_SHUTDOWN\]* Port pour le shutdown.
  • Wiki Markup*\[PORT_xxx_AJP\]* Port pour l'AJP.unmigrated-wiki-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] Wiki Markup+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:

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:

\ant start-repository
ou
[PATH_TOMCAT_REPOSITORY\]/bin/startup.sh

Panel

Wiki Markup

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
ou
\ [PATH_TOMCAT_MD_EDITOR\]/bin/startup.sh

Wiki Markuppuis testez l'url : *http:// \ [HOST_INSTALL\] :8186*

\ant start-workflow
ou
[PATH_TOMCAT_WORKFLOW\]/bin/startup.sh

Panel

Wiki Markup

...

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

\ant start-search
ou
[PATH_TOMCAT_SEARCH\]/bin/startup.sh

Panel

Wiki Markup

...

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

\ant start-vocabulary
ou
[PATH_TOMCAT_VOCABULARY\]/bin/startup.sh

Panel

Wiki Markup

...

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

\ant start-indexing
ou
[PATH_TOMCAT_INDEXING\]/bin/startup.sh

Panel

Wiki Markup

...

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

\ant start-harvester
ou
[PATH_TOMCAT_HARVESTER\]/bin/startup.sh

Panel

Wiki Markup

...

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
ant stop-md-editor
ant stop-workflow
ant stop-search
ant stop-vocabulary
ant stop-indexing
ant stop-harvester

ou

Panel

ant stop

ou

\[PATH_TOMCAT_REPOSITORY\]/bin/shutdown.sh \
[PATH_TOMCAT_MD_EDITOR\]/bin/shutdown.sh \
[PATH_TOMCAT_WORKFLOW\]/bin/shutdown.sh \
[PATH_TOMCAT_SEARCH\]/bin/shutdown.sh \
[PATH_TOMCAT_VOCABULARY\]/bin/shutdown.sh \
[PATH_TOMCAT_INDEXING\]/bin/shutdown.sh \
[PATH_TOMCAT_HARVESTER\]/bin/shutdown.sh

Panel

Wiki Markup

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

...

...