Installation de JBoss 5.1 sur Windows 7 64 bits

 

JBoss nécessite un JDK 5 ou 6. Le JDK n’est pas installé par défaut sur une machine. Seul la JRE est installé.

Installation d’un JDK 6 pour Windows 7 64 bits

Sur le site http://developers.sun.com/downloads/ on choisit le nœud Java SE de la liste des téléchargement puis on clique sur Java SE (JDK) 6.

Ensuite je choisis la version JDK 6 update 18 et non pas le Development Kit Bundle.

Il existe un installeur spécifique à Windows 64 bits : jdk-6u18-windows-x64.exe.

On exécute l’exe téléchargé. Le UAC demande l’acceptation des modifications faites par le programme.

Personnellement, j’ai supprimé le Source code.

On appuie sur Next > ce qui lance une première partie de l’installation.

A la fin, une nouvelle dialogue apparaît :

L’apparition de cette dialogue doit correspondre au choix de l’option Public JRE du premier setup.

Je confirme l’installation de la JRE. L’installation se poursuit.

J’ai maintenant dans mon répertoire C:\Program Files\Java deux sous répertoires :

• jdk1.6.0_18 : le jdk. C’est nécessaire pour compiler des classes java ou des JSP.
• jre6 : le runtime java. Ce répertoire existait déjà

Installation de JBoss 5.1

Le téléchargement d’un serveur JBoss commence à la page suivante : http://www.jboss.org/jbossas/downloads/

Il faut choisir Download pour le serveur 5.1. Un message d’avertissement s’affiche en indiquant qu’ils’agit d’une version Community ne disposant pas de support. Il faut continuer.

Sur la page suivante, on choisit la ligne jboss-5.1.0.GA-jdk6.zip.

Attention ! il y a deux versions différentes de JBoss 5.1 : une version pour le jdk 1.5 et une version pour le jdk 1.6. Ne vous trompez pas !

Le téléchargement commence.

Je dezippe le fichier téléchargé jboss-5.1.0.GA-jdk6.zip et le copie directement sous C:\ de façon à avoir : C:\jboss-5.1.0.GA.

Modification de run.bat

Dans le répertoire C:\jboss-5.1.0.GA\bin j’ouvre en modification le fichier run.bat.

On ajoute en première ligne du bat :

Set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_18

Il s’agit a priori de l’emplacement de votre jdk 1.6 64 bits. Sous Windows 7, un JDK 64 bits s’installe sous C:\Program Files.

Personnellement, je ne positionne pas la variable d’environnement JBOSS_HOME. Le bat run.bat semble être capable de la positionner correctement tant qu’on le lance depuis son répertoire d’installation.

Rappel de l’organisation des répertoires

Si vous avez installé JBoss dans le répertoire C:\jboss-5.1.0.GA, voici un rapide tour d’horizon des quelques répertoires les plus importants pour le développement.

• C:\jboss-5.1.0.GA\bin : répertoire dans lequel se trouve run.bat qui permet de lancer le serveur
• C:\jboss-5.1.0.GA\common\lib : répertoire permettant d’ajouter un jar qui sera commun à toutes vos applications et toutes vos configurations. C’est là qu’on ajoute généralement les jar permettant l’accès à la base de données.
• C:\jboss-5.1.0.GA\server\default\lib : répertoire commun à toutes vos applications de la configuration “default”
• C:\jboss-5.1.0.GA\server\default\tmp : répertoire temporaire qui semble être utilisé par le déploiement. Il peut être supprimé sans problème en phase de développement. Il sera recréé au prochain lancement du serveur.
• C:\jboss-5.1.0.GA\server\default\log : répertoire contenant la log du serveur quand on utilise la configuration “default”. Le fichier server.log contient la log Log4j de votre application.
• C:\jboss-5.1.0.GA\server\default\deploy : répertoire de déploiement de vos war pour la configuration “default”. Glisser/déposer un war dans ce répertoire est la seule opération à faire pour déployer une application sur un serveur JBoss.

Pour finir, il reste

• C:\jboss-5.1.0.GA\lib : auquel il ne faut pas toucher. Il contient les jar du serveur. Ce répertoire ne doit plus être utilisé, il faut favoriser (a priori) le répertoire C:\jboss-5.1.0.GA\server\default\lib qui n’affectera que la configuration par default.

Rappel sur les configurations de JBoss

Par défaut, JBoss livre 5 configurations :

• all
• default : celle qui est utilisé quand on lance run.bat sans paramètre
• minimal
• standard : c’est la config JavaEE de JBoss
• web : cela semble être une configuration légère.

Personnellement je n’utilise que default car elle semble contenir ce dont j’ai besoin et elle possède l’avantage d’être simple à lancer.

Test de l’installation

Pour lancer le serveur JBoss, on double clique sur le bat : run.bat qui se trouve dans C:\jboss-5.1.0.GA\bin. Un message vous demande de confirmer son exécution, il faut l’acquitter.

Windows 7 affiche un message d’alerte du parefeu : il faut l’accepter.

Quand le lancement du serveur est terminé, la boite de commande affiche une ligne :

2010-03-05 13:19:49,240 INFO  [org.jboss.bootstrap.microcontainer.ServerImpl] (main) JBoss (Microcontainer) [5.1.0.GA (build: SVNTag=JBoss_5_1_0_GA date=200905221634)] Started in 1m:7s:671ms

Votre serveur JBoss s’exécute avec la configuration par défaut : default.

Taper dans un navigateur : http://localhost:8080/

Vous devriez voir apparaître dans votre navigateur :

Si vous cliquez sur le lien JBoss Web Console, vous obtenez un second écran :

Dans la partie JVM Hardware vous pouvez vérifier la JVM utilisée :

• JVM Name : Java HotSpot(TM) 64 bits Server VM

Cela indique que vous utilisez bien le JDK 64 bits.

Vous pouvez également ouvrir le Gestionnaire de tâches Windows : tapez Processus et sélectionnez “Affichez les processus en cours d’exécution avec le Gestionnaire de tâche”.

Le gestionnaire de tâches indique si le processus java.exe est ou non en 32 bits :

• java.exe *32 : s’il s’agit d’un process 32 bits
• java.exe : s’il s’agit d’un process 64 bits.

Pour arrêter le serveur JBoss, il suffit de taper Ctrl C dans la console DOS.

Conclusion

L’installation de JBoss 5.1 demande de faire particulièrement attention au JDK utilisé (5 ou 6) : en fonction de ce dernier il faudra télécharger le bon zip de JBoss.

JBoss étant un processus Java, c’est la JVM utilisée qui fera ou non fonctionner JBoss 5.1 en 32 ou 64 bits.

Pour finir, l’installation décrite dans ce billet correspond à une installation pour un poste développeur : elle ne prend pas en compte la problématique de la sécurité et ne sera de toute façon pas visible depuis un autre poste. Seule l’adresse localhost fonctionnera (c’est la cas depuis au moins la 4.2).

DiggIt! Enregistrer sur Del.icio.us