Configuration manuelle d'Apache Tomcat avec ou sans Apache HTTP Server

Préparation de Tomcat pour la configuration WebFOCUS

Comment :

Pour préparer Tomcat avec WebFOCUS, vous devez choisir comment créer les graphiques WebFOCUS et ajouter le pilote JDBC ReportCaster.

Haut de page

Comment : Configurer Tomcat pour les graphiques WebFOCUS

Pour générer des graphiques, les servlets WebFOCUS doivent disposer d'un accès à un serveur X Windows, ou utiliser l'option Java VM headless. Vous pouvez la renseigner en éditant le fichier catalina.sh :

DISPLAY. Si un serveur X Windows est disponible, vous devriez renseigner une variable d'environnement DISPLAY. Ouvrez le fichier suivant dans un éditeur de texte :
```
/tomcat_home/bin/catalina.sh
```
En début de fichier, après la section commentaire, ajoutez la définition DISPLAY correcte. Par exemple :
```
DISPLAY=xserver_host:0.0
export DISPLAY
TERM=xterm
export TERM
```
où :

xserver_host

est le nom d'hôte ou l'adresse IP d'une machine sous environnement X Server.

Remarque : les graphiques ne sont pas affichés effectivement sur la machine pour laquelle DISPLAY renseignée, mais les Servlets WebFOCUS doivent accéder à ce serveur X pour générer les graphiques. Après avoir fini ce chapitre, assurez-vous de réviser les tests pour vérifier les graphiques dans Vérification et dépannage des Graphiques Côté Serveur (PCHOLD).
Headless. Si aucun serveur X Windows n'est disponible, vous pouvez utiliser l'option Java headless. Toutefois, prenez en compte que cette option ne prend pas en charge les fichiers GIF ou l'ancien moteur WebFOCUS GRAPH32. Ouvrez le fichier suivant dans un éditeur de texte :
```
/tomcat_home/bin/catalina.sh
```
Vous pouvez ajouter l'option headless en renseignant la variable $JAVA_OPTS. En début de fichier, après la section commentaire, ajoutez la ligne suivante :
```
export JAVA_OPTS="${JAVA_OPTS} -Djava.awt.headless=true"
```

Haut de page

Comment : Renseigner Tomcat CLASSPATH pour le référentiel WebFOCUS

Avant qu'une application WebFOCUS puisse se connecter au référentiel WebFOCUS, vous devez d'abord ajouter l'emplacement du pilote JDBC au CLASSPATH dans setclasspath.sh.

Ouvrez le fichier suivant dans un éditeur de texte :
```
/tomcat_home/bin/catalina.sh 
```
Trouver la ligne qui renseigne CLASSPATH. Par exemple :
```
CLASSPATH=/home/oracle/oracle/ojdbc6.jar
```
Remarque : si il y a plus d'un fichier jar, ajouter les informations correspondantes séparées par deux-points (:).
Ajoutez un deux-points, suivi du chemin vers les pilotes JDBC pour votre référentiel. Incluez tout fichier ZIP ou JAR. Par exemple :
```
CLASSPATH="$JAVA_HOME"/lib/tools.jar:/home/oracle/oracle/ojdbc6.jar                
```
Remarque : vous devez inclure le chemin complet incluant le nom de fichier. Spécifier un répertoire n'est pas suffisant.
Enregistrez et fermez le rapport.

Déploiement des applications web WebFOCUS avec Tomcat

Comment :

Créer contextes

Référence :

Recharger les applications Web

La configuration de Tomcat nécessite surtout pour indiquer à Tomcat où les fichiers WebFOCUS sont situés et les racines contextuelles dans lesquelles les utiliser. Par exemple, vous devez indiquer à Tomcat qu'il doit servir les fichiers depuis l'application web WebFOCUS :

/install_directory/ibi/WebFOCUS81/webapps/webfocus

Lorsqu'il reçoit une requête pour la racine contextuelle WebFOCUS :

http://TomcatHost:tomcatHTTPport/ibi_apps

En créant ce contexte, vous déployez l'application web WebFOCUS.

