INSTALLATION DE WEBCIELL2 SOUS LINUX

I) Introduction INSTALLATION DE WEBCIELL2 SOUS LINUX Postulat : La procédure d installation suivant se fait sous Linux redhat 9.2. Mais cela doit pouvoir fonctionner sur toutes distributions acceptant la gestion de packages RPM. Je vous conseil fortement d avoir les sources de votre version d apache. On en aura besoin pour la compilation du redirecteur jk. Il existe des fichiers mod_jk.so déjà compilés à récupérer sur le net mais ils marchent rarement car mod_jk.so est intimement lié à votre version d apache avec ses options de compilation. Cette documentation ne traite pas de l installation d apache. Ici, nous utilisons Apache version 2.0.52 Tomcat 5.0.28 Java SDK 1.4_2 mod_jk version2.8 Si vous utiliser des versions différentes qui plus est sous d autre système, il est normal que les chemins ne soit pas exactement pareils. A vous d adapter. Servez vous de la fonction locate en ligne de commande pour retrouver les chemins. Convention : tout ce qui ce trouve derrière Prompt> doit être tapé tel quel. Pour qu il n y ai pas d ambiguïté les espaces sont signalés par <espace> Exemple : Prompt>ls<espace>-n Connectez vous en root ou sous un autre user puis faites "su" (demande mot de passe root) pour avoir les droits root. Page 1/11

II ) Installation de java SDK Téléchargez chez sun le fichier j2sdk-1_4_2_02-linux-i586-rpm.bin Téléchargez bien le "Linux RPM in self-extracting file" version SDK et non JRE ->http://java.sun.com/j2se/1.4.2/download.html Ce fichier est un exécutable Lancez le comme un programme : Prompt>./j2sdk-1_4_2_02-linux-i586-rpm.bin Le contrat d'acceptation SUN défile A la fin il propose de générer le fichier RPM d'installation Répondez yes. Lancer l'installation du RPM Prompt>rpm<espace>-i j2sdk-1_4_2_02-linux-i586.rpm ( ou avec l'interface graphique en double-cliquant dessus si vous avez installé le manager de rpm sous X) l'installation se fait dans /usr/java/j2sdk1.4.2_02 Ajoutez la variable d'environnement JAVA_HOME Pour que la variable d'environnement soit accessible de tous, on va modifier le fichier profile général: Allez dans /etc Editer le fichier profile Ajoutez cette instruction avant l'instruction 'export' JAVA_HOME="/usr/java/j2sdk1.4.2_02" Ajoutez à l'instruction 'export' JAVA_HOME votre instruction 'export' ressemble à cela ( sur une seule ligne) : export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE INPUTRC JAVA_HOME III ) Installation de Tomcat III.1) Installation de l archive tomcat Allez sur le site jakarta.apache.org Page 2/11

Récupérez le fichier jakarta-tomcat-5.0.28.tar.gz On va installer tomcat dans /usr/tomcat (créez un répertoire tomcat dans /usr et mettez-y le fichier téléchargé) Promtp>tar<espace>-xzf<espace>jakarta-tomcat-5.0.28.tar.gz Un répertoire jakarta-tomcat-5.0.28 est créé Comme je ne supporte pas les nom a rallonge, je le renomme en tomcat5 : Prompt>mv<espace>jakarta-tomcat-5.0.28<espace>tomcat5 On a donc le chemin /usr/tomcat/tomcat5 Ajoutez la variable d'environnement CATALINA_HOME Pour que la variable d'environnement soit accessible de tous, on va modifier le fichier profile général: Allez dans /etc Editer le fichier "profile" Ajouter cette instruction avant l'instruction 'export' CATALINA_HOME="/usr/tomcat/tomcat5" Ajouter à l'instruction 'export' CATALINA_HOME votre instruction 'export' ressemble à cela (sur une seule ligne): export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE INPUTRC JAVA_HOME CATALINA_HOME Il faut relancer le fichier /etc/profile allez dans /etc tapez : Prompt>source<espace>profile tapez Prompt>env vous devez voir apparaître les variables d'environnement JAVA_HOME et CATALINA_HOME Si vous avez des shell ouvert sous X, il est préférable de tous les fermer après l instruction source puis d en ouvrir un nouveau. Vous pouvez aussi rebooter complément votre machine linux. III.2) Installation ODBC JAVA MSSQL SERVER Page 3/11

