Installation et configuration de la fonction IBM WebSphere SNMP
Vous devez tout d'abord installer et configurer la fonction IBM® WebSphere Simple Network Management Protocol (SNMP) sur IBM WebSphere Application Server pour permettre la collecte de mesures de performance.
Avant de commencer
Avant d'installer la fonction IBM WebSphere SNMP, vérifiez que WebSphere Application Server version 8.5 ou une version supérieure est installé avec un client léger autonome.
Pourquoi et quand exécuter cette tâche
Les fichiers de l'agent SNMP IBM WebSphere se trouvent dans le répertoire <WAS_HOME/optionalLibraries/IBM/SNMPAgent :
L'agent SNMP IBM WebSphere doit être créé en tant que serveur générique à l'aide du fichier d'archive de configuration du modèle <WAS_HOME/optionalLibraries/IBM/SNMPAgent/templateSnmpAgentServer.car.
Pour installer l'agent SNMP IBM WebSphere, procédez comme suit :
Procédure
Que faire ensuite
Un ou plusieurs agents SNMP IBM WebSphere peuvent être créés en tant que serveurs génériques se connectant à différents serveurs d'applications et serveurs d'administration, par exemple Deployment Manager, NodeAgent et AdminAgent.
Configurez l'agent SNMP IBM WebSphere en modifiant trois fichiers xml : agentConfig.xml, jmxConfig.xml et trapConfig.xml. Ces fichiers xml se trouvent dans le référentiel de configuration WebSphere du répertoire cells/<nom_celluleT>>;/nodes/<nom_noeudT/servers/<nom_serveur.
Avant de configurer les trois fichiers xml, vous devez tout d'abord activer la surveillance PMI (Performance Monitoring Infrastructure) à partir de la console d'administration sur le serveur requis.
- Ouvrez le fichier agentConfig.xml. Ce fichier
configure le nom d'hôte, le port et la communauté avec lesquels s'exécute l'agent SNMP IBM WebSphere. Faites une copie de sauvegarde du fichier avant de le modifier afin de préserver l'original.
<!--sample agentConfig.xml --> <agentConfig name="WsSNMPAgent" logFile="log/WsSNMP.log" registryPort = "1107" agents = "WsSNMP"> <metadata mibsFolder = "mibs" mibs="nh-smi.smi,rfc1213-mib.mib,rmon-mib.mib,snmpv2-tc.mib,websphere-mib.mib” />ok <WsSNMP ipAddress = "localhost" snmpPort = "161" views="V1" Behaviors="getScalars,getCollection" jmxConfigFile="jmxConfig.xml" user="nick2" authMode="MD5" password="password"> <V1 jmacfgFiles = "oid.out" trapConfig = "config/trapConfig.xml"/> <getScalars oid = "1.3.6.1.4.1.1977.22.10.1.0" class = "com.ibm. ws.pmi.snmp.behaviors.GetScalarsBehavior"/> <getCollection oid = "1.3.6.1.4.1.1977.22.10.10.1.2" class = "com.ibm. ws.pmi.snmp.behaviors.GetCollectionBehavior"/> <…..> </WsTSNMP> </agentConfig>
Remarque : Vous ne devez modifier que les attributs registryPort, ipAddress et authMode. La modification d'autres attributs pourrait provoquer un comportement indéfini..Tableau 1. Attributs du fichier agentConfig.xml Nom de l'attribut Description registryPort Numéro de port sur lequel enregistrer l'agent d'amorçage dans le registre de services de l'interface du gestionnaire de ressources Java™. Cet attribut se trouve dans la balise <agentConfig>. Remarque : Indiquez un numéro de port supérieur à 1024 pour éviter l'emploi des ports réservés.ipAddress Adresse de l'hôte sur lequel s'exécute l'agent SNMP IBM WebSphere. La même valeur doit être définie dans le logiciel de surveillance SNMP pour communiquer avec l'agent SNMP IBM WebSphere. Cet attribut se trouve dans la balise <agent>. Remarque : Indiquez le nom d'hôte qualifié complet ou l'adresse IP à la place de la valeur par défaut : localhost.snmpPort Numéro de port sur lequel l'agent SNMP WebSphere écoute les paquets SNMP. La même valeur doit être définie dans le logiciel de surveillance SNMP pour communiquer avec l'agent SNMP IBM WebSphere. Cet attribut se trouve dans la balise <agentConfig>. user Nom de l'utilisateur autorisé à se connecter à l'agent SNMP IBM WebSphere. La même valeur doit être définie dans le logiciel de surveillance SNMP pour communiquer avec l'agent SNMP IBM WebSphere. Cet attribut se trouve dans la balise <agent>. Remarque : "user" et "password" correspondent au nom d'utilisateur et au mot de passe des données d'identification utilisées pour le moniteur SNMP qui doit se connecter à l'agent SNMP. Ces données d'identification sont différentes des données d'identification de WebSphere Application Server qui sont utilisées pour se connecter à la console d'administration.authMode Mode d'authentification utilisé pour la communication avec l'agent SNMP IBM WebSphere. La même valeur doit être définie dans le logiciel de surveillance SNMP pour communiquer avec l'agent SNMP IBM WebSphere. Cet attribut se trouve dans la balise <agent>. password Mot de passe de l'utilisateur autorisé défini dans l'attribut ‘user’. La même valeur doit être définie dans le logiciel de surveillance SNMP pour communiquer avec l'agent SNMP IBM WebSphere. Cet attribut se trouve dans la balise <agent>. Remarque : Le mode de confidentialité de SNMP Version 3 n'est pas pris en charge dans l'édition en cours de l'agent SNMP IBM WebSphere. - Ouvrez le fichier jmxConfig.xml. Faites une copie de sauvegarde du fichier avant de le modifier afin de préserver l'original.
Ce fichier de configuration contient des informations sur le serveur Mbean à partir duquel les données PMI doivent être collectées. Vous devez définir tous les attributs spécifiés dans ce fichier.
Tous les noeuds et attributs, à l'exception de ceux se trouvant sous <Mbean>, sont statiques (ils ne peuvent être configurés qu'avant le démarrage de l'agent SNMP d'IBM WebSphere). Cependant, les noeuds et attributs se trouvant sous <Mbean> peuvent être modifiés, y compris lors de l'exécution de l'agent SNMP d'IBM WebSphere.
Dans le tableau suivant, les seuls attributs pouvant être configurés lorsque la sécurité est activée sont les suivants , User, Password, connectorSOAPconfig/connectorRMIconfig, sslRMIConfig, trustStore, tsPassword, keyStore et ksPassword.
Tableau 2. Attributs du fichier jmxConfig.xml Nom de l'attribut Description connectorType Vous ne pouvez spécifier que les valeurs suivantes comme type de connecteur : - SOAP
- RMI
Remarque : Si vous indiquez une autre valeur, l'agent SNMP IBM WebSphere utilise SOAP par défaut.Sécurité Indique si la sécurité de WebSphere Application Server est activée. Vous ne pouvez spécifier que les valeurs suivantes : - Pour activer la sécurité, définissez la valeur sur yes ou y.
- Pour désactiver la sécurité, définissez la valeur sur no ou n.
Remarque : Si vous indiquez une autre valeur, l'agent SNMP IBM WebSphere utilise no par défaut.Adresse Indique le nom d'hôte ou l'adresse IP de WebSphere Application Server. port Indique le port SOAP_CONNECTOR pour la connexion SOAP et BOOTSTRAP pour la connexion RMI. sampleInterval Indique l'intervalle (nombre de secondes) pendant lequel l'agent SNMP WebSphere doit extraire des données PMI. Cette valeur doit être supérieure ou égale à 60. Utilisateur Si vous avez activé l'attribut de sécurité, définissez le nom d'utilisateur requis pour vous connecter à la console d'administration. Mot de passe Si vous avez activé l'attribut de sécurité, définissez le mot de passe requis pour vous connecter à la console d'administration. connectorSOAPconfig/connectorRMIconfig Si la sécurité est activée, et que le nom d'utilisateur et/ou le mot de passe ne sont pas spécifiés, l'agent SNMP WebSphere recherche le nom d'utilisateur et le mot de passe dans le fichier pointé par cet attribut. Remarque : Les fichiers, soap.client.props et sas.client.props sont fournis avec l'installation WebSphere Application Server et se trouvent dans le répertoire </was_profile>/properties. Modifiez la valeur pour pointer vers l'emplacement de votre système.sslRMIConfig Si vous choisissez la connexion RMI, l'établissement de liaison SSL a lieu lorsque cet attribut de sécurité est activé. Vous pouvez utiliser le fichier ssl.client.props par défaut se trouvant dans le répertoire </was_profile>/properties ou le modifier selon les instructions contenues dans le fichier. Remarque : Pour connectorRMIConfig et sslRMIConfig, le nom de chemin d'accès doit être précédé de file. Par exemple : sslRMIConfig="file:/opt/IBM/Websphere/AppServer/profiles/Dmgr01/properties/ssl.client.props".trustStore Indique l'emplacement du fichier de clés certifiées sur l'hôte sur lequel s'exécute l'agent SNMP WebSphere. Vous pouvez utiliser le fichier de clés certifiées par défaut ou en créer un. Si vous utilisez le fichier de clés certifiées par défaut, vérifiez que cette valeur reflète le chemin correspondant sur votre machine. tsPassword Indique le mot de passe requis pour accéder au fichier de clés certifiées. keyStore Indique l'emplacement du fichier de clés sur l'hôte sur lequel s'exécute l'agent SNMP WebSphere. Vous pouvez utiliser le fichier de clés certifiées par défaut ou en créer un. Si vous utilisez le fichier de clés certifiées par défaut, vérifiez que cette valeur reflète le chemin correspondant sur votre machine. Le fichier de clés certifiées et les fichiers de clés effectuent l'établissement de liaison SSL pour SOAP lorsque la sécurité est activée.
ksPassword Indique le mot de passe requis pour accéder au fichier de clés. Mbean Indique les noeuds Mbeans à surveiller. Ce noeud peut avoir un certain nombre de noeuds de collection enfant. Chaque noeud de collection comporte trois attributs : - expression
- Toute expression régulière prise en charge par Java et utilisée pour indiquer le modèle de Mbeans à surveiller.
- counterMode
- Peut être automatique ou manuel.
- counter
- Si counterMode est automatique, tous les compteurs du noeud Mbeans correspondant sont surveillés. Si counterMode est manuel, l'attribut des compteurs doit contenir une liste séparée par des virgules des compteurs à surveiller pour le noeud Mbeans correspondant.
Remarque : L'adresse d'amorce ou le connecteur soap peut être identifié en cliquant sur Serveur > Types de serveurs > WebSphere Application Servers dans la console d'administration. Sélectionnez le nom de votre serveur d'applications (par exemple, dmgr). Une fois la page Application Server affichée, sélectionnez l'onglet de configuration (s'il n'est pas déjà sélectionné). Faites défiler jusqu'à Communication et développez Ports. - Ouvrez le fichier trapconfig.xml. Faites une copie de sauvegarde du fichier avant de le modifier afin de préserver l'original.Ce fichier contient la liste des programmes d'écoute d'interruption. Plusieurs programmes d'écoute peuvent écouter les messages d'alerte SNMP. Un administrateur peut ajouter plusieurs destinations d'interruption au fichier trapConfig.xml dans le format suivant :
où :<?xml version="1.0" encoding="UTF-8"?> <tns:TrapDestinations xmlns:tns="http://www.ibm.com/schema/WsT/SNMPSchema/TRAPConfig/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com/schema/WsT/SNMPSchema/TRAPConfig/TrapConfig.xsd "> <TrapDestination community="public" index="2" name="abcdom" protocol="2" status="3" version="1"> <HostName>127.0.0.1</HostName> <Port>161</Port> </TrapDestination> </tns:TrapDestinations>
- Communauté
- Nom de la communauté à laquelle appartient cette entrée.
- Protocole
- Protocole à utiliser :
- 1 – pour ip (par défaut)
- 2 – pour ipx
- Version
- Version SNMP à utiliser lors de la génération de l'interruption.
- Index
- ID d'index entier unique. Cet ID est ignoré si plusieurs destinations d'interruption ont la même valeur d'index.
- Statut
- Statut de l'entrée de table. Contient l'une des valeurs suivantes :
- 1 - active
- 2 - notInService
- 3 - notReady
- 4 - createAndGo
- 5 – createAndWait
- 6 – destroy
- <TrapDestinations>
- Elément racine principal du fichier trapConfig.xml
- <TrapDestination>
- Définit un programme d'écoute de destination d'interruption
- <tHostName>
- Nom d'hôte ou adresse IP du programme d'écoute
- <tPort>
- Numéro du port sur lequel s'exécute le programme d'écoute
- <Status>
- Utilisé pour activer ou désactiver des notifications spécifiques