Instalación y configuración de IBM WebSphere SNMP Capability

Primero debe instalar y configurar IBM® WebSphere Simple Network Management Protocol (SNMP) Capability en IBM WebSphere Application Server para permitir la recopilación de métricas de rendimiento.

Antes de empezar

Nota: Para obtener más información sobre IBM WebSphere SNMP Capability (que también se conoce como IBM WebSphere SNMP Agent), lea el tema "Supervisión del rendimiento basada en SNMP para WebSphere Application Server".

Antes de instalar IBM WebSphere SNMP Capability, confirme que se haya instalado WebSphere Application Server versión 8.5 o posterior con un cliente ligero autónomo.

Acerca de esta tarea

Los archivos IBM WebSphere SNMP Agent se encuentran en el directorio <WAS_HOME>/optionalLibraries/IBM/SNMPAgent:

IBM WebSphere SNMP Agent debe crearse como un servidor genérico utilizando el archivo de archivado de configuración de plantilla proporcionado, que es <WAS_HOME>/optionalLibraries/IBM/SNMPAgent/templateSnmpAgentServer.car.

Para instalar IBM WebSphere SNMP Agent, efectúe los pasos siguientes:

Procedimiento

  1. Inicie el servidor del gestor de despliegue.
  2. Inicie wsadmin con -lang jacl para conectarse al servidor del gestor de despliegue.
  3. Cree la variable WAS_NODE_NAME de WebSphere en el ámbito del nodo, con el nombre de nodo como valor:
    $AdminTask setVariable {-scope Cell=<nombre_célula>,Node=<nombre_nodo> -variableName WAS_NODE_NAME -variableValue <nombre_nodo> }
    donde <nombre_nodo> es el nombre del nodo en el que se va a crear el servidor genérico de IBM WebSphere SNMP Agent.
  4. Cree IBM WebSphere SNMP Agent como un servidor genérico utilizando el archivo de configuración de plantilla proporcionado:
    $AdminTask importServer {-archive <inicio_was>/optionalLibraries/IBM/SNMPAgent/config/templates
    /templateSnmpAgentServer.car -nodeName <nombre_nodo> -serverName SnmpAgent }
    donde <inicio_was> es la vía de acceso de instalación completa de WebSphere Application Server y <nombre_nodo> es el nombre del nodo en el que se va a crear IBM WebSphere SNMP Agent.
  5. Guarde la configuración.
    $AdminConfig save

Qué hacer a continuación

Se puede crear uno o más IBM WebSphere SNMP Agent como servidores genéricos que se conectan a distintos servidores de aplicaciones y servidores de administración, como por ejemplo el gestor de despliegue, NodeAgent y AdminAgent.

Configure IBM WebSphere SNMP Agent modificando tres archivos xml: agentConfig.xml, jmxConfig.xml y trapConfig.xml. Estos archivos xml se encuentran en el repositorio de configuración de WebSphere bajo el directorio cells/<nombre_tcélula>;/nodes/<nombre_tnodo>/servers/<nombre_servidor>.

Antes de configurar los tres archivos xml, primero debe habilitar la supervisión de PMI (Performance Monitoring Infrastructure) desde la consola administrativa en el servidor necesario.

