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

Remarque : Pour plus d'informations sur la fonction IBM WebSphere SNMP (également appelée Agent SNMP IBM WebSphere), consultez la rubrique "SNMP based performance monitoring for WebSphere Application Server".

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

  1. Démarrez le serveur de gestionnaire de déploiement.
  2. Démarrez wsadmin avec -lang jacl pour vous connecter au serveur du gestionnaire de déploiement.
  3. Créez la variable WebSphere WAS_NODE_NAME sur la portée du noeud avec le nom de noeud comme valeur :
    $AdminTask setVariable {-scope Cell=<cell name>,Node=<node name> -variableName WAS_NODE_NAME -variableValue <node name> }
    <nom_noeud> correspond au nom du noeud sur lequel le serveur générique de l'agent SNMP IBM WebSphere doit être créé.
  4. Créez l'agent SNMP IBM WebSphere en tant que serveur générique à l'aide de l'archive de configuration du modèle fournie :
    $AdminTask importServer {-archive <washome>/optionalLibraries/IBM/SNMPAgent/config/templates
    /templateSnmpAgentServer.car -nodeName <node name> -serverName SnmpAgent }
    <répertoire de base_WAS> correspond au chemin d'installation de WebSphere Application Server et <nom_noeud> au nom du noeud sur lequel l'agent SNMP IBM WebSphere doit être créé.
  5. Enregistrez la configuration.
    $AdminConfig save

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.

Remarque : Dans l'environnement de déploiement réseau, les fonctions IBM WebSphere SNMP doivent être configurées dans le référentiel de configuration du gestionnaire de déploiement.
Pour configurer les trois fichiers xml pour l'agent SNMP IBM WebSphere, procédez comme suit :
  1. 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.
  2. 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
    Indiquez l'attribut SOAPmbeanServer si vous utilisez le type de connecteur SOAP et l'attribut RMIm-beanServer si vous utilisez le type de connecteur 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.
  3. 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 :
    <?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>
    où :
    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
Remarque : Vous devez activer la sécurité pour l'agent SNMP IBM WebSphere pour vous connecter à un environnement WebSphere Application Server avec la sécurité activée. Pour plus d'informations, consultez la rubrique "Enabling security for the IBM WebSphere SNMP Capability".

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tprf_snmp_install
Nom du fichier : tprf_snmp_install.html