1- Procédures d'installation suivies

  • Toutes les installations se font à distance, c'est-à-dire en utilisant putty avec Windows pour se connecter en ssh.
  • Lorsque des fichiers doivent être modifiés, on utilise l'éditeur Vi, même si la prise en main n'est pas évidente.



2- Installation de la JDK 1.5
Nous voulons installer Tomcat donc auparavant nous devons installer la JDK 1.5. Pour cela nous allons installer le paquet sun-java5-jdk avec la commande :

sudo apt-get install sun-java5-jdk

Dans l'outil de configuration des paquets, utiliser la touche Tab pour se déplacer sur les boutons, et Entrée pour "cliquer".
Pour vérifier si l'installation c'est bien passée, on tape la commande :

java -version

Et on obtient :
java version "1.5.0_15"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_15-b04)
Java HotSpot(TM) Client VM (build 1.5.0_15-b04, mixed mode, sharing)


Pour plus d'informations sur Java voir : http://doc.ubuntu-fr.org/java



3- Installation de Tomcat 5.5
Une fois la JDK installée nous pouvons nous occuper de Tomcat 5.5.
La documentation se trouve ici : http://doc.ubuntu-fr.org/tomcat
En fait nous allons installer 3 paquets :

  • tomcat5.5 : le serveur
  • tomcat5.5-admin : l'application web pour administrer tomcat
  • tomcat5.5-webapps : des exemples d'applications web
sudo apt-get install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps

A la fin de l'installation le serveur démarre automatiquement. Tout comme OpenSSH, il est possible de le contrôler avec :

sudo /etc/init.d/tomcat5.5 restart
sudo /etc/init.d/tomcat5.5 stop
sudo /etc/init.d/tomcat5.5 start

En ce qui me concerne, la configuration initiale fait que Tomcat écoute sur le port 8180. Donc, dans la machine virtuelle, nous pouvons accéder au serveur en tapant le lien http://localhost:8180 et http://localhost:8180/admin pour l'application d'administration.



4- Configuration de Tomcat 5.5
Un minimum de configuration s'impose. Tout d'abord nous allons changer le port d'écoute en 8080. Cette propriété se trouve dans le fichier server.xml que l'on trouve dans le répertoire d'installation.

cd /etc/tomcat5.5
ls

Pour le modifier on utilise Vi :

sudo vi server.xml

Avec les flèches on se déplace dans le fichier jusqu'à trouver la ligne :

   <Connector port="8180" maxHttpHeaderSize="8192"

Et on change ce port pour mettre 8080. Avec les flèches on déplace le curseur sur le caractère "1". On tape la touche "r" (Remplace le caractère sous le curseur par le prochain caractère tapé) puis 0. Attention, il ne faut pas utiliser le pavé numérique !
Pour enregistrer et sortir (write quit), on tape :

:wq

Voici un petit guide des commandes Vi : http://www.linux-france.org/prj/support/outils/vi.html

Une fois cette manipulation réalisée, on redémarre le serveur et on peut se connecter avec l'url http://localhost:8080 :

sudo /etc/init.d/tomcat5.5 restart



La deuxième étape consiste à créer des utilisateurs et des rôles. Il nous faut un rôle manager (permettant d'accéder à Tomcat Manager) et un rôle admin (permettant d'accéder à Tomcat Admin). De plus il faut des utilisateurs associés à ces rôles. Un utilisateur peut avoir plusieurs rôles.
La configuration des rôles et utilisateurs se fait dans le fichier tomcat-users.xml.
Au final le fichier ressemble à :

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <role rolename="manager"/>
  <role rolename="admin"/>
  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <user username="darkmarmotte" password="darkmarmotte" roles="admin,manager"/>
  <user username="tomcat" password="tomcat" roles="tomcat"/>
  <user username="role1" password="tomcat" roles="role1"/>
  <user username="both" password="tomcat" roles="tomcat,role1"/>
</tomcat-users>

On redémarre le serveur. On peut alors s'identifier sur Tomcat Manager et Tomcat Admin avec les identifiants / mot de passe : darkmarmotte/darkmarmotte

Si tout s'est bien passé, on quitte Ubuntu et on crée un nouvel instantané par précaution dans VirtualBox !

5- Modification de la configuration de la machine virtuelle
Afin d'accéder à notre serveur Tomcat depuis Windows (machine Host), nous allons devoir modifier la configuration de la machine virtuelle.
De la même manière que cela a été fait pour la connection SSH, nous allons faire un mapping entre le port 8180 de la machine Host et le port 8080 de la machine Guest.
On ajoute donc quelques lignes dans notre fichier setup_conf_virtualBox.bat :

...
REM Config tomcat port 8180 -> 8080
set HostPort=8180
set GuestPort=8080
set NomMapping=tomcat
VBoxManage setextradata %VM% "VBoxInternal/Devices/%Device%/0/LUN#0/Config/%NomMapping%/HostPort" %HostPort%
VBoxManage setextradata %VM% "VBoxInternal/Devices/%Device%/0/LUN#0/Config/%NomMapping%/GuestPort" %GuestPort%
VBoxManage setextradata %VM% "VBoxInternal/Devices/%Device%/0/LUN#0/Config/%NomMapping%/UDP" 0
REM Visualiser la conf
VBoxManage getextradata %VM% enumerate

Une fois la machine virtuel redémarrée, on peut dans Windows accéder à Tomcat avec l'url http://localhost:8180 .

6- La suite...
Dans le prochain tutoriel, nous allons voir comment déployer un war sur le serveur tomcat !