on va tout de suite ajouter les 'jar' qui gèrent l'odbc MSSQL ->http://www.microsoft.com/sql/downloads Télécharger le fichier mssqlserver.tar Décompressez le ou vous voulez. Prompt>tar<espace>-xf<espace>mssqlserver.tar Entre autre, Le fichier msjdbc.tar est généré. Décompressez le : Prompt>tar<espace>-xf<espace>msjdbc.tar Il n'y a que trois fichiers qui nous intéressent. Ils se trouvent dans le sous répertoire lib du répertoire de décompression. copier les trois fichiers '.jar' dans /usr/tomcat/tomcat5/common/lib ces fichiers sont :msbase.jar mssqlserver.jar msutil.jar N oubliez pas qu il y a d autre bibliothèque jar à copier pour WebCiell2 activation.jar commons-dbcp-1.2.1.jar commons-fileupload-1.0.jar itext-paulo-140.jar III.3) Lancement de Tomcat Lancement de tomcat5 : Prompt>$CATALINA_HOME/bin/startup.sh Arrêt de tomcat5 : Prompt>$CATALINA_HOME/bin/shutdown.sh Même si le processus vous rend la main tres vite, attendez une bonne minute avant de lancer un navigateur internet pour attaquer le site sur le port 8080 (en local : http://localhost:8080). La page de présentation Tomcat se charge et vous félicite...si tout va bien Page 4/11

IV ) Mise en place de WebCiell2 Avant tout, si votre serveur MSSQL n'a pas d'entrée DNS, ajoutez son adresse IP dans le fichier hosts local. Allez dans /etc/sysconfig/networking/profiles/default Editez le fichier hosts Ajoutez adress_ip nom_unc exemple : serveur-sco 192.168.0.7 Copiez le fichier WebCiell2.xml dans /usr/tomcat/tomcat5/conf/catalina/localhost pour la config : rien de particulier sous linux par rapport a windows server/iis (la partie concerné de la documentation pour Windows est reprise et adaptée ici) Il faudra le modifier en fonction de votre environnement, principalement les 4 lignes suivantes seront à adapter : <parameter> <name>driverclassname</name> <value>com.microsoft.jdbc.sqlserver.sqlserverdriver</value> </parameter> <parameter> <name>url</name> <value>jdbc:microsoft:sqlserver://nomduserveurbdd:1433</value> </parameter> <parameter> <name>username</name> <value>nomconnecteur</value> </parameter> <parameter> <name>password</name> <value>motdepasse</value> </parameter> Il s'agit de: - nom du driver JDBC pour la base de donnée - Nom du serveur de base de données et son numéro de port (tel qu il figure sur votre DNS ou dans votre fichier host, et non pas le nom que vous voyez lorsque vous le rechercher dans votre réseau local netbios/netbeui/ipx) - Nom du connecteur pour le serveur de base de donnée - mot de passe du connecteur Une autre ligne mérite une très grande attention lors de l installation comme lors des mises à jour. La valeur entre les «tags» <Value> (ici de 30 en secondes) doit impérativement être cohérente avec la valeur indiquée (en secondes!!!) dans le fichier Web.XML dans le répertoire /usr/tomcat/tomcat5/conf. La partie spécifique est décrite en note de bas de page et sera systématiquement écrasée lors du chargement de chaque mise à jour du WebCiell2.war!!! A vous d aller vérifier le contenu de ce fichier Web.xml après chaque mise à jour! Pour des raisons de développement, cette valeur dans WEB.XML sera positionnée à 1 -minute- (comme 60 secondes dans WebCiell2.XML!) <!-- Hors temps en seconde avant de considerer une connexion comme non utilisee --> <parameter> <name>removeabandonedtimeout</name> <value>30</value> </parameter> Page 5/11

