Dominux

Tomcat 4.0.x/Domino 6 sous Debian GNU/Linux

Olivier FRANCHET a écrit le Mardi 5 Mars 2002 à 21:16:53

Actuellement en cours d'écriture, cet article devrait présenter la mise en place du serveur de JSP Tomcat avec Domino6. L'intégration sera réalisé par le DSAPI disponible sur free.tagish.net et suivra le whitepaper pour w2k disponible sur NotesOSS.org.

Pour les anglophobes impatients, vous trouverez une serie d'articles sur domino-dev écrit par Lionel qui sont basés sur le whitepaper de JVM mais qui ne concerne que les serveurs sous window$.

Notes du 27/03/2002 :

Je rencontre actuellement quelques difficultés à mettre en place Tomcat 4.0.x/Domino 6. Je travail en ce moment sur la recompilation du redirecteur avec la version 4.0.x de tomcat car celui présent sur free.tagish.net est basé sur Tomcat 3.x.x.
Un autre problème subsiste en ce qui concerne la JVM utilisé par Domino et par Tomcat. La verion Domino 6 pour Linux est livré pour l'instant avec le JRE 1.2.2, contrairement à la version Windows qui est elle livré avec le 1.3.1. Tomcat 4, quand à lui, utilise le JRE 1.3.x. Une prochaine version de Domino 6 pour Linux devrait intégrer le JRE 1.3.1, donc mes travaux sont stoppés en attendant cette mise à jour.

1 - installer le java2 sdk 1.3.1

La première chose à réaliser avec une debian ... trouver l'archive en .deb quelque part sur la toile. Après quelques recherches, voici le lien à ajouter à votre /etc/apt/sources.list :

# packages pour le j2sdk 1.3.1
deb ftp://ftp.oleane.net/pub/java-linux/debian woody non-free

puis une commande 'naturelle' ( attention, un certain nombre de packages vont aussi être installés suivant les dépendances ) :

Debian:~#apt-get install j2sdk1.3

et pour finir, ajouter la variable d'environnement JAVA_HOME, soit dans le .bash_profile du profil qui va lancer Tomcat (normalement le même que Domino). Pour ma part, j'ai ajouté au fichier général /etc/profile les lignes suivantes :

# répertoire racine du j2sdk
JAVA_HOME="/usr/lib/j2sdk1.3"
export JAVA_HOME

2 - installer et configurer Tomcat 4.0.2

Avant tout, vous devez vous procurer l'archive de Tomcat que vous trouverez ici ( ATTENTION : la version de tomcat disponible sur debian est une 3.3 sous woody au moment où ce texte est écrit ).

Une fois l'archive entre vos mains, désarchivez-la, de préférence dans un répertoire dédié comme /usr/local/apache/. .

Voici les commandes :

Debian:~#mkdir /usr/local/apache
Debian:~#cd /usr/local/apache
Debian:~#tar zxvf ~/jakarta-tomcat-4.0.2.tar.gz

Pour ma config., j'ai créé un lien dans /opt :

Debian:~#cd /opt
Debian:~#ln -s /usr/local/apache/jakarta-tomcat-4.0 tomcat

Ensuite, il faut créer les fichiers uriworkermap.properties et workers.properties dans le répertoire conf/ :

Le fichier uriworkermap.properties :

# *********** Begin uriworkermap.properties ***


# 

# Simple worker configuration file 

# 

# Mount the Servlet context to the ajp13 worker 

