Lea Linux - Contributions [fr]

Apache et Tomcat

2008-07-15T22:19:23Z

Nulix31 : /* Lien symbolique qui pointe vers la bonne version de Tomcat */

Apache et Tomcat

2008-06-29T22:09:50Z

Nulix31 :

Apache et Tomcat

2008-06-29T22:09:08Z

Nulix31 :

Apache et Tomcat

2008-06-29T22:05:23Z

Nulix31 :

Apache et Tomcat

2008-06-29T21:54:03Z

Nulix31 :

Apache et Tomcat

2008-06-29T21:52:47Z

Nulix31 :

= Introduction =
Apache est un serveur Web : il reçoit des requêtes HTTP émises depuis un navigateur, les analyse et envoie des pages Web en réponse au navigateur.

Lorsque les requêtes HTTP concernent des pages JSP (Java Server Pages), du code Java doit être exécuté pour construire les pages Web qu'Apache doit renvoyer au navigateur. Pour cela, Apache s'appuie sur un moteur de servlets qui prend en charge cette partie du traitement. Tomcat est l'un des moteurs de servlets les plus utilisés.

Pour communiquer entre eux, Apache et Tomcat utilisent un module intermédiaire, tel que mod_jk.

L'objet de cette fiche est de présenter les différentes étapes de l'installation de base d'Apache, Tomcat et mod_jk.

= Installation d'Apache =

== Installation des paquets ==
Il faut commencer par installer le paquet apache2, ainsi que d'autres paquets apache et php qui peuvent s'avérer utiles. 
Par exemple, avec Debian : 
<code multi>$ aptitude install apache2 apache2-doc apache2-mpm-prefork apache2-utils apache2.2-common libapache2-mod-jk libapache2-mod-perl2 libapache2-mod-php5 libapache2-reload-perl php5 php5-cgi php5-cli php5-common php5-curl php5-gd php5-imap php5-ldap php5-mcrypt php5-mhash php5-mysql php5-odbc</code>

== Fichiers de configuration d'Apache ==
Apache2 est en général installé dans /etc/apache2. Ce répertoire contient apache2.conf, le fichier de configuration principal d'Apache.

Remarque : apache2.conf peut faire appel à d'autres fichiers de configuration, via la directive "Include". Ainsi, lorsqu'on décrit des modifications à apporter à apache2.conf, il se peut selon les configurations que ces modifications soient à apporter dans d'autres fichiers inclus par apache2.conf.

