vers l'accueil formulaire de contact

Tutoriel ActiveMQ N°1 : installation ActiveMQ et analyse

Maîtrisez l’installation du fournisseur de messages open source le plus populaire : ActiveMQ. Testez votre installation et monitorez ActiveMQ avec JMX. Découvrez enfin des éléments de configuration d’ActiveMQ

Ce tutoriel est offert par Objis, le spécialiste de la formation JAVA.

Les + objis - 70% de travaux pratiques
- Clé USB avec tous les outils utilisés + Corrigés TPs
- Bilan pédagogique individuel + conseils

Liens utiles

- + de 100 tutoriaux java/jee Objis
- Vos premiers pas de programmeur JAVA
- Objis, spécialiste formation java depuis 2005
- Site officiel d’ActiveMQ

Prérequis

- Aucun

Objectifs

- Télécharger et installer le fournisseur de messages ActiveMQ
- Tester l’installation via JMX (page web + jconsole)

Programme

- Partie 1 : Téléchargement
- Partie 2 : Démarrer ActiveMQ
- Partie 3 : test du démarrage
- Partie 4 : Arrêter ActiveMQ
- Partie 5 : Analyse

Durée

- 30 min

Partie 1 : Téléchargement

- Créez sur votre disque dur un répertoire c :\formationactivemq dans lequel vous allez réceptionner le téléchargement d’ActiveMQ.

- Rendez-vous sur le site d’ActiveMQ : http://activemq.apache.org

- Cliquez sur le lien Download . Vous obtenez la page suivante.

- Cliquez sur le lien correspondant à la dernière version, ici ActiveMQ 5.2.0 Release . Vous arrivez sur une page à partir de laquelle vous pouvez télécharger la version adaptée à votre environnement.

- Cliquez sur l’archive qui vous convient, par exemple apache-activemq-5.2.0-bin.zip

Vous arrivez sur la page suivante.

- Cliquez sur le le lien associé au mirroir suggéré, ici http://apache.autinity.de/activemq/apache-activemq/5.2.0/apache-activemq-5.2.0-bin.zip

Le téléchargement commence.

- Téléchargez et sauvegardez le fichier activeMQ (ici apache-activemq-5.2.0-bin.zip) dans répertoire c :\formationactivemq\outils créé précédemment.

- Dézippez l’archive dans le répertoire c :\formationactivemq . Vous obtenez l’arborescence suivante :

ActiveMQ est désormais téléchargé et installé. Reste à démarrer...

ARBORESCENCE :

— activemq-all-5.2.0.jar : rassemble tous le contenu de tous les jars présents dans le répertoire lib. Utile aux développeurs Java.
— bin : exécutables activemq
— conf : fichiers de configuration d’ActiveMQ
— data : stockage des logs et des messages persistents
— example : exemples d’application. Utile pour valider bonne installation
— lib : librairies
— user-guide.html : guide utilisateur pour démarrer ActiveMQ
— webapps : console web ActiveMQ et qqs demos
— WebConsole-README.txt : infos utiles pour utiliser la console web
- README.txt : contient liens utiles pour la documentation ActiveMQ

Partie 2 : Démarrer ActiveMQ

- Lancez un ’Invite de commande’ (fenêtre MS-DOS) : Menu Demarrer/Programmes/Accessoires/Invite de commande
- Placez-vous dans le répertoire d’installation d’ActiveMQ , ici c :\formationactivemq\apache-activemq-5.2.0-bin et entrez la commande : bin\activemq qui lance le script activemq.bat du répertoire bin d’ActiveMQ.

ActiveMQ est désormais démarré...

REMARQUE : ActiveMQ démarre certains connecteurs permettant d’exposer ActiveMQ à travers 4 protocoles par défaut : TCP, SSL, STOMP, XMPP .

Partie 3 : test du démarrage

Dans les logs console d’ActiveMQ, validez l’existence de la ligne :