Lorsque vous utilisez Tomcat en tant que serveur d'applications et Apache HTTP comme serveur web, créez un seul contexte sur Tomcat :
Context (path): /ibi_apps

Directory (DocumentBase): /install_directory/ibi/WebFOCUS81/webapps/webfocus

Le contexte approot est alors créé en tant qu'alias sur le serveur HTTP. Le serveur HTTP est alors configuré pour envoyer les requêtes ibi_apps à Tomcat. Toutefois, ceci suppose que le serveur HTTP est en charge directe d'un certain contenu WebFOCUS. Si vous souhaitez que le serveur HTTP ne transmette que les requêtes via un pare-feu, ne créez pas d'alias sur le serveur HTTP, configurez plutôt Tomcat pour qu'il gère l'ensemble du contenu WebFOCUS.

Lorsque vous utilisez Tomcat comme un serveur Web et d'applications, les contextes suivants doivent être créés :

Contexte (chemin)

Répertoire (DocumentBase)

/ibi_apps

/install_directory/ibi/WebFOCUS81/webapps/webfocus

/ibi_help

/install_directory/ibi/WebFOCUS81/webapps/ibi_help

/approot

/install_directory/ibi/apps

Contexte (chemin)	Répertoire (DocumentBase)
/ibi_apps	/install_directory/ibi/WebFOCUS81/webapps/webfocus
/ibi_help	/install_directory/ibi/WebFOCUS81/webapps/ibi_help
/approot	/install_directory/ibi/apps

Tomcat peut être utilisé en tant que serveur Web et serveur d'applications, ce qui implique qu'il peut très bien servir des fichiers indépendamment de l'application web tant qu'il connaît leurs emplacements et les contextes associés. Sur un serveur Web traditionnel, vous créez des alias. Avec Tomcat, un alias de serveur Web traditionnel est traité comme une racine de contexte, même lorsqu'en servant des fichiers en dehors d'une application web.

Haut de page

Comment : Créer contextes

Il y a plusieurs façons de créer des contextes :

Vous pouvez créer manuellement des fichiers XML individuels pour chaque application web ou contexte sous /tomcat_home/conf/Catalina/localhost.
Vous pouvez éditer server.xml pour définir les contextes.
Vous pouvez copier webfocus.war dans/tomcat_home/webapps puis le renommer en ibi_apps.war.
Vous pouvez utiliser les outils web Tomcat.

Cette procédure explique comment créer des contextes en utilisant les outils web. Lorsque vous créez un contexte pour une application web, elle est déployée.

Pour créer des contextes pour Tomcat 8, Information Builders recommande de créer ou d'éditer des fichiers XML dans le répertoire suivant :

/tomcat_home/conf/Catalina/localhost

Haut de page

Référence : Recharger les applications Web

Ce n'est pas une considération si vous venez d'installer WebFOCUS pour la première fois, mais vous devriez en tenir compte lorsque vous installez un service pack ou une nouvelle révision. Lorsque vous mettez à niveau WebFOCUS ou installez un service pack, Tomcat doit utiliser la nouvelle application web plutôt que des copies mises en mémoire cache de l'ancienne version.

Si vous installez un service pack dans le même emplacement, et que vous avez déployé les répertoires, les nouvelles applications web devraient être utilisées automatiquement, mais vous devriez supprimer les répertoires de travail suivants, puis redémarrer Tomcat.
```
/tomcat_home/work/Catalina/localhost/ibi_apps
```
```
/tomcat_home/work/Catalina/localhost/ibi_help
```
Remarque : le fichier redirect.war est disponible pour rediriger les applications personnelles avec des contenant rcaster en tant que racine de contexte ReportCaster. Si vous envisagez de déployer ce fichier, vous devriez aussi supprimer le répertoire de travail suivant, puis redémarrer Tomcat :
```
/tomcat_home/work/Catalina/localhost/rcaster
```
Si vous installez dans un emplacement différent ou vous avez déployé les fichiers WAR, vous devez supprimer complètement les contextes WebFOCUS existants, puis les recréer. Pour supprimer les contextes, vous pouvez utiliser Tomcat Manager ou bien supprimer les fichiers et répertoires correspondants du contexte. Par exemple :
```
/tomcat_home/conf/Catalina/localhost/ibi_apps.xml
```
```
/tomcat_home/work/Catalina/localhost/ibi_apps
```
```
/tomcat_home/webapps/ibi_apps
```
Remarque : lorsque vous déployez des fichiers WAR, Tomcat les déploie dans sa propre structure de répertoires, sans forcément connaître l'emplacement original.