Nota: En el entorno de Network Deployment, IBM WebSphere SNMP Capability debe configurarse en el repositorio de configuración del gestor de despliegue.
Para configurar los tres archivos xml para IBM WebSphere SNMP Agent, efectúe los siguientes pasos:
  1. Abra el archivo agentConfig.xml. Este archivo configura el nombre de host, el puerto y la comunidad en la que se ejecuta IBM WebSphere SNMP Agent. Realice una copia de seguridad del archivo antes de editarlo para conservar la copia original.
    <!--ejemplo de 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>
    Nota: Sólo debe editar los atributos registryPort, ipAddress y authMode. La modificación de cualquier otro atributo podría resultar en un comportamiento sin definir.
    .
    Tabla 1. Atributos en el archivo agentConfig.xml
    Nombre de atributo Descripción
    registryPort El número de puerto para registrar el agente del programa de arranque con el registro de servicio RMI de Java™. Este atributo está presente en el código <agentConfig>.
    Nota: Especifique un número de puerto superior a 1024 para evitar utilizar los puertos reservados.
    ipAddress La dirección del host en el que se ejecuta IBM WebSphere SNMP Agent. El mismo valor debe establecerse en el software de supervisión SNMP para comunicarse con IBM WebSphere SNMP Agent. Este atributo está presente en el código <agent> .
    Nota: Especifique el nombre de host completo o la dirección IP en lugar del valor predeterminado: localhost.
    snmpPort El número de puerto en el que WebSphere SNMP Agent está a la escucha de los paquetes de SNMP. El mismo valor debe establecerse en el software de supervisión SNMP para comunicarse con IBM WebSphere SNMP Agent. Este atributo está presente en el código <agentConfig>.
    user El nombre del usuario autorizado para conectarse a IBM WebSphere SNMP Agent. El mismo valor debe establecerse en el software de supervisión SNMP para comunicarse con IBM WebSphere SNMP Agent. Este atributo está presente en el código <agent>.
    Nota: "user" y "password" son las credenciales de usuario/contraseña utilizadas para el supervisor de SNMP que se va a conectar con el Agente SNMP. Estas credenciales no son las credenciales de WebSphere Application Server utilizadas para iniciar la sesión en la consola administrativa.
    authMode La modalidad de autenticación que se utiliza para comunicarse con IBM WebSphere Snmp Agent. El mismo valor debe establecerse en el software de supervisión SNMP para comunicarse con IBM WebSphere SNMP Agent. Este atributo está presente en el código <agent>.
    password La contraseña del usuario autorizado definido en el atributo ‘user’. El mismo valor debe establecerse en el software de supervisión SNMP para comunicarse con IBM WebSphere SNMP Agent. Este atributo está presente en el código <agent>.
    Nota: La modalidad de privacidad de SNMP Versión 3 no está soportada en el release actual de IBM WebSphere SNMP Agent.
  2. Abra el archivo jmxConfig.xml. Realice una copia de seguridad del archivo antes de editarlo para conservar la copia original.

    Este archivo de configuración contiene información sobre el servidor Mbean desde el que se deben recopilar los datos PMI. Debe establecer todos los atributos que se han especificado en este archivo.

    Todos los nodos y atributos, excepto los que están bajo <Mbean>, son estáticos (es decir, pueden configurarse sólo antes de iniciar IBM WebSphere SNMP Agent). Sin embargo, los nodos y atributos bajo <Mbean> se pueden modificar incluso cuando IBM WebSphere SNMP Agent se está ejecutando.

    En la siguiente tabla, los únicos atributos que pueden configurarse cuando la seguridad está habilitada son: Security, User, Password, connectorSOAPconfig/connectorRMIconfig, sslRMIConfig, trustStore, tsPassword, keyStore y ksPassword.

    Tabla 2. Atributos en el archivo jmxConfig.xml
    Nombre de atributo Descripción
    connectorType Sólo puede especificar los valores siguientes como tipo de conector:
    • SOAP
    • RMI
    Especifique el atributo SOAPmbeanServer si está utilizando el tipo de conector SOAP y el atributo RMIm-beanServer si está utilizando el tipo de conector RMI.
    Nota: Si especifica cualquier otro valor, IBM WebSphere SNMP Agent utiliza SOAP de forma predeterminada.
    Security Especifica si la seguridad de WebSphere Application Server está habilitada. Sólo puede especificar los siguientes valores:
    • Para habilitar la seguridad, establezca el valor en yes o y.
    • Para inhabilitar la seguridad, establezca el valor en no o n.
    Nota: Si especifica cualquier otro valor, IBM WebSphere SNMP Agent utiliza no de forma predeterminada.
    Address Especifica el nombre de host o la dirección IP de WebSphere Application Server.
    Port Especifica el puerto SOAP_CONNECTOR para la conexión SOAP y BOOTSTRAP para la conexión RMI.
    sampleInterval Especifica el intervalo (número de segundos) en el que WebSphere SNMP Agent debe recuperar datos PMI. Este valor debe ser como mínimo 60.
    Usuario Si ha habilitado el atributo de seguridad, establezca el nombre de usuario necesario para iniciar la sesión en la consola de administración.
    Password Si ha habilitado el atributo de seguridad, establezca la contraseña necesaria para iniciar la sesión en la consola de administración.
    connectorSOAPconfig/connectorRMIconfig Si la seguridad está habilitada y no se ha especificado el nombre de usuario o la contraseña (o ambos), WebSphere SNMP Agent busca el nombre de usuario y la contraseña en el archivo al que este archivo apunta.
    Nota: Los archivos, soap.client.props y sas.client.props respectivamente, están presentes en la instalación de WebSphere Application Server y se encuentran en el directorio </was_profile>/properties. Modifique el valor de modo que apunte a la ubicación del sistema.
    sslRMIConfig Si elige la conexión RMI, el reconocimiento SSL se lleva a cabo cuando este atributo de seguridad está habilitado. Puede utilizar el archivo ssl.client.props predeterminado que se encuentra en el directorio </was_profile>/properties, o puede modificarlo de acuerdo con las instrucciones contenidas en el archivo.
    Nota: Para connectorRMIConfig y sslRMIConfig, el nombre de vía de acceso debe ir precedida por file. Por ejemplo: sslRMIConfig="file:/opt/IBM/Websphere/AppServer/profiles/Dmgr01/properties/ssl.client.props".
    trustStore Especifica la ubicación del archivo de almacén de confianza en el host en el que se está ejecutando WebSphere SNMP Agent. Puede utilizar el almacén de confianza predeterminado o crear uno propio. Si utiliza el almacén de confianza predeterminad, asegúrese de que este valor refleje la vía de acceso correspondiente en la máquina.
    tsPassword Especifica la contraseña necesaria para acceder al almacén de confianza.
    keyStore Especifica la ubicación del archivo de almacén de claves en el host en el que se está ejecutando WebSphere SNMP Agent. Puede utilizar el almacén de confianza predeterminado o crear uno propio. Si utiliza el almacén de confianza predeterminad, asegúrese de que este valor refleje la vía de acceso correspondiente en la máquina.

    Los archivos de almacén de confianza y de almacén de claves realizan el reconocimiento SSL para SOAP cuando la seguridad está habilitada.

    ksPassword Especifica la contraseña necesaria para acceder al almacén de claves.
    Mbean Especifica el Mbeans que debe supervisarse. Este nodo puede tener cualquier número de nodos hijos de colección. Cada nodo de colección tiene tres atributos:
    expression
    Cualquier expresión regular soportada por Java, y que se utiliza para especificar el patrón de Mbeans que debe supervisarse.
    counterMode
    Puede ser automática o manual
    counter
    Si counterMode es automática, se supervisan todos los contadores de los Mbeans coincidentes. Si counterMode es manual, el atributo de contadores debe tener una lista separada por comas para que los contadores se supervisen para ver si hay Mbeans coincidentes.
    Nota: La dirección del programa de arranque o el conector SOAP pueden identificarse pulsando Servidor > Tipos de servidor > WebSphere Application Servers en la consola administrativa. Seleccione el nombre del servidor de aplicaciones (por ejemplo, dmgr). Una vez que se visualiza la página del servidor de aplicaciones, seleccione el separador de configuración (si todavía no está seleccionado). Desplácese hacia abajo hasta Comunicación y expanda Puertos.
  3. Abra el archivo trapconfig.xml. Realice una copia de seguridad del archivo antes de editarlo para conservar la copia original.
    Este archivo contiene la lista de escuchas de condiciones de excepción. Varios escuchas pueden escuchar si hay mensajes de condiciones de excepción SNMP. Un administrador puede añadir varios destinos de condiciones de excepción en el archivo trapConfig.xml en el siguiente formato:
    <?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>
    donde:
    Community
    El nombre de la comunidad a la que pertenece esta entrada
    Protocol
    El protocolo que se va a utilizar:
    • 1 – para ip (predeterminado)
    • 2 – para ipx
    Version
    Versión de SNMP que se debe utilizar al generar la condición de excepción
    Index
    El ID de índice de enteros exclusivo. Se ignora si varios destinos de condiciones de excepción tienen el mismo valor de índice.
    Status
    Estado de la entrada de tabla. Contiene uno de los valores siguientes:
    • 1 - active
    • 2 - notInService
    • 3 - notReady
    • 4 - createAndGo
    • 5 – createAndWait
    • 6 – destroy
    <TrapDestinations>
    Elemento raíz principal de trapConfig.xml
    <TrapDestination>
    Define un escucha de destino de condición de excepción
    <tHostName>
    El nombre de host o la dirección IP del escucha
    <tPort>
    El número de puerto donde se está ejecutando el escucha
    <Status>
    Se utiliza para habilitar o inhabilitar notificaciones específicas
Nota: Debe habilitar la seguridad para IBM WebSphere SNMP Agent para conectarse a un entorno de WebSphere con la seguridad habilitada. Lea el tema "Habilitación de la seguridad de IBM WebSphere SNMP Capability" para obtener más información.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tprf_snmp_install
File name: tprf_snmp_install.html