La page Service JMS permet de configurer les paramètres à utiliser par toutes les connexions JMS.
Pour plus d'informations sur la configuration du service JMS, reportez-vous au chapitre 19, Using the Java Message Service, du manuel Oracle GlassFish Server Application Development Guide.
Dans l'arborescence de navigation, développez le noeud Configuration.
Sélectionnez l'instance à configurer :
Pour configurer une instance spécifique, sélectionnez le noeud de configuration de l'instance. Par exemple, pour l'instance par défaut, server, sélectionnez le noeud server-config.
Pour configurer les paramètres par défaut des futures instances utilisant une copie de default-config, sélectionnez le noeud default-config.
Sous le noeud Configuration, sélectionnez le noeud Service JMS.
La page Service JMS apparaît.
Dans la liste déroulante Type :
Sélectionnez EMBEDDED pour accéder au service JMS sur l'hôte local.
Le service JMS est démarré sur la même JVM que GlassFish Server. L'initialisation en différé démarre le broker imbriqué par défaut au premier accès des services JMS et non au démarrage de GlassFish Server. Il s'agit du type de service JMS par défaut.
Sélectionnez LOCAL pour accéder au service JMS sur l'hôte local.
Le service JMS est démarré en même temps que GlassFish Server.
Sélectionnez REMOTE pour accéder au service JMS sur un autre système ou sur un cluster.
Si vous choisissez REMOTE, le service JMS n'est pas démarré par GlassFish Server au prochain démarrage du serveur. A la place, il est démarré et géré par Message Queue. Vous devez donc démarrer le broker Message Queue séparément. Pour plus d'informations sur le démarrage du broker, reportez-vous à Starting Brokers dans le manuel Oracle GlassFish Server Message Queue Administration Guide. Si vous choisissez cette valeur et que vous utilisez un hôte distant, suivez les instructions indiquées dans Modification d'un hôte JMS pour spécifier le nom de l'hôte distant.
Dans le champ Délai de démarrage, indiquez le délai d'attente, en secondes, du démarrage du service JMS au-delà duquel GlassFish Server abandonne l'opération.
Sur un système lent ou surchargé, augmentez la valeur par défaut. La valeur par défaut est 60.
Dans le champ Arguments de démarrage, indiquez des arguments permettant de personnaliser le démarrage du service JMS.
Utilisez les arguments disponibles à l'aide de la commande as-install-parent/mq/bin/imqbrokerd.
Sélectionnez la case Activé du champ Reconnecter pour que le service JMS tente de se reconnecter à un serveur de messagerie (ou à la liste d'adresses indiquée dans AddressList) en cas de perte de connexion.
Cette option est activée par défaut.
Dans le champ Intervalle de reconnexion, définissez le délai, en secondes, entre les tentatives de reconnexion.
Cet intervalle s'applique aux tentatives sur chaque adresse indiquée dans AddressList, ainsi qu'aux adresses successives dans la liste. Si l'intervalle est trop court, le broker n'a pas le temps de récupérer. S'il est trop long, le délai de reconnexion peut être inacceptable. La valeur par défaut est de 5 secondes.
Dans le champ Tentatives de reconnexion, indiquez le nombre de tentatives de connexion (ou de reconnexion) pour chaque adresse indiquée dans AddressList avant que le programme client ne passe à l'adresse suivante dans la liste.
La valeur -1 indique que le nombre de tentatives de reconnexion est illimité (le programme client tentera de se connecter à la première adresse jusqu'à ce qu'il y parvienne). La valeur par défaut est 3.
Dans la liste déroulante Hôte JMS par défaut, sélectionnez le nom de l'hôte JMS par défaut.
La valeur par défaut est default_JMS_host.
Dans la liste déroulante Comportement de la liste d'adresses, sélectionnez l'ordre des tentatives de connexion.
random signifie qu'une adresse est sélectionnée au hasard dans AddressList.
Si un grand nombre de clients tentent de se connecter en utilisant la même fabrique de connexions, choisissez random pour éviter qu'ils ne soient tous connectés à la même adresse. Il s'agit de l'option par défaut.
priority signifie que le processus de reconnexion tentera toujours de se connecter à la première adresse de serveur dans AddressList et n'utilisera une autre adresse que si le premier broker n'est pas disponible.
Dans le champ Itérations de la liste d'adresses, indiquez le nombre d'itérations du service JMS dans AddressList en vue d'établir (ou de rétablir) une connexion.
La valeur -1 indique que le nombre de tentatives est illimité. La valeur par défaut est 3.
Dans les champs Schéma MQ et Service MQ, saisissez le nom du schéma d'adresses et du service de connexion Message Queue si un schéma ou un service non défini par défaut doit être utilisé.
Pour plus d'informations sur la syntaxe, reportez-vous à Syntaxe d'adresse du schéma MQ et du service MQ.
Dans la zone Autres propriétés, spécifiez les propriétés supplémentaires du service JMS.
Pour plus d'informations sur les propriétés disponibles, reportez-vous à Propriétés propres au service JMS.
Pour ajouter une propriété, cliquez sur le bouton Ajouter une propriété. Sur la ligne vide qui apparaît, saisissez le nom de la propriété dans le champ Nom et la valeur de la propriété dans le champ Valeur.
Pour modifier une propriété, modifiez le champ Valeur de cette propriété.
Pour supprimer une propriété, sélectionnez la case située à gauche du champ Nom de la propriété à supprimer, puis cliquez sur le bouton Supprimer des propriétés.
Cliquez sur Ping pour vérifier que le service JMS est en cours d'exécution sur l'hôte JMS par défaut.
Si le service JMS est en fonctionnement, un message signale que la commande ping a abouti.
Cliquez sur Enregistrer.
Conseil:
Pour revenir aux paramètres par défaut, cliquez sur le bouton Charger les valeurs par défaut, puis sur Enregistrer.Si vous remplacez le fournisseur et l'hôte par un système distant, toutes les applications JMS utiliseront le serveur distant. Pour utiliser à la fois le serveur local et des serveurs distants, créez une ressource de fabrique de connexions avec la propriété AddressList , afin de créer des connexions ayant accès aux serveurs distants. Reportez-vous à Création d'une ressource de fabrique de connexions JMS.
jms-ping