Configuration pour Apache HTTP Server

Comment :

Modifier le fichier Apache httpd.conf

Tomcat peut être utilisé avec ou sans Apache HTTP Server.

Si vous utilisez Tomcat sans serveur HTTP, vous devriez avoir créé l'alias approot en tant que contexte Tomcat. Si vous n'utilisez pas HTTP Server, passez à Vérification de la configuration WebFOCUS avec Tomcat et Apache HTTP Server.
Si vous utilisez Tomcat avec HTTP Server, vous devez créer des alias et configurer les communications entre HTTP Server et Tomcat.

Pour créer des alias, éditez le fichier de configuration httpd.conf tel que décrit ci-dessous, en vous assurant d'avoir bien remplacé install_directory par le chemin correct sur votre machine. Si vous avez changé le nom par défaut pour la racine de contexte et les alias WebFOCUS (/ibi_apps), effectuez les substitutions qui s'imposent.

Haut de page

Comment : Modifier le fichier Apache httpd.conf

Avec un éditeur texte, ouvrez le fichier httpd.conf dans le répertoire /apache_home/conf.
Ajoutez les lignes suivantes à la section Alias en vous assurant que vous utilisez un install_directory correct sur votre machine :
- Pointez sur un alias du répertoire apps.
```
Alias /approot/ "/install_directory/ibi/apps/"
```
Par exemple :
```
Alias /approot/ "/home/iadmin/ibi/apps/"
Alias /icons/ "/usr/apache2/icons/"
```
Enregistrez, puis fermez le fichier
Redémarrez HTTP Server.

Connexion entre Apache HTTP Server et Tomcat

Comment :

Il existe plusieurs méthodes de connexion entre Apache HTTP Server et Tomcat. Cette section concerne JK1.2, mod_jk. Si vous souhaitez utiliser une autre approche, en particulier ProxyPass ou JK2, consultez la documentation Apache et Tomcat.

Les fichiers suivants sont nécessaires pour Apache pour se connecter à Tomcat en utilisant JK1.2:

mod_jk.so: Fournit des instructions binaires à Apache pour se connecter à Tomcat. Consultez Télécharger ou construire le fichier mod_jk.so.
workers.properties: Fournit les informations de configuration exigées par mod_jk.so Consultez Créer le fichier mod_jk.conf.
mod_jk.conf: Indique à Apache qu'il doit charger le fichier binaire mod_jk.so et et utiliser la configuration de workers.properties. Consultez Créer le fichier workers_properties.
httpd.conf: Indique à Apache qu'il doit inclure mod_jk.conf. Consultez Editer httpd.conf pour utiliser JK1.2.

Des informations supplémentaires sur l'utilisation du connecteur JK1.2 sont disponibles à l'adresse :

http://tomcat.apache.org/connectors-doc/index.html

Haut de page

Comment : Télécharger ou construire le fichier mod_jk.so

Le fichier binaire mod_jk.so doit faire l'objet d'une compilation spécifique pour votre plate-forme est votre version Apache HTTP Server (1.3 or 2.0). Le code source et binaire peut être téléchargé ici :

http://jakarta.apache.org/tomcat/connectors-doc/index.html

Testez l'application web WebFOCUS en vous dirigeant vers l'URL suivant dans un navigateur :
```
http://TomcatHost:TomcatHTTPport/ibi_apps/diagnostics/about.jsp
```
Une page présentant le build en cours devrait apparaître. Par exemple :
```
Version:WEB81                
```
Si le chargement de la page échoue, redémarrez Tomcat, et assurez-vous qu'il peut compiler les fichiers JSP. Dans certains environnements, une erreur est possible à la première compilation d'un fichier JSP.
Si utilisez Tomcat en tant que serveur Web et serveur d'applications, passez à Vérification de la configuration WebFOCUS avec Tomcat et Apache HTTP Server.

