TUTORIEL D`UTILISATION D`APACHE GERONIMO

TUTORIEL D’UTILISATION D’APACHE GERONIMO
Pierre Frayer & François Lefebvre – M2 Miage IPI-NT
INSTALLATION ET CRÉATION DU COMPTE ADMINISTRATEUR: Pour fonctionner, Geronimo aura besoin de connaître les répertoires
d'installation de Java. Le lien n'étant pas fait par défaut sur les machines de la
fac, créez le en remplissant la variable d'environnement JRE_HOME :
echo 'export JRE_HOME="/usr/lib/jvm/j2sdk1.7-oracle/jre"' >> ~/.bashrc
Téléchargez la version 3.0.1 de Geronimo à l'adresse suivante en fonction de
votre plateforme :
http://geronimo.apache.org/apache-geronimo-v301-release.html
Lien direct sur la version Unix pour les PC de la fac :
http://apache.crihan.fr/dist/geronimo/3.0.1/geronimo-tomcat7-javaee6-web3.0.1-bin.tar.gz
Dézippez l'archive et placer vous dans le dossier obtenu :
tar -zxvf geronimo-tomcat7-javaee6-web-3.0.1-bin.tar.gz && cd
geronimo-tomcat7-javaee6-web-3.0.1/
Créez-vous un compte administrateur (le login/password par défaut est
system/manager, mais ne semble pas fonctionner) en modifiant le fichier
./var/security/groups.properties et en y rajoutant le login de votre choix
derrière le “admin=”:
admin=jean­claude
Dans le cas où on à plusieurs users, on sépare par une virgule:
admin=jean­claude,robert
Associez un mot de passe à ce compte dans le fichier
./var/security/users.properties :
sous la forme “user=password” (un user par ligne):
jean­claude=camembert
DÉMARRER, ARRÊTER GERONIMO ET ACCÉDER À LA CONSOLE D'ADMIN :
Pour démarrer le serveur, lancez la commande :
./bin/geronimo start
(ou ./bin/geronimo run pour pouvoir taper des commandes de geronimo)
Pour arrêter le serveur:
./bin/geronimo start
Pour la console d'admin, ouvrez un navigateur et allez sur
http://localhost:8080/console
DÉPLOYER UNE APPLICATION:
Dans le menu de gauche, cliquez sur « Déployer ». Indiquez l'adresse du
fichier WAR et son éventuelle plan de déploiement, puis cliquez sur
« Install »
Une notification apparaît si le déploiement s'est bien déroulé.
Pour voir l'application dans la console, cliquez sur « Web Apps (WAR) » dans
le menu de gauche. De là, vous pouvez stopper, redémarrer ou désinstaller une
appli.
INFOS UTILES:
Geronimo est un serveur d'application open-source développé par la Apache
Software Foundation et distribué sous licence Apache.
Geronimo embarque un serveur Tomcat et est compatible avec les
spécifications Java EE 5 et 6, comme par exemple les servlets, les portlets,
les JSP, JDBC, RMI, e-mail, JMS ou encore web services.
La liste des composants qu’embarque Geronimo :
Component
Description
Apache
Tomcat
HTTP server and Servlet container supporting Java Servlet 2.5
and JavaServer Pages (JSP) 2.1.
HTTP server and Servlet container supporting Java Servlet 2.5
and JavaServer Pages 2.1—an alternative to the Tomcat server.
Open source Java Message Service (JMS) 1.1 applications
provider and supporter of message-driven beans (MDBs).
Open source Enterprise JavaBeans (EJB) Container System and
EJB Server that supports Enterprise JavaBeans at the 3.0 level,
including Container Managed Persistence 2 (CMP2) and EJB Query
Language (EJBQL).
Jetty
Apache
ActiveMQ
Apache
OpenEJB
Apache
OpenJPA
Apache
ServiceMix
Open source Java Persistence API (JPA) 1.0 implementation.
Open source Enterprise Service Bus (ESB) and component suite
based on the Java Business Integration (JBI) standard on JSR 208.
Axis is a Simple Object Access Protocol (SOAP) implementation,
Apache Axis
while Scout is a JSR 93 (JAXR) implementation. These provide
and Apache
support for Web Services and Web Services Interoperability
Scout
Organization (WS-I) Basic Profile support.
Web Services frameworks with variety of protocols such as SOAP,
Apache CXF
XML/HTTP, RESTful HTTP, or CORBA and work over a variety of
transports such as HTTP, JMS or JBI.
Full-fledged relational database management system (RDBMS)
Apache Derby
with native Java Database Connectivity (JDBC) support.
Clustering, load balancing and failover solution for the web
Apache WADI application container tier. (The project is currently in incubation
under the Apache Incubator.)
Java Management Extensions that supplies tools for managing
MX4J
and monitoring applications, system objects, devices and service
oriented networks.
Dans le dossier où est Geronimo, deux sous dossiers peuvent nous intéresser:
– bin : contient les différents binaires permettant de lancer/gérer le serveur
– var : contient les différents fichiers de configuration, autant pour
Geronimo que pour Tomcat