Configuration JMX

Lorsque vous définissez une source de données JDBC dans l'agent, des propriétés de configuration sont créées automatiquement.

La configuration d'exécution JMX est unique car elle permet de contrôler la quantité de configuration affichée. Le client JMX de l'agent peut se connecter à plusieurs types de serveurs d'applications différents. Toutefois, il n'est pas nécessaire de prendre en charge tous ces types de serveurs d'applications dans un agent. Vous pouvez déterminer les types de serveurs d'applications à prendre en charge, de sorte que les sections de configuration inutiles ne sont pas incluses dans l'agent.

Dans la plupart des cas, un agent est conçu pour surveiller un seul type de serveur d'applications JMX. Lorsque vous créez la source de données JMX, vous pouvez utiliser le navigateur JMX. Lors de l'utilisation du navigateur JMX, les options de configuration de serveur JMX permettant de parcourir le serveur de MBean sont sélectionnées et ajoutées automatiquement dans l'agent. Pour modifier les types de serveur d'applications auxquels vous connecter une fois l'agent créé, cliquez sur Options JMX globales dans la zone Informations JMX. Sur la page Options d'agent JMX, modifiez toutes les sélections désirées.

Vous pouvez concevoir un agent générique qui surveille plusieurs types de serveurs d'applications JMX. Dans ce cas, plusieurs options de configuration de serveur JMX peuvent être sélectionnées sur la page Options d'agent JMX. Lorsque plusieurs types de connexions JMX sont pris en charge, la configuration d'exécution demande de préciser le type de connexion à utiliser pour l'instance d'agent.

Remarque : Une instance d'un agent ne peut se connecter qu'à un seul type de serveur d'applications JMX. Les sous-noeuds permettent d'établir une connexion à des serveurs d'applications JMX différents du même type dans une instance d'agent. Pour vous connecter à plusieurs types de serveur d'applications JMX, vous devez configurer au moins une instance d'agent pour chaque type de serveur d'applications JMX.

Vous pouvez visualiser, ajouter et modifier les propriétés de configuration à l'aide de l'éditeur d'agent. Pour obtenir des instructions, voir Modification des propriétés de configuration à l'aide de l'éditeur d'agent. Si une source de données JMX est définie dans un sous-noeud, vous pouvez également définir des substitutions de configuration. Pour obtenir des instructions, voir Configuration de sous-noeud.

Si vous définissez une source de données JMX dans votre agent, celui-ci doit utiliser Java™ pour se connecter au serveur d'applications JMX. Les propriétés de configuration Java s'ajoutent automatiquement à l'agent.

Les propriétés de configuration Java suivantes sont propres à la configuration d'exécution de l'agent :

Répertoire de base Java: Chemin qualifié complet pointant vers le répertoire d'installation Java
Configurez l'agent de sorte qu'il utilise la même JVM que l'application surveillée, notamment pour le serveur WebLogic et pour WebSphere Application Server.
Arguments JVM: Indique une liste facultative d'arguments pour la machine virtuelle Java.
Niveau de trace: Définit la quantité d'informations à écrire dans le fichier de trace Java. Par défaut, les données d'erreur sont écrites dans le fichier journal.

Remarque : Agent Builder n'a pas besoin de ces propriétés, dans la mesure où il utilise sa propre JVM et sa propre consignation qui sont configurées via le plug-in JLog.

Si vous définissez une source de données SNMP dans votre agent, les zones de configuration courantes obligatoires suivantes s'ajoutent automatiquement à l'agent :