== Test de l'installation d'Apache ==
*Pour lancer le serveur Apache :
<code multi>$ /etc/init.d/apache2 start</code>
*Pour tester Apache :
Depuis un navigateur, aller à l'adresse [http://localhost/ http://localhost/].
Une page vide doit s'afficher.
*Si cela ne fonctionne pas:
**Vérifier si le port par défaut est bien le port 80 : le fichier /etc/apache2/ports.conf doit contenir :
<code multi>Listen 80</code>
**Regarder les fichiers de log dans /var/log/apache2.
**après modification, relancer Apache :
<code multi>$ /etc/init.d/apache2 restart</code>
*Pour arrêter Apache :
<code multi>$ /etc/init.d/apache2 stop</code>
*Pour afficher des pages HTML qui ne nécessitent pas de gestion de jsp (et qui peuvent être traitées directement par Apache, sans passer par Tomcat) : copier les fichiers HTML correspondants dans le répertoire /var/www (qui correspond par défaut à la racine du site http://localhost/).

== Personnalisations d'Apache ==
Il faut ensuite activer les modules ssl, rewrite, suexec et include d'Apache : il s'agit de créer depuis le répertoire /etc/apache2/mods-enabled des liens symboliques vers les modules du répertoire /etc/apache2/mods-available dont on a besoin :
<code multi>$ a2enmod ssl
$ a2enmod rewrite
$ a2enmod suexec
$ a2enmod include</code>
Ensuite, il faut relancer Apache :
<code multi>$ /etc/init.d/apache2 restart</code>

= Installation de JDK =
Tomcat a besoin des bibliothèques Java disponibles dans le paquet contenant le JDK (Java Development Kit).

Pour l'installer (par exemple depuis Debian)
<code multi>$ aptitude install sun-java6-jdk</code>

Pour ne pas avoir besoin de modifier tous les fichiers de configuration lorsque vous changerez de version de JDK, on va utiliser un lien symbolique /usr/lib/jdk qui pointera sur la version de JDK de votre choix :
<code multi>$ ln -s /usr/lib/jvm/java-6-sun-1.6.0.06/ /usr/lib/jdk</code>

= Installation de Tomcat =
== Installation des paquets ==
Il faut commencer par installer les paquets tomcat qui nous seront utiles. 
Par exemple, avec Debian : 
<code multi>$ aptitude install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps libtomcat5.5-java</code>

== Lien symbolique qui pointe vers la bonne version de Tomcat ==
Pour ne pas avoir besoin de modifier tous les fichiers de configuration lorsque vous changerez de version de Tomcat, on va utiliser un lien symbolique /usr/lib/apache-tomcat qui pointera sur la version de Tomcat de votre choix :
<code multi>$ ln -s /usr/share/tomcat5.5/ /usr/lib/apache-tomcat</code>

== Fichiers de configuration de Tomcat ==
Tomcat est en général installé dans /etc/tomcatxxx. Ce répertoire contient entre autres les fichiers de configuration suivants :
*server.xml : permet de configurer les ports à utiliser. En général, le port HTTP est le port 8080 (ou 8180), et la communication avec le serveur Apache via mod_jk se fait sur le port 8009.
*web.xml : permet de définir la configuration des servlets de vos applications Java.
*tomcat-users.xml : permet de définir les utiliseurs et leurs droits.

== Test de l'installation de Tomcat ==
*Pour lancer le serveur Tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/startup.sh</code>
*Pour tester Tomcat :
**Regarder dans le fichier de configuration /etc/tomcatxxx/server.xml le numéro de port HTTP utilisé (en général, 8080 ou 8180).
**Depuis un navigateur, aller à l'adresse [http://localhost:8080 http://localhost:8080] (ou [http://localhost:8180 http://localhost:8180] selon votre configuration). La page d'accueil de Tomcat, contenant une présentation de Tomcat, doit s'afficher.
*Si cela ne fonctionne pas, regarder les fichiers de log dans /var/log/tomcatxxx.
**après modification, relancer tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh
$ /usr/lib/apache-tomcat/bin/startup.sh</code>
*Pour arrêter Tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh</code>

= Installation de mod_jk =
== Installation des paquets ==
Par exemple, sous Debian :
<code multi>$ aptitude install libapache2-mod-jk</code>
Cette commande crée en particulier un fichier /usr/lib/apache2/modules/mod_jk.so correspondant au module mod_jk.

== configuration de mod_jk ==
Tout d'abord, il faut indiquer à Apache comment utiliser mod_jk :
*Créer un fichier /etc/apache2/workers.properties (s'il n'existe pas), et indiquer les informations suivantes :
<code multi>workers.tomcat_home=/usr/lib/apache-tomcat
workers.java_home=/usr/lib/jdk
ps=/
worker.list=worker1
worker.worker1.port=8009
worker.worker1.host=localhost
worker.worker1.type=ajp13
worker.worker1.lbfactor=1</code>
worker1 (on peut modifier ce nom) correspond aux caractéristiques du module mod_jk qui sera utilisé pour communiquer avec Tomcat : port 8009, machine localhost, protocole ajp13...
*Indiquer à Apache le chemin du fichier workers.properties (si ce n'est pas fait) ainsi que d'autres informations utiles : pour cela, il faut mettre à jour le fichier /etc/apache2/mods-available/jk.load (ou, à défaut, /etc/apache2/apache2.conf), en indiquant les informations suivantes :
<code multi># Charger le module mod_jk
LoadModule jk_module /usr/lib/apache2/modules/mod_jk.so
# Chemin du fichier workers.properties
JkWorkersFile /etc/apache2/workers.properties
# Fichier contenant la mémoire partagée
JkShmFile /var/log/apache2/mod_jk.shm
# Fichier de log de mod_jk
JkLogFile /var/log/apache2/mod_jk.log
# Niveau d'information : [info/error/debug]
JkLogLevel debug
# Format du nom des fichiers de log
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
# JkOptions indique d'envoyer la taille de la clé SSL
JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories
# Format du log de la requête
JkRequestLogFormat "%w %V %T"
# Lorsque le chemin des pages Web demandées correspondent aux schémas suivants,
# Apache doit les transférer à Tomcat via worker1 (à adapter en fonction des besoins)
# le répertoire jsp-examples de Tomcat contient des examples d'utilisation de servlets,
# et peut être utile pour tester la configuration
JkMount /jsp-examples worker1
JkMount /jsp-examples/*
JkMount /tests/*.jsp</code>
Il faut aussi faire figurer la référence à worker1 lors de la définition des hôtes virtuels (exemple : /etc/apache2/sites-enabled/000-default) :
<code multi><VirtualHost *>
...
JkMount /jsp-examples/* worker1
</VirtualHost></code>

== Test de mod_jk ==
*Avant de tester mod_jk, il faut relancer Apache et Tomcat.
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh
$ /usr/lib/apache-tomcat/bin/startup.sh
$ /etc/init.d/apache2 restart</code>
Remarque : il faut toujours lancer Tomcat en premier : lors du lancement d'Apache, le fichier de configuration de mod_jk est lu, et Apache sait alors qu'à tout moment il peut communiquer avec Tomcat via le port 8009. Il est donc préférable de lancer préalablement Tomcat, qui sera en attente de requêtes sur le port 8009.
*Ensuite, il faut vérifier qu'Apache fonctionne sur le port 80 ([http://localhost/ http://localhost/]), et que Tomcat fonctionne sur le port 8080 ([http://localhost:8080/ http://localhost:8080/]) ou 8180 ([http://localhost:8180/ http://localhost/:8180]) selon votre configuration.
*Enfin, il faut vérifier que les requêtes aux adresses configurées via les directives JkMount dans /etc/apache2/mods-available/jk.load (ou, à défaut, /etc/apache2/apache2.conf) fonctionnent. Dans notre cas, l'adresse /jsp-examples qui, sous Tomcat, contient des exemples de jsp :
**On vérifie que Tomcat contienne bien ces exemples, en allant voir directement dans le répertoire correspondant de Tomcat : [http://localhost:8080/jsp-examples http://localhost:8080/jsp-examples] ou [http://localhost:8180/jsp-examples http://localhost:8180/jsp-examples] selon votre configuration.
**On vérifie qu'Apache redirige correctement les requêtes vers /jsp/examples à Tomcat, qui doit renvoyer à Apache la même page que celle obtenue précédemment en faisant directement la requête à Tomcat : [http://localhost/jsp-examples http://localhost/jsp-examples]

= Installation d'Apache =

== Installation des paquets ==
Il faut commencer par installer le paquet apache2, ainsi que d'autres paquets apache et php qui peuvent s'avérer utiles. 
Par exemple, avec Debian : 
<code multi>$ aptitude install apache2 apache2-doc apache2-mpm-prefork apache2-utils apache2.2-common libapache2-mod-jk libapache2-mod-perl2 libapache2-mod-php5 libapache2-reload-perl php5 php5-cgi php5-cli php5-common php5-curl php5-gd php5-imap php5-ldap php5-mcrypt php5-mhash php5-mysql php5-odbc</code>

== Fichiers de configuration d'Apache ==
Apache2 est en général installé dans /etc/apache2. Ce répertoire contient apache2.conf, le fichier de configuration principal d'Apache.

Remarque : apache2.conf peut faire appel à d'autres fichiers de configuration, via la directive "Include". Ainsi, lorsqu'on décrit des modifications à apporter à apache2.conf, il se peut selon les configurations que ces modifications soient à apporter dans d'autres fichiers inclus par apache2.conf.

== Test de l'installation d'Apache ==
*Pour lancer le serveur Apache :
<code multi>$ /etc/init.d/apache2 start</code>
*Pour tester Apache :
Depuis un navigateur, aller à l'adresse [http://localhost/ http://localhost/].
Une page vide doit s'afficher.
*Si cela ne fonctionne pas:
**Vérifier si le port par défaut est bien le port 80 : le fichier /etc/apache2/ports.conf doit contenir :
<code multi>Listen 80</code>
**Regarder les fichiers de log dans /var/log/apache2.
**après modification, relancer Apache :
<code multi>$ /etc/init.d/apache2 restart</code>
*Pour arrêter Apache :
<code multi>$ /etc/init.d/apache2 stop</code>
*Pour afficher des pages HTML qui ne nécessitent pas de gestion de jsp (et qui peuvent être traitées directement par Apache, sans passer par Tomcat) : copier les fichiers HTML correspondants dans le répertoire /var/www (qui correspond par défaut à la racine du site http://localhost/).

== Personnalisations d'Apache ==
Il faut ensuite activer les modules ssl, rewrite, suexec et include d'Apache : il s'agit de créer depuis le répertoire /etc/apache2/mods-enabled des liens symboliques vers les modules du répertoire /etc/apache2/mods-available dont on a besoin :
<code multi>$ a2enmod ssl
$ a2enmod rewrite
$ a2enmod suexec
$ a2enmod include</code>
Ensuite, il faut relancer Apache :
<code multi>$ /etc/init.d/apache2 restart</code>

= Installation de JDK =
Tomcat a besoin des bibliothèques Java disponibles dans le paquet contenant le JDK (Java Development Kit).

Pour l'installer (par exemple depuis Debian)
<code multi>$ aptitude install sun-java6-jdk</code>

Pour ne pas avoir besoin de modifier tous les fichiers de configuration lorsque vous changerez de version de JDK, on va utiliser un lien symbolique /usr/lib/jdk qui pointera sur la version de JDK de votre choix :
<code multi>$ ln -s /usr/lib/jvm/java-6-sun-1.6.0.06/ /usr/lib/jdk</code>

= Installation de Tomcat =
== Installation des paquets ==
Il faut commencer par installer les paquets tomcat qui nous seront utiles. 
Par exemple, avec Debian : 
<code multi>$ aptitude install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps libtomcat5.5-java</code>

== Lien symbolique qui pointe vers la bonne version de Tomcat ==
Pour ne pas avoir besoin de modifier tous les fichiers de configuration lorsque vous changerez de version de Tomcat, on va utiliser un lien symbolique /usr/lib/apache-tomcat qui pointera sur la version de Tomcat de votre choix :
<code multi>$ ln -s /usr/share/tomcat5.5/ /usr/lib/apache-tomcat</code>

== Fichiers de configuration de Tomcat ==
Tomcat est en général installé dans /etc/tomcatxxx. Ce répertoire contient entre autres les fichiers de configuration suivants :
*server.xml : permet de configurer les ports à utiliser. En général, le port HTTP est le port 8080 (ou 8180), et la communication avec le serveur Apache via mod_jk se fait sur le port 8009.
*web.xml : permet de définir la configuration des servlets de vos applications Java.
*tomcat-users.xml : permet de définir les utiliseurs et leurs droits.

== Test de l'installation de Tomcat ==
*Pour lancer le serveur Tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/startup.sh</code>
*Pour tester Tomcat :
**Regarder dans le fichier de configuration /etc/tomcatxxx/server.xml le numéro de port HTTP utilisé (en général, 8080 ou 8180).
**Depuis un navigateur, aller à l'adresse [http://localhost:8080 http://localhost:8080] (ou [http://localhost:8180 http://localhost:8180] selon votre configuration). La page d'accueil de Tomcat, contenant une présentation de Tomcat, doit s'afficher.
*Si cela ne fonctionne pas, regarder les fichiers de log dans /var/log/tomcatxxx.
**après modification, relancer tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh
$ /usr/lib/apache-tomcat/bin/startup.sh</code>
*Pour arrêter Tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh</code>

= Installation de mod_jk =
== Installation des paquets ==
Par exemple, sous Debian :
<code multi>$ aptitude install libapache2-mod-jk</code>
Cette commande crée en particulier un fichier /usr/lib/apache2/modules/mod_jk.so correspondant au module mod_jk.

== configuration de mod_jk ==
Tout d'abord, il faut indiquer à Apache comment utiliser mod_jk :
*Créer un fichier /etc/apache2/workers.properties (s'il n'existe pas), et indiquer les informations suivantes :
<code multi>workers.tomcat_home=/usr/lib/apache-tomcat
workers.java_home=/usr/lib/jdk
ps=/
worker.list=worker1
worker.worker1.port=8009
worker.worker1.host=localhost
worker.worker1.type=ajp13
worker.worker1.lbfactor=1</code>
worker1 (on peut modifier ce nom) correspond aux caractéristiques du module mod_jk qui sera utilisé pour communiquer avec Tomcat : port 8009, machine localhost, protocole ajp13...
*Indiquer à Apache le chemin du fichier workers.properties (si ce n'est pas fait) ainsi que d'autres informations utiles : pour cela, il faut mettre à jour le fichier /etc/apache2/mods-available/jk.load (ou, à défaut, /etc/apache2/apache2.conf), en indiquant les informations suivantes :
<code multi># Charger le module mod_jk
LoadModule jk_module /usr/lib/apache2/modules/mod_jk.so
# Chemin du fichier workers.properties
JkWorkersFile /etc/apache2/workers.properties
# Fichier contenant la mémoire partagée
JkShmFile /var/log/apache2/mod_jk.shm
# Fichier de log de mod_jk
JkLogFile /var/log/apache2/mod_jk.log
# Niveau d'information : [info/error/debug]
JkLogLevel debug
# Format du nom des fichiers de log
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
# JkOptions indique d'envoyer la taille de la clé SSL
JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories
# Format du log de la requête
JkRequestLogFormat "%w %V %T"
# Lorsque le chemin des pages Web demandées correspondent aux schémas suivants,
# Apache doit les transférer à Tomcat via worker1 (à adapter en fonction des besoins)
# le répertoire jsp-examples de Tomcat contient des examples d'utilisation de servlets,
# et peut être utile pour tester la configuration
JkMount /jsp-examples worker1
JkMount /jsp-examples/*
JkMount /tests/*.jsp</code>
Il faut aussi faire figurer la référence à worker1 lors de la définition des hôtes virtuels (exemple : /etc/apache2/sites-enabled/000-default) :
<code multi><VirtualHost *>
...
JkMount /jsp-examples/* worker1
</VirtualHost></code>

== Test de mod_jk ==
*Avant de tester mod_jk, il faut relancer Apache et Tomcat.
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh
$ /usr/lib/apache-tomcat/bin/startup.sh
$ /etc/init.d/apache2 restart</code>
Remarque : il faut toujours lancer Tomcat en premier : lors du lancement d'Apache, le fichier de configuration de mod_jk est lu, et Apache sait alors qu'à tout moment il peut communiquer avec Tomcat via le port 8009. Il est donc préférable de lancer préalablement Tomcat, qui sera en attente de requêtes sur le port 8009.
*Ensuite, il faut vérifier qu'Apache fonctionne sur le port 80 ([http://localhost/ http://localhost/]), et que Tomcat fonctionne sur le port 8080 ([http://localhost:8080/ http://localhost:8080/]) ou 8180 ([http://localhost:8180/ http://localhost/:8180]) selon votre configuration.
*Enfin, il faut vérifier que les requêtes aux adresses configurées via les directives JkMount dans /etc/apache2/mods-available/jk.load (ou, à défaut, /etc/apache2/apache2.conf) fonctionnent. Dans notre cas, l'adresse /jsp-examples qui, sous Tomcat, contient des exemples de jsp :
**On vérifie que Tomcat contienne bien ces exemples, en allant voir directement dans le répertoire correspondant de Tomcat : [http://localhost:8080/jsp-examples http://localhost:8080/jsp-examples] ou [http://localhost:8180/jsp-examples http://localhost:8180/jsp-examples] selon votre configuration.
**On vérifie qu'Apache redirige correctement les requêtes vers /jsp/examples à Tomcat, qui doit renvoyer à Apache la même page que celle obtenue précédemment en faisant directement la requête à Tomcat : [http://localhost/jsp-examples http://localhost/jsp-examples]

Apache et Tomcat

2008-06-29T21:52:13Z

Nulix31 : /* Introduction */

= Introduction =
Apache est un serveur Web : il reçoit des requêtes HTTP émises depuis un navigateur, les analyse et envoie des pages Web en réponse au navigateur.

Lorsque les requêtes HTTP concernent des pages JSP (Java Server Pages), du code Java doit être exécuté pour construire les pages Web qu'Apache doit renvoyer au navigateur. Pour cela, Apache s'appuie sur un moteur de servlets qui prend en charge cette partie du traitement. Tomcat est l'un des moteurs de servlets les plus utilisés.

Pour communiquer entre eux, Apache et Tomcat utilisent un module intermédiaire, tel que mod_jk.

L'objet de cette fiche est de présenter les différentes étapes de l'installation de base d'Apache, Tomcat et mod_jk.
= Introduction =
Apache est un serveur Web : il reçoit des requêtes HTTP émises depuis un navigateur, les analyse et envoie des pages Web en réponse au navigateur.

Lorsque les requêtes HTTP concernent des pages JSP (Java Server Pages), du code Java doit être exécuté pour construire les pages Web qu'Apache doit renvoyer au navigateur. Pour cela, Apache s'appuie sur un moteur de servlets qui prend en charge cette partie du traitement. Tomcat est l'un des moteurs de servlets les plus utilisés.

Pour communiquer entre eux, Apache et Tomcat utilisent un module intermédiaire, tel que mod_jk.

L'objet de cette fiche est de présenter les différentes étapes de l'installation de base d'Apache, Tomcat et mod_jk.

= Installation d'Apache =

== Installation des paquets ==
Il faut commencer par installer le paquet apache2, ainsi que d'autres paquets apache et php qui peuvent s'avérer utiles. 
Par exemple, avec Debian : 
<code multi>$ aptitude install apache2 apache2-doc apache2-mpm-prefork apache2-utils apache2.2-common libapache2-mod-jk libapache2-mod-perl2 libapache2-mod-php5 libapache2-reload-perl php5 php5-cgi php5-cli php5-common php5-curl php5-gd php5-imap php5-ldap php5-mcrypt php5-mhash php5-mysql php5-odbc</code>

== Fichiers de configuration d'Apache ==
Apache2 est en général installé dans /etc/apache2. Ce répertoire contient apache2.conf, le fichier de configuration principal d'Apache.

Remarque : apache2.conf peut faire appel à d'autres fichiers de configuration, via la directive "Include". Ainsi, lorsqu'on décrit des modifications à apporter à apache2.conf, il se peut selon les configurations que ces modifications soient à apporter dans d'autres fichiers inclus par apache2.conf.

== Test de l'installation d'Apache ==
*Pour lancer le serveur Apache :
<code multi>$ /etc/init.d/apache2 start</code>
*Pour tester Apache :
Depuis un navigateur, aller à l'adresse [http://localhost/ http://localhost/].
Une page vide doit s'afficher.
*Si cela ne fonctionne pas:
**Vérifier si le port par défaut est bien le port 80 : le fichier /etc/apache2/ports.conf doit contenir :
<code multi>Listen 80</code>
**Regarder les fichiers de log dans /var/log/apache2.
**après modification, relancer Apache :
<code multi>$ /etc/init.d/apache2 restart</code>
*Pour arrêter Apache :
<code multi>$ /etc/init.d/apache2 stop</code>
*Pour afficher des pages HTML qui ne nécessitent pas de gestion de jsp (et qui peuvent être traitées directement par Apache, sans passer par Tomcat) : copier les fichiers HTML correspondants dans le répertoire /var/www (qui correspond par défaut à la racine du site http://localhost/).

== Personnalisations d'Apache ==
Il faut ensuite activer les modules ssl, rewrite, suexec et include d'Apache : il s'agit de créer depuis le répertoire /etc/apache2/mods-enabled des liens symboliques vers les modules du répertoire /etc/apache2/mods-available dont on a besoin :
<code multi>$ a2enmod ssl
$ a2enmod rewrite
$ a2enmod suexec
$ a2enmod include</code>
Ensuite, il faut relancer Apache :
<code multi>$ /etc/init.d/apache2 restart</code>

= Installation de JDK =
Tomcat a besoin des bibliothèques Java disponibles dans le paquet contenant le JDK (Java Development Kit).

Pour l'installer (par exemple depuis Debian)
<code multi>$ aptitude install sun-java6-jdk</code>

Pour ne pas avoir besoin de modifier tous les fichiers de configuration lorsque vous changerez de version de JDK, on va utiliser un lien symbolique /usr/lib/jdk qui pointera sur la version de JDK de votre choix :
<code multi>$ ln -s /usr/lib/jvm/java-6-sun-1.6.0.06/ /usr/lib/jdk</code>

= Installation de Tomcat =
== Installation des paquets ==
Il faut commencer par installer les paquets tomcat qui nous seront utiles. 
Par exemple, avec Debian : 
<code multi>$ aptitude install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps libtomcat5.5-java</code>

== Lien symbolique qui pointe vers la bonne version de Tomcat ==
Pour ne pas avoir besoin de modifier tous les fichiers de configuration lorsque vous changerez de version de Tomcat, on va utiliser un lien symbolique /usr/lib/apache-tomcat qui pointera sur la version de Tomcat de votre choix :
<code multi>$ ln -s /usr/share/tomcat5.5/ /usr/lib/apache-tomcat</code>

== Fichiers de configuration de Tomcat ==
Tomcat est en général installé dans /etc/tomcatxxx. Ce répertoire contient entre autres les fichiers de configuration suivants :
*server.xml : permet de configurer les ports à utiliser. En général, le port HTTP est le port 8080 (ou 8180), et la communication avec le serveur Apache via mod_jk se fait sur le port 8009.
*web.xml : permet de définir la configuration des servlets de vos applications Java.
*tomcat-users.xml : permet de définir les utiliseurs et leurs droits.

== Test de l'installation de Tomcat ==
*Pour lancer le serveur Tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/startup.sh</code>
*Pour tester Tomcat :
**Regarder dans le fichier de configuration /etc/tomcatxxx/server.xml le numéro de port HTTP utilisé (en général, 8080 ou 8180).
**Depuis un navigateur, aller à l'adresse [http://localhost:8080 http://localhost:8080] (ou [http://localhost:8180 http://localhost:8180] selon votre configuration). La page d'accueil de Tomcat, contenant une présentation de Tomcat, doit s'afficher.
*Si cela ne fonctionne pas, regarder les fichiers de log dans /var/log/tomcatxxx.
**après modification, relancer tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh
$ /usr/lib/apache-tomcat/bin/startup.sh</code>
*Pour arrêter Tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh</code>

= Installation de mod_jk =
== Installation des paquets ==
Par exemple, sous Debian :
<code multi>$ aptitude install libapache2-mod-jk</code>
Cette commande crée en particulier un fichier /usr/lib/apache2/modules/mod_jk.so correspondant au module mod_jk.

== configuration de mod_jk ==
Tout d'abord, il faut indiquer à Apache comment utiliser mod_jk :
*Créer un fichier /etc/apache2/workers.properties (s'il n'existe pas), et indiquer les informations suivantes :
<code multi>workers.tomcat_home=/usr/lib/apache-tomcat
workers.java_home=/usr/lib/jdk
ps=/
worker.list=worker1
worker.worker1.port=8009
worker.worker1.host=localhost
worker.worker1.type=ajp13
worker.worker1.lbfactor=1</code>
worker1 (on peut modifier ce nom) correspond aux caractéristiques du module mod_jk qui sera utilisé pour communiquer avec Tomcat : port 8009, machine localhost, protocole ajp13...
*Indiquer à Apache le chemin du fichier workers.properties (si ce n'est pas fait) ainsi que d'autres informations utiles : pour cela, il faut mettre à jour le fichier /etc/apache2/mods-available/jk.load (ou, à défaut, /etc/apache2/apache2.conf), en indiquant les informations suivantes :
<code multi># Charger le module mod_jk
LoadModule jk_module /usr/lib/apache2/modules/mod_jk.so
# Chemin du fichier workers.properties
JkWorkersFile /etc/apache2/workers.properties
# Fichier contenant la mémoire partagée
JkShmFile /var/log/apache2/mod_jk.shm
# Fichier de log de mod_jk
JkLogFile /var/log/apache2/mod_jk.log
# Niveau d'information : [info/error/debug]
JkLogLevel debug
# Format du nom des fichiers de log
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
# JkOptions indique d'envoyer la taille de la clé SSL
JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories
# Format du log de la requête
JkRequestLogFormat "%w %V %T"
# Lorsque le chemin des pages Web demandées correspondent aux schémas suivants,
# Apache doit les transférer à Tomcat via worker1 (à adapter en fonction des besoins)
# le répertoire jsp-examples de Tomcat contient des examples d'utilisation de servlets,
# et peut être utile pour tester la configuration
JkMount /jsp-examples worker1
JkMount /jsp-examples/*
JkMount /tests/*.jsp</code>
Il faut aussi faire figurer la référence à worker1 lors de la définition des hôtes virtuels (exemple : /etc/apache2/sites-enabled/000-default) :
<code multi><VirtualHost *>
...
JkMount /jsp-examples/* worker1
</VirtualHost></code>

== Test de mod_jk ==
*Avant de tester mod_jk, il faut relancer Apache et Tomcat.
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh
$ /usr/lib/apache-tomcat/bin/startup.sh
$ /etc/init.d/apache2 restart</code>
Remarque : il faut toujours lancer Tomcat en premier : lors du lancement d'Apache, le fichier de configuration de mod_jk est lu, et Apache sait alors qu'à tout moment il peut communiquer avec Tomcat via le port 8009. Il est donc préférable de lancer préalablement Tomcat, qui sera en attente de requêtes sur le port 8009.
*Ensuite, il faut vérifier qu'Apache fonctionne sur le port 80 ([http://localhost/ http://localhost/]), et que Tomcat fonctionne sur le port 8080 ([http://localhost:8080/ http://localhost:8080/]) ou 8180 ([http://localhost:8180/ http://localhost/:8180]) selon votre configuration.
*Enfin, il faut vérifier que les requêtes aux adresses configurées via les directives JkMount dans /etc/apache2/mods-available/jk.load (ou, à défaut, /etc/apache2/apache2.conf) fonctionnent. Dans notre cas, l'adresse /jsp-examples qui, sous Tomcat, contient des exemples de jsp :
**On vérifie que Tomcat contienne bien ces exemples, en allant voir directement dans le répertoire correspondant de Tomcat : [http://localhost:8080/jsp-examples http://localhost:8080/jsp-examples] ou [http://localhost:8180/jsp-examples http://localhost:8180/jsp-examples] selon votre configuration.
**On vérifie qu'Apache redirige correctement les requêtes vers /jsp/examples à Tomcat, qui doit renvoyer à Apache la même page que celle obtenue précédemment en faisant directement la requête à Tomcat : [http://localhost/jsp-examples http://localhost/jsp-examples]

= Installation d'Apache =

== Installation des paquets ==
Il faut commencer par installer le paquet apache2, ainsi que d'autres paquets apache et php qui peuvent s'avérer utiles. 
Par exemple, avec Debian : 
<code multi>$ aptitude install apache2 apache2-doc apache2-mpm-prefork apache2-utils apache2.2-common libapache2-mod-jk libapache2-mod-perl2 libapache2-mod-php5 libapache2-reload-perl php5 php5-cgi php5-cli php5-common php5-curl php5-gd php5-imap php5-ldap php5-mcrypt php5-mhash php5-mysql php5-odbc</code>

== Fichiers de configuration d'Apache ==
Apache2 est en général installé dans /etc/apache2. Ce répertoire contient apache2.conf, le fichier de configuration principal d'Apache.

Remarque : apache2.conf peut faire appel à d'autres fichiers de configuration, via la directive "Include". Ainsi, lorsqu'on décrit des modifications à apporter à apache2.conf, il se peut selon les configurations que ces modifications soient à apporter dans d'autres fichiers inclus par apache2.conf.

== Test de l'installation d'Apache ==
*Pour lancer le serveur Apache :
<code multi>$ /etc/init.d/apache2 start</code>
*Pour tester Apache :
Depuis un navigateur, aller à l'adresse [http://localhost/ http://localhost/].
Une page vide doit s'afficher.
*Si cela ne fonctionne pas:
**Vérifier si le port par défaut est bien le port 80 : le fichier /etc/apache2/ports.conf doit contenir :
<code multi>Listen 80</code>
**Regarder les fichiers de log dans /var/log/apache2.
**après modification, relancer Apache :
<code multi>$ /etc/init.d/apache2 restart</code>
*Pour arrêter Apache :
<code multi>$ /etc/init.d/apache2 stop</code>
*Pour afficher des pages HTML qui ne nécessitent pas de gestion de jsp (et qui peuvent être traitées directement par Apache, sans passer par Tomcat) : copier les fichiers HTML correspondants dans le répertoire /var/www (qui correspond par défaut à la racine du site http://localhost/).

== Personnalisations d'Apache ==
Il faut ensuite activer les modules ssl, rewrite, suexec et include d'Apache : il s'agit de créer depuis le répertoire /etc/apache2/mods-enabled des liens symboliques vers les modules du répertoire /etc/apache2/mods-available dont on a besoin :
<code multi>$ a2enmod ssl
$ a2enmod rewrite
$ a2enmod suexec
$ a2enmod include</code>
Ensuite, il faut relancer Apache :
<code multi>$ /etc/init.d/apache2 restart</code>

= Installation de JDK =
Tomcat a besoin des bibliothèques Java disponibles dans le paquet contenant le JDK (Java Development Kit).

Pour l'installer (par exemple depuis Debian)
<code multi>$ aptitude install sun-java6-jdk</code>

Pour ne pas avoir besoin de modifier tous les fichiers de configuration lorsque vous changerez de version de JDK, on va utiliser un lien symbolique /usr/lib/jdk qui pointera sur la version de JDK de votre choix :
<code multi>$ ln -s /usr/lib/jvm/java-6-sun-1.6.0.06/ /usr/lib/jdk</code>

= Installation de Tomcat =
== Installation des paquets ==
Il faut commencer par installer les paquets tomcat qui nous seront utiles. 
Par exemple, avec Debian : 
<code multi>$ aptitude install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps libtomcat5.5-java</code>

== Lien symbolique qui pointe vers la bonne version de Tomcat ==
Pour ne pas avoir besoin de modifier tous les fichiers de configuration lorsque vous changerez de version de Tomcat, on va utiliser un lien symbolique /usr/lib/apache-tomcat qui pointera sur la version de Tomcat de votre choix :
<code multi>$ ln -s /usr/share/tomcat5.5/ /usr/lib/apache-tomcat</code>

== Fichiers de configuration de Tomcat ==
Tomcat est en général installé dans /etc/tomcatxxx. Ce répertoire contient entre autres les fichiers de configuration suivants :
*server.xml : permet de configurer les ports à utiliser. En général, le port HTTP est le port 8080 (ou 8180), et la communication avec le serveur Apache via mod_jk se fait sur le port 8009.
*web.xml : permet de définir la configuration des servlets de vos applications Java.
*tomcat-users.xml : permet de définir les utiliseurs et leurs droits.

== Test de l'installation de Tomcat ==
*Pour lancer le serveur Tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/startup.sh</code>
*Pour tester Tomcat :
**Regarder dans le fichier de configuration /etc/tomcatxxx/server.xml le numéro de port HTTP utilisé (en général, 8080 ou 8180).
**Depuis un navigateur, aller à l'adresse [http://localhost:8080 http://localhost:8080] (ou [http://localhost:8180 http://localhost:8180] selon votre configuration). La page d'accueil de Tomcat, contenant une présentation de Tomcat, doit s'afficher.
*Si cela ne fonctionne pas, regarder les fichiers de log dans /var/log/tomcatxxx.
**après modification, relancer tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh
$ /usr/lib/apache-tomcat/bin/startup.sh</code>
*Pour arrêter Tomcat :
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh</code>

= Installation de mod_jk =
== Installation des paquets ==
Par exemple, sous Debian :
<code multi>$ aptitude install libapache2-mod-jk</code>
Cette commande crée en particulier un fichier /usr/lib/apache2/modules/mod_jk.so correspondant au module mod_jk.

== configuration de mod_jk ==
Tout d'abord, il faut indiquer à Apache comment utiliser mod_jk :
*Créer un fichier /etc/apache2/workers.properties (s'il n'existe pas), et indiquer les informations suivantes :
<code multi>workers.tomcat_home=/usr/lib/apache-tomcat
workers.java_home=/usr/lib/jdk
ps=/
worker.list=worker1
worker.worker1.port=8009
worker.worker1.host=localhost
worker.worker1.type=ajp13
worker.worker1.lbfactor=1</code>
worker1 (on peut modifier ce nom) correspond aux caractéristiques du module mod_jk qui sera utilisé pour communiquer avec Tomcat : port 8009, machine localhost, protocole ajp13...
*Indiquer à Apache le chemin du fichier workers.properties (si ce n'est pas fait) ainsi que d'autres informations utiles : pour cela, il faut mettre à jour le fichier /etc/apache2/mods-available/jk.load (ou, à défaut, /etc/apache2/apache2.conf), en indiquant les informations suivantes :
<code multi># Charger le module mod_jk
LoadModule jk_module /usr/lib/apache2/modules/mod_jk.so
# Chemin du fichier workers.properties
JkWorkersFile /etc/apache2/workers.properties
# Fichier contenant la mémoire partagée
JkShmFile /var/log/apache2/mod_jk.shm
# Fichier de log de mod_jk
JkLogFile /var/log/apache2/mod_jk.log
# Niveau d'information : [info/error/debug]
JkLogLevel debug
# Format du nom des fichiers de log
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
# JkOptions indique d'envoyer la taille de la clé SSL
JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories
# Format du log de la requête
JkRequestLogFormat "%w %V %T"
# Lorsque le chemin des pages Web demandées correspondent aux schémas suivants,
# Apache doit les transférer à Tomcat via worker1 (à adapter en fonction des besoins)
# le répertoire jsp-examples de Tomcat contient des examples d'utilisation de servlets,
# et peut être utile pour tester la configuration
JkMount /jsp-examples worker1
JkMount /jsp-examples/*
JkMount /tests/*.jsp</code>
Il faut aussi faire figurer la référence à worker1 lors de la définition des hôtes virtuels (exemple : /etc/apache2/sites-enabled/000-default) :
<code multi><VirtualHost *>
...
JkMount /jsp-examples/* worker1
</VirtualHost></code>

== Test de mod_jk ==
*Avant de tester mod_jk, il faut relancer Apache et Tomcat.
<code multi>$ /usr/lib/apache-tomcat/bin/shutdown.sh
$ /usr/lib/apache-tomcat/bin/startup.sh
$ /etc/init.d/apache2 restart</code>
Remarque : il faut toujours lancer Tomcat en premier : lors du lancement d'Apache, le fichier de configuration de mod_jk est lu, et Apache sait alors qu'à tout moment il peut communiquer avec Tomcat via le port 8009. Il est donc préférable de lancer préalablement Tomcat, qui sera en attente de requêtes sur le port 8009.
*Ensuite, il faut vérifier qu'Apache fonctionne sur le port 80 ([http://localhost/ http://localhost/]), et que Tomcat fonctionne sur le port 8080 ([http://localhost:8080/ http://localhost:8080/]) ou 8180 ([http://localhost:8180/ http://localhost/:8180]) selon votre configuration.
*Enfin, il faut vérifier que les requêtes aux adresses configurées via les directives JkMount dans /etc/apache2/mods-available/jk.load (ou, à défaut, /etc/apache2/apache2.conf) fonctionnent. Dans notre cas, l'adresse /jsp-examples qui, sous Tomcat, contient des exemples de jsp :
**On vérifie que Tomcat contienne bien ces exemples, en allant voir directement dans le répertoire correspondant de Tomcat : [http://localhost:8080/jsp-examples http://localhost:8080/jsp-examples] ou [http://localhost:8180/jsp-examples http://localhost:8180/jsp-examples] selon votre configuration.
**On vérifie qu'Apache redirige correctement les requêtes vers /jsp/examples à Tomcat, qui doit renvoyer à Apache la même page que celle obtenue précédemment en faisant directement la requête à Tomcat : [http://localhost/jsp-examples http://localhost/jsp-examples]

Apache et Tomcat

2008-06-29T21:51:24Z

Nulix31 :

Apache et Tomcat

2008-06-29T21:49:56Z

Nulix31 :

Apache et Tomcat

2008-06-29T21:49:22Z

Nulix31 :

Apache et Tomcat

2008-06-29T21:48:05Z

Nulix31 :

Apache et Tomcat

2008-06-29T21:20:53Z

Nulix31 :

Apache et Tomcat

2008-06-29T12:38:25Z

Nulix31 :

Apache et Tomcat

2008-06-29T12:38:07Z

Nulix31 :

Apache et Tomcat

2008-06-29T12:36:51Z

Nulix31 :

Apache et Tomcat

2008-06-29T12:12:05Z

Nulix31 :

Apache et Tomcat

2008-06-29T12:03:45Z

Nulix31 :

Apache et Tomcat

2008-06-29T11:43:28Z

Nulix31 :

Apache et Tomcat

2008-06-29T11:38:40Z

Nulix31 :

Apache et Tomcat

2008-06-29T11:27:20Z

Nulix31 :

Apache et Tomcat

2008-06-29T11:24:28Z

Nulix31 :

Apache et Tomcat

2008-06-29T11:06:36Z

Nulix31 :

Apache et Tomcat

2008-06-29T11:05:43Z

Nulix31 :

Apache et Tomcat

2008-06-29T11:05:11Z

Nulix31 :

Apache et Tomcat

2008-06-29T10:55:40Z

Nulix31 : /* Introduction */

Apache et Tomcat

2008-06-29T10:52:08Z

Nulix31 : Installation d'Apache

Apache et Tomcat

2008-06-29T10:49:09Z

Nulix31 : Installation d'Apache

Apache et Tomcat

2008-06-29T10:47:01Z

Nulix31 :

Modèle:Fiches:plan-divers

2008-06-29T10:31:27Z

Nulix31 : /* à rédiger */

=== Fiches diverses ===
*[[Fiches:Comment colorer la sortie de ls ?|Comment colorer la sortie de ls ?]]
*[[Fiches:Comment ouvrir un pdf ?|Comment ouvrir un pdf ?]]
*[[Fiches:Installer un serveur LAMP en mode texte|Installer un serveur LAMP en mode texte]]
====à rédiger====
*[[Fiches:Qu'en est-il du support ntfs sous GNU/Linux ?|Qu'en est-il du support ntfs sous GNU/Linux ?]]
*[[Fiches:Comment faire fonctionner ensemble Apache et Tomcat ?|Comment faire fonctionner ensemble Apache et Tomcat ?]]