Copiez le fichier WebCiell2.war dans /usr/tomcat/tomcat5/webapps comme par magie un répertoire portant le même nom se crée automatiquement. Attendez quelques secondes pour lancer le site http://localhost:8080/webciell2 V) Installation de Tomcat en temps que daemon linux : On va faire tourner Tomcat sous le nom d'utilisateur tomcat du groupe tomcat Créez le groupe tomcat: Prompt>groupadd<espace>tomcat Créez l'utilisateur tomcat: Prompt>useradd<espace>-g<espace>tomcat<espace>tomcat Mettez le script tomcat dans /etc/rc.d/init.d (script en annexe) Donnez des droits d'exécution sur le script : Prompt>chmod<espace>755<espace>tomcat Vous pouvez éditez ce script pour y apporter des modifications si vous n'avez pas respecté à la lettre cette documentation en particulier pour ce qui concerne les chemins. Ajoutez ce script dans la liste des daemons de votre configuration linux : Prompt>chkconfig<espace>--add<espace>tomcat En ligne de commande vous pouvez utiliser les instructions suivantes pour lancer/arrêter/redémarrer tomcat : Prompt>service<espace>tomcat<espace>start Prompt>service<espace>tomcat<espace>stop Prompt>service<espace>tomcat<espace>restart Le meilleur moyen de savoir si tomcat se lance bien au démarrage, c'est de faire un "reboot" de la machine. Prompt>reboot Page 6/11

VI)Installation de mod_jk connector (mod_jk2 étant abandonné) : Sous Windows Server, la dll isapi_redirector permet d ouvrir le site WebCiell2 sur le port standard http(80) plutôt que sur le port Tomcat 8080. Isapi_redirector redirige le flux du port 80 de l interface Ethernet vers le port 8080 sur l interface localhost(127.0.0.1). Ceci ne change rien au fonctionnement de Tomcat. Il s agit juste de pouvoir fermer le port 8080 pour des raisons de sécurité. Il y a aussi des candidats qui se connectent sur un site ne permettant que la communication vers des serveurs web par le port 80 :derrière un proxy-web de type squid par exemple. Avant tout, arrêter Tomcat et Apache /etc/rc.d/init.d/tomcat stop /etc/rc.d/init.d/httpd stop VI.1) : Téléchargement et compilation Télécharger les sources jk connector du site http://www.apache.org/dist/jakarta/tomcatconnectors/jk/. Je récupère le fichier de la version courante jakarta-tomcat-connectors-current-src.tar.gz. Décompression : Prompt>tar<espace>xvzf<espace>jakarta-tomcat-connectors-jk-currentsrc.tar.gz il me crée un répertoire portant le numéro de version du connecteur :./ jakartatomcat-connectors-1.2.8-src je déplace le répertoire en question vers /usr/src Prompt>mv<espace> jakarta-tomcat-connectors-1.2.8-src<espace>/usr/src Allez dans le repertoire /usr/src/ jakarta-tomcat-connectors-1.2.8-src/jk/native Lancer le generateur de fichier de configuration : Prompt>./buidconf.sh Configuration en précisant le chemin vers apxs Prompt>./configure<espace>--with-apxs=/usr/local/apache/bin/apxs Compilation avec make Prompt>make Page 7/11