/servlet/*=ajp12 

# Mount the examples context to the ajp13 worker 

/examples/*=ajp13 

/examples/jsp/*=ajp13 

# Advanced mount of the examples context 

/examples/servlet/*=ajp13 

# ************* End uriworkermap.properties ****

Ce fichier est la définition des règles d'accès (ou chemins d'accès pour faire plus simple) à vos JSPs. Pour le test de bon fonctionnement de tomcat, laissez /examples/*=ajp13 et /examples/jsp/*=ajp13 , vous devrez adapter ce fichier à vos développements.

Le fichier workers.properties :

# ************ Begin worker.properties **************


worker.ajp13.type=ajp13 

# 

# Specifies the load balance factor when used with


# a load balancing worker. 

# Note: 

# ----> lbfactor must be > 0 

# ----> Low lbfactor means less work done by the worker.


worker.ajp13.lbfactor=1 

# 

# Specify the size of the open connection cache. 

#worker.ajp13.cachesize 

# 

#------ DEFAULT LOAD BALANCER WORKER DEFINITION ----------------------


#---------------------------------------------------------------------


# 

# 

# The loadbalancer (type lb) worker perform weighted round-robin


# load balancing with sticky sessions. 

# Note: 

# ----> If a worker dies, the load balancer will check its state


# once in a while. Until then all work is redirected to peer


# worker. 

worker.loadbalancer.type=lb 

worker.loadbalancer.balanced_workers=ajp13 

# 

# worker.tomcat_home should point to the location where you


# installed tomcat. This is where you have your conf, webapps and lib


# directories. 

# 

worker.tomcat_home=/opt/tomcat 

# 

# worker.java_home should point to your Java installation. Normally


# you should have a bin and lib directories beneath it.


# 

worker.java_home=/usr/lib/j2sdk1.3 

# 

# You should configure your environment slash... ps=\ on NT and / on UNIX


# and maybe something different elsewhere. 

# 

ps=/ 

# 

#------ ADVANCED MODE ------------------------------------------------


#---------------------------------------------------------------------


# 

# 

#------ DEFAULT worker list ------------------------------------------


#---------------------------------------------------------------------


# 

# The worker that your plugins should create and work with


worker.list=ajp13 

# 

#------ DEFAULT ajp13 WORKER DEFINITION ------------------------------


#---------------------------------------------------------------------


# 

# 

# Defining a worker named ajp13 and of type ajp13 

# Note that the name and the type do not have to match.


# 

worker.ajp13.port€09 

worker.ajp13.host=127.0.0.1 

# ************ End worker.properties **************

Dans ce fichier, vous devez penser à modifier les chemins d'accès à java2 ET à Tomcat. ATTENTION : si vous utilisez les fichiers fournis sur NotesOSS.org, pensez également à modifier la variable ps=/ (nous sommes sous linux).

Note importante : Lors de l'installation de Tomcat, le profil 'notes' n'a pas les droits nécessaires pour travailler avec l'arborescence de Tomcat. Voici la commande pour défnir les droits récursivement :

Debian:~#chown -R notes.notes /opt/tomcat/*

Voila, vous êtes prêt pour votre premier test avec tomcat ...
1. lancer Tomcat :

Debian:~#/opt/tomcat/bin/startup.sh

2. accèder aux exemples avec votre navigateur préféré : http://MonServeur:8080/examples/index.jsp
3. testez l'exemple 'Numberguess'. Cet exemple vous propose de découvrir un nombre en 1 et 100. Si cet exemple fonctionne, bravo, Tomcat est opérationnel!
4. arrêter Tomcat :

Debian:~#/opt/tomcat/bin/shutdown.sh

Si vous avez un souci, revoyez les étapes précedentes, vous avez du oublier quelques !!!! ( au pire, vous pouvez m'envoyez un mail ;-) )

3 - la configuration pour Domino 6

(en cours d'ecriture)

4 - conclusion

(en cours d'ecriture)

Où trouver de l'information :

- NotesOSS.org
- Domino-dev
- notes.net
- free.tagish.net

Commentaire(s)

Re: Tomcat 4.0.x/Domino 6 sous Debian GNU/Linux

Olivier@Dominux le 06/02/2003 21:27:47

J'ai répondu pour les liens cassés sur Domino/PERL ! 8)

Sinon, tu peux te baser sur ce que j'ai écrit pour l'installation de Domino 6 sur la Debian ... je ne pense pas qu'il y ai beaucoup de différences mais si tu rencontres des problèmes, n'hésites pas à les retourner sur ce site (en réponse à l'article d'install Domino sur Debian par exemple ;) )