1 Installation de base Serveur JBoss

T.P. Architectures Logicielles
Installation Serveur JBoss
c Polytech Lille 2013
1
Installation de base Serveur JBoss
Le serveur d’applications JEE JBoss est accessible à l’adresse web suivante :
http://www.jboss.org/jbossas/downloads.
La version 7.1.1 de ce serveur est également disponible dans le répertoire suivant :
˜ocaron/public/AL/serveurJBoss/jboss-as-7.1.1.Final.tar.gz
Important : le serveur JBoss version 7 nécessite un interpréteur Java version 6 ou supérieur.
1.1
Installation
L’installation de base nécessite les deux opérations suivantes :
1. Extraction du fichier jboss-as-7.1.1.Final.tar.gz (ligne 5 de l’exemple)
2. Spécification d’un administrateur à l’aide de la commande add-user.sh (lignes 7-20 de l’exemple)
Voici un exemple d’installation du serveur JBoss 7 avec la définition d’un administrateur de nom jeeadm
et de mot de passe "secret"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
%> j a v a −v e r s i o n
j a v a v e r s i o n ” 1 . 6 . 0 17 ”
J a v a (TM) SE Runtime E n v i r o n m e n t ( b u i l d 1 . 6 . 0 17−b04 )
J a v a H o t S p o t (TM) S e r v e r VM ( b u i l d 14.3 − b01 , mixed mode )
%> t a r x v f z ˜ o c a r o n / p u b l i c / AL / s e r v e u r J B o s s / j b o s s −as − 7 . 1 . 1 . F i n a l . t a r . gz
%> cd j b o s s −as −7. j b o s s −as − 7 . 1 . 1 . F i n a l / b i n
%> . / add−u s e r . s h
What t y p e o f u s e r do you w i s h t o add ?
a ) Management U s e r ( mgmt−u s e r s . p r o p e r t i e s )
b ) A p p l i c a t i o n U s e r ( a p p l i c a t i o n −u s e r s . p r o p e r t i e s )
(a ):
E n t e r t h e d e t a i l s o f t h e new u s e r t o add .
Realm ( ManagementRealm ) :
Username : j e e a d m
Password :
Re−e n t e r P a s s w o r d :
About t o add u s e r ’ jeeadm ’ f o r r e a l m ’ ManagementRealm ’
I s t h i s c o r r e c t y e s / no ? y e s
...
Pour la suite, nous considérons que la variable d’environnement ${JBOSS HOME} désigne le répertoire
du serveur. Idéalement, votre fichier .bashrc devrait contenir les deux lignes suivantes :
e x p o r t JBOSS HOME = / home / . . . / j b o s s −as −7. j b o s s −as − 7 . 1 . 1 . F i n a l
e x p o r t PATH=${PATH} : ${JBOSS HOME } / b i n
1.2
Lancement du serveur
La version 7 du serveur JBoss se caractérise par un changement rapide (une dizaine de secondes) car la
plupart des services ne sont effectivement chargés en mémoire que lorsqu’ils sont sollicités. La commande
pour lancer le serveur est la suivante :
1
%> cd ${JBOSS HOME } / b i n
%> . / s t a n d a l o n e . s h
...
7 . 1 . 1 . F i n a l ” B r o n t e s ” s t a r t e d i n 3173ms − S t a r t e d 133 o f 208 s e r v i c e s ( 7 4 s e r v i c e s
a r e p a s s i v e o r on−demand )
Pour arrêter ce serveur, un simple CTRL-C suffit.
Lorsque le serveur JEE est actif, une console web d’administration permet de superviser l’activité du
serveur et est disponible à l’adresse http://localhost:8080, sélectionnez ensuite ”Administration
Console”, un login/password vous est demandé, indiquez les nom et mot de passe de l’administrateur que
vous avez créé préalablement avec la commande add-user.sh.
2
Ajout d’une source de données
L’objectif est de compléter l’installation de base avec l’ajout d’une nouvelle source de données qui sera
une base de données d’un serveur Postgres. Cette source sera accessible par le serveur de nom JNDI inclus
dans le serveur JEE. Cette installation se fait en deux étapes :
– Installation du driver JDBC dédié au serveur postgres
– Installation de la source de données.
2.1
Driver Postgres
L’architecture du serveur JBoss est modulaire. Toute librairie Java est déployée dans l’arborescence à partir de ${JBOSS HOME}/modules avec un descripteur XML qui indique les dépendances du module
déployé avec d’autres librairies. La procédure d’installation est la suivante :
1. Création du répertoire ou sera déployé le module (lignes 2-3 de l’exemple)
2. Stockage du driver (ligne 5 de l’exemple). Le driver se trouve également dans le répertoire :
˜ocaron/public/AL/serveurJBoss/
3. Stockage du descripteur XML (ligne 6 de l’exemple) :
<module xmlns =” u r n : j b o s s : m o d u l e : 1 . 1 ” name=” o r g . p o s t g r e s q l ”>
<r e s o u r c e s>
<r e s o u r c e −r o o t p a t h =” p o s t g r e s q l . j a r ” />
</ r e s o u r c e s>
<d e p e n d e n c i e s>
<module name=” j a v a x . a p i ” />
<module name=” j a v a x . t r a n s a c t i o n . a p i ” />
</ d e p e n d e n c i e s>
</ module>
4. Activation du module (lignes 7-10) de l’exemple. Le serveur JBoss doit être lancé lors de l’activation
du module.
Voici un exemple d’installation de ce module :
1
2
3
4
5
6
7
8
9
10
11
%> cd ${JBOSS HOME } / m o d u l e s
%> m k d i r o r g / p o s t g r e s q l
%> m k d i r o r g / p o s t g r e s q l / main
%> cd o r g / p o s t g r e s q l / main
%> cp / u s r / s h a r e / j a v a / p o s t g r e s q l . j a r .
%> cp ˜ o c a r o n / p u b l i c / AL / s e r v e u r J B o s s / module . xml .
%> ${JBOSS HOME } / b i n / j b o s s − c l i . s h −−c o n n e c t command=” / s u b s y s t e m = d a t a s o u r c e s /
j d b c −d r i v e r = p o s t g r e s q l −d r i v e r : add ( d r i v e r −name= p o s t g r e s q l −d r i v e r ,
d r i v e r −c l a s s −name= o r g . p o s t g r e s q l . D r i v e r , d r i v e r −module−name= o r g . p o s t g r e s q l ”
{ ” outcome ” => ” s u c c e s s ” }
%>
Pour éviter des erreurs de saisie, le script loadDriverPostgres.sh qui exécute ces commandes est
disponible dans le répertoire : ˜ocaron/public/AL/serveurJBoss
2
2.2
Définition de la source de données
Voici la procédure pour créer et définir une nouvelle source de données :
– Création d’une base de données de nom jeedbVotreLogin sur le serveur POSTGRES de la machine
weppes.studserv.deule.net de l’école (rappel commande createdb jeedbVotreLogin).
– Enregistrement de cette base dans le serveur JBoss via la console d’administration web :
1. Accédez à http://localhost:8080
2. Cliquez sur Administration Console, rentrez login et mot de passe de l’administrateur.
3. Sélectionnez l’onglet "Profile" (en haut, à droite). Dans la partie ”Datasources”, cliquez sur le
bouton ”Add”.
4. Saisissez ”PostgresDS” et ”java :jboss/datasources/PostgresDS” pour les champs ”Name” et ”JNDI
Name”, cliquez sur ”Next”.
5. Sélectionnez ”postgresql-driver”, cliquez sur ”Next”.
6. Saisissez ”jdbc :postgresql ://weppes.studserv.deule.net/jeedbVotreLogin”, votre nom de login, et
votre mot de passe pour les champs ”Connection URL”, ”Username”, et ”Password”. Les noms de
login et password demandés correspondent à votre compte enregistré par le serveur Postgres. Par
défaut, le login du compte postgres est le même que le login UNIX (les caractères ’-’ sont remplacés
par ’ ’) et le mot de passe par défaut est ”postgres”. Laissez le champ ”Security Domain” vide puis
cliquez sur ”Done”.
7. Sélectionnez votre nouvelle source de données et cliquez sur le bouton ”enable”.
Cette source de données sera utilisée lors de la programmation de composants EJB entités.
3