Connexion: Type de la connexion au serveur MBean
ID utilisateur: Nom d'utilisateur servant à l'authentification auprès du serveur MBean.
Mot de passe: Mot de passe de l'ID utilisateur.
Chemins de base: Liste des répertoires dans lesquels les fichiers JAR nommés dans la zone Chemin d'accès aux classes sont recherchés ou répertoires nommés dans Répertoires JAR qui ne sont pas complètement qualifiés. Les noms de répertoire sont séparés par un point-virgule (;) sur Windows, et par un point virgule ((;) ou deux points (:) sur les systèmes UNIX.
Chemin d'accès aux classes: Fichiers JAR explicitement nommés dans lesquels l'agent doit faire ses recherches. Les répertoires qui ne sont pas complètement qualifiés s'ajoutent à chacun des chemins de base tant que le répertoire n'est pas trouvé.
Répertoires JAR: Liste des répertoires dans lesquels les fichiers JAR sont recherchés. Les noms de répertoire sont séparés par un point-virgule (;) sur Windows, et par un point virgule ((;) ou deux points (:) sur les systèmes UNIX. Les fichiers JAR de ces répertoires n'ont pas besoin d'être identifiés explicitement ; ils seront détectés, car ils se trouvent dans l'un de ces répertoires. La recherche ne s'applique pas aux sous-répertoires de ces répertoires. Les répertoires qui ne sont pas complètement qualifiés s'ajoutent à chacun des chemins de base tant que le répertoire n'est pas trouvé.

Remarque : Lors de la surveillance à distance, les fichiers JAR et tous leurs fichiers JAR dépendants doivent être installés en local sur l'ordinateur sur lequel l'agent est en cours d'exécution. Ces fichiers JAR sont les fichiers qui sont requis pour la connexion à l'application qui est surveillé. Ces fichiers JAR doivent être configurés dans Répertoires JAR et dans Chemins de base et Chemin d'accès aux classes. En outre, vous devez installer en local une JVM prise en charge pour l'application que vous surveillez et spécifier le chemin dans la zone de configuration Répertoire de base Java.

Exemples :

Pour WebLogic 10, le chemin d'accès aux classes est server/lib/wlclient.jar;server/lib/wljmxclient.jar. Le chemin de base pointe vers le répertoire de serveur d'applications WebLogic qui contient le répertoire server/lib.
Pour WebSphere, le chemin de base pointe vers l'emplacement où le serveur d'applications WebSphere est installé. Plusieurs chemins de base sont répertoriés dans cet exemple, afin de fournir une valeur par défaut pour Windows et UNIX. Le chemin d'accès aux classes répertorie les fichiers JAR relatifs au chemin de base. La valeur relative lib de la zone Répertoires JAR charge tous les fichiers JAR de ce répertoire dans le chemin de base.
- Chemins de base : C:\Program Files\IBM\WebSphere\AppServer;/opt/IBM/WebSphere/AppServer
- Chemin d'accès aux classes : runtimes/com.ibm.ws.admin.client_6.1.0.jar;plugins/com.ibm.ws.security.crypto_6.1.0.jar
- Répertoires JAR : lib

En fonction des types de serveur JMX sélectionnés sur la page Options d'agent JMX, quelques-unes ou l'ensemble des propriétés de configuration ci-dessous sont ajoutées. Les valeurs par défaut sont fournies par Agent Builder et peuvent être modifiées :

Propriétés de configuration spécifiques à la connexion au serveur compatible JSR-160 :

Adresse URL du service JMX: Adresse URL de services JMX à laquelle se connecter pour la surveillance.

Propriétés de configuration spécifiques à la connexion WebSphere Application Server version 6.0 et ultérieure :

Nom d'hôte: Nom d'hôte du système où réside le serveur d'applications que vous surveillez. Si la surveillance est effectuée en local, il s'agit du nom du système local. Si la surveillance est effectuée à distance, il s'agit du nom d'hôte du système où réside le serveur d'applications.
Port: Numéro de port à utiliser sur l'hôte à surveiller.
Protocole de connecteur: Protocole de connecteur à utiliser par la connexion de surveillance. RMI et SOAP sont pris en charge.
Nom de profil: Nom du profil à utiliser pour la configuration de la connexion.

Propriétés de configuration spécifiques à la connexion à JBoss Application Server (non JSR-160) :

Nom JNDI: Nom JNDI utilisé pour rechercher le serveur de MBean.
Adresse URL de fournisseur: Adresse URL de services JMX à laquelle vous vous connectez pour la surveillance.

Propriétés de configuration spécifiques à la connexion à WebLogic Server :

Adresse URL de service: Adresse URL du fournisseur de services JMX à laquelle vous vous connectez pour la surveillance, qui inclut également le nom JNDI.

Remarque : Si la sécurité administrative WebSphere est activée, vous devez vous assurer que les invites de connexion du client sont désactivées dans les fichiers de propriétés appropriés de la connexion du client. Pour les connexions RMI, vous devez modifier la propriété com.ibm.CORBA.loginSource dans le fichier sas.client.props dans le répertoire des propriétés de profil de WebSphere Application Server pour empêcher les clients d'envoyer des invites aux utilisateurs. Pour une connexion SOAP, vous devez modifier la propriété com.ibm.SOAP.loginSource dans le fichier soap.client.props dans le même répertoire. Dans les deux cas, la propriété loginSource doit être définie de manière à ne pas contenir de valeur.

Vous pouvez visualiser, ajouter et modifier les propriétés de configuration à l'aide de l'éditeur d'agent. Voir (Modification des propriétés de configuration à l'aide de l'éditeur d'agent). Si une source de données Windows est définie dans un sous-noeud, vous pouvez également indiquer des substitutions de configuration de sous-noeud. Voir Configuration de sous-noeud.