Les binaires que vous téléchargez auront un nom long indiquant la version Apache et celle de la plate-forme. Vous devriez renommer ce fichier en mod_jk.so.

Si un binaire n'est pas disponible pour votre plate-forme, vous pouvez télécharger le code source et le compiler. Si vous faites une recherche en ligne, vous devriez trouver l'information sur la compilation de mod_jk.so. Le fichier compilé peut avoir un nom différent, par exemple libmod_jk.so.

Le fichier mod_jk.so doit être placé sur votre système dans un répertoire sur lequel le serveur HTTP a au moins des permissions de lecture.

Haut de page

Comment : Créer le fichier workers_properties

Si le fichier n'existe pas, créez le fichier suivant dans un répertoire sur lequel le serveur HTTP a au moins des permissions de lecture.
```
workers.properties
```
Par exemple :
```
/apache_home/conf/tomcat/workers.properties
```
Ouvrez le fichier dans un éditeur texte pour éditer ou ajouter le texte suivant, en remplaçant le texte en italique par des chemins absolus :
```
workers.tomcat_home=tomcat_home 
workers.java_home=java_homeps=/
worker.list=ajp13
worker.ajp13.port=8009 
worker.ajp13.host=localhost
worker.ajp13.type=ajp13
```
où :

tomcat_home

est le répertoire d'installation Apache Tomcat. Utilisez un chemin absolu.

java_home

est le répertoire d'installation du JDK Java. Utilisez un chemin absolu.

8009

Est le port Ajp13 définies dans server.xml. Le port par défaut est 8009, fournissez une nouvelle valeur si vous avez changé ceci.

Haut de page

Comment : Créer le fichier mod_jk.conf

Si le fichier n'existe pas, créez le fichier suivant dans un répertoire sur lequel le serveur HTTP a au moins des permissions de lecture.
```
mod_jk.conf
```
Par exemple :
```
/apache_home/conf/tomcat/mod_jk.conf
```

Ouvrez le fichier dans un éditeur texte pour éditer ou ajouter le texte suivant, en remplaçant PATH_TO par des chemins absolus :

<IfModule !mod_jk.c>
  LoadModule jk_module /PATH_TO/mod_jk.so
</IfModule>
JkWorkersFile "/PATH_TO/workers.properties"
JkLogFile "/PATH_TO/tomcatjk1.2/mod_jk.log"
JkLogLevel emerg
JkMount /ibi_apps ajp13
JkMount /ibi_apps/* ajp13

Remarque : si vous changez les racines de contexte par défaut, effectuez une substitution.

Haut de page

Comment : Editer httpd.conf pour utiliser JK1.2

Avec un éditeur texte, ouvrez le fichier httpd.conf dans le répertoire /apache_home/conf.
Ajoutez la ligne suivante à la fin du fichier, en spécifiant où le fichier mod_jk.conf se trouve sur votre système :
```
Include /PATH_TO/mod_jk.conf
```

Vérification de la configuration WebFOCUS avec Tomcat et Apache HTTP Server

Comment :

Vérifier la configuration WebFOCUS

Après avoir terminé la configuration, exécutez les appels de test pour vérifier le fonctionnement.

Haut de page

Comment : Vérifier la configuration WebFOCUS

Redémarrez ce qui suit :
- Serveur de Rapports WebFOCUS
- Tomcat
- Apache HTTP Server (si vous utilisez le serveur HTTP)
Passez à Tâches post-installation WebFOCUS, et lancez l'outil de vérification. Si vous utilisez ReportCaster, assurez-vous de réviser les Tâches Post-Installation WebFOCUS ReportCaster .

N'oubliez pas que vous aurez sans doute à augmenter les paramètres de mémoire Java si vous utilisez InfoAssist. Vous pouvez le faire plus tard, tel que décrit dans Problèmes de mémoire Java.