1 Installation de base Serveur JBoss
Transcription
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