Un répertoire apache-2.0 est créé avec dedans le fichier mod_jk.so Recopier le fichier mod_jk.so vers le repertoire des modules apache Prompt>cp<espace>./apache-2.0/mod_jk.so<espace>/usr/local/apache/modules VI.2) : configuration de workers.properties : Ce fichier est à créer dans /usr/tomcat/tomcat5/conf/jk/ Contenu : # indiquer les chemin de Tomcat & Java Home workers.tomcat_home=/usr/tomcat/tomcat5 workers.java_home=/usr/java/j2sdk1.4.2_02 ps=/ # creer un worker qui se nomme ajp13w de type ajp13 worker.list=ajp13w worker.ajp13w.port=8009 worker.ajp13w.host=127.0.0.1 worker.ajp13w.type=ajp13 VI.3) : Configuration d Apache Modification du fichier de httpd.conf Dans la zone de chargement des modules, ajouter cette ligne : LoadModule jk_module modules/mod_jk.so Avant la ligne qui commence par <VirtualHost * :80>, ajouter JkWorkersFile /usr/tomcat/tomcat5/conf/jk/workers.properties dans le paragraphe <VirtualHost * :80> apporter des modifications pour qu il ressemble à cela: <VirtualHost *:80> # # redirecteur sur Tomcat JkLogFile /var/log/httpd/mod_jk.log JkLogLevel info # entrez le chemin complet vers le repertoire webapps et montage de WebCiell2 JkAutoAlias /usr/tomcat/tomcat5/webapps JkMount /WebCiell2/* ajp13w </VirtualHost> Relancez Apache : Prompt>service<espace>httpd<espace> restart Page 8/11

VI.4) : Configuration de Tomcat Rien à faire. Le fichier de configuration server.xml d origine n est pas à modifier. Normalement par défaut il ouvre un port 8009 pour communiquer avec un éventuel redirecteur jk ou jk2 Il ne vous reste plus qu a tester sans passer par le port 8080 http://localhost/webciell2 VII) Passage en mode SSL avec OpenSSL : A suivre Page 9/11

ANNEXE Script tomcat à mettre dans /etc/rc.d/init.d #debut du script tomcat # ATTENTION AU CHEMIN, apportez des modification si nécessaire. #!/bin/sh # # Startup script for Tomcat, the Apache Servlet Engine # # chkconfig: 345 80 20 # description: Tomcat is the Apache Servlet Engine # processname: tomcat # pidfile: /var/run/tomcat.pid # # Mike Millson <mmillson@meritonlinesystems.com> # # version 1.02 - Clear work directory on shutdown per John Turner suggestion. # version 1.01 - Cross between Red Hat Tomcat RPM and Chris Bush scripts # Tomcat name :) TOMCAT_PROG=tomcat # if TOMCAT_USER is not set, use tomcat like Apache HTTP server if [ -z "$TOMCAT_USER" ]; then TOMCAT_USER="tomcat" fi RETVAL=0 # start and stop functions start() { echo -n "Starting tomcat: " } chown -R $TOMCAT_USER:$TOMCAT_USER /usr/tomcat/tomcat5/* chown -R $TOMCAT_USER:$TOMCAT_USER /home/tomcat/* su -l $TOMCAT_USER -c '/usr/tomcat/tomcat5/bin/startup.sh' RETVAL=$? echo [ $RETVAL = 0 ] && touch /var/lock/subsys/tomcat return $RETVAL stop() { echo -n "Stopping tomcat: " su -l $TOMCAT_USER -c '/usr/tomcat/tomcat5/bin/shutdown.sh' RETVAL=$? echo [ $RETVAL = 0 ] && rm -f /var/lock/subsys/tomcat /var/run/tomcat.pid rm -rf /usr/tomcat/tomcat5/work/* } # See how we were called. case "$1" in start) start ;; Page 10/11

stop) stop ;; restart) stop # Ugly hack # We should really make sure tomcat # is stopped before leaving stop sleep 2 start ;; *) echo "Usage: $0 {start stop restart}" exit 1 esac exit $RETVAL #fin du script tomcat Page 11/11