INFO ActiveMQ JMS Message Broker (ID:xxxxxx-s-Computer.local-51222-1140729837569-0:0) has started

Le serveur vous informe qu’il est bien démarré

TECHNIQUE TEST N°1 :Utilisation du port ActiveMQ : 61616

- Sous Invite de commande, lancez : netstat -an|grep 61616

Vous devez obtenir une information similaire à ceci.

Le port 61616 est bien occupé par ActiveMQ, qui est en écoute.

TECHNIQUE TEST N°2 :Test avec console web

- Avec votre navigateur, allez à l’adresse suivante : http://localhost:8161/admin

La console affiche des informations sur ActiveMQ : serveur hote, queues...

Test avec jconsole

- Avec un autre invite de commande, lancez la commande : jconsole disponible dans le répertoire bin de votre jdk (depuis java 5)

- Selectionnez le processus local ’run.jar Start’ puis bouton ’Connect’

Vous pouvez ainsi monitorer les différents objets du serveur.

TECHNIQUE TEST N°3 : Tests avec exemples ActiveMQ

Dans le répertoire ’example’ d’ActiveMQ vous pouvez voir :

— build.xml : un fichier de configuration ANT pour les exemples
— conf : fichiers de configuration pour les exemples
— perfharness : scripts pour l’outils de perf JMS d’IBM
— ruby : exemple d’utilisation ActiveMQ avec Ruby et le protocole STOMP
— src : code source des exemples

- Ouvrez une autre fenêtre et , à partir du répertoire example, lancez la commande ant consumer

Cette commande lance un programme client java qui va
— Se connecter au broker activeMQ (tcp ://localhos:61616)
— souscrire une file de message nommée TEST.FOO
— Attendre de récupérer 2000 messages avant de se déconnecter de la file

- Ouvrez une autre fenêtre et , à partir du répertoire example, lancez la commande ant producer

Cette commande lance un programme client java qui va :
— Se connecter au broker activeMQ (tcp ://localhos:61616)
— Envoyer 2000 messages dans une file de message nommée TEST.FOO

Aussitôt qu’un message est déposé, le client le récupère.

Vous avez ainsi testé que votre ActiveMQ est bien installé en local.

Partie 4 : Arrêter ActiveMQ

A partir de la fenêtre qui a servi à lancer Active MQ, faire "CTRL+C" . cette combinaison de touches arrête ActiveMQ.

Partie 5 : Analyse

Le fichier de configuration par défaut d’activeMQ (activemq.xml) est présent dans le répertoire conf d’activeMQ.

Remarque : il s’agit d’un fichier de configuration de type Spring.

Notez la déclaration des XML Schéma suivants :

http://activemq.apache.org/schema/core http://activemq.apache.org/schema/core/activemq-core.xsd

et

http://activemq.apache.org/camel/schema/spring http://activemq.apache.org/camel/schema/spring/camel-spring.xsd

Ils sont spécifiques à ActiveMQ et à Camel, le framework Apache d’implémentation des Enterprise Application Pattern.

Conclusion

Dans ce tutoriel, vous avez téléchargé, installé et démarré ActiveMQ. Vous avez testé l’installation avec en particulier la mise en oeuvre des exemples de programme client/serveurs fournis avec ActiveMQ.

Vous avec enfin découvert 2 techniques basées sur JMX pour monitorer ActiveMQ (console web + jconsole).

Pour aller plus loin

Le fichier de configuration d’activeMQ, que vous avez découvert fera l’objet d’un autre tutoriel plus complet.

Étape suivante de votre apprentissage : créer des messages et les insérer dans ActiveMQ.

La création de message peux se faire via plusieurs langages de programmation, dont Java. ActiveMQ implémente l’API JMS 1.1 dans ce sens. Vous pouvez créer des ’clients’ JMS pour activeMQ de plusieurs façon, dont ’à la main’ ou via Spring ou encore EJB3.