Configuración del Agente de IBM Integration Bus

Debe asignar un nombre de instancia al Agente de IBM® Integration Bus y configurar el agente antes de poder empezar a supervisar el entorno de IBM Integration Bus.

Antes de empezar

  • Asegúrese de que el ID de usuario que se utiliza para iniciar y detener el agente pertenece a los grupos de usuarios mqm y mqbrkrs.
  • WindowsSi tiene instalado IBM MQ (WebSphere MQ) en el sistema Windows, añada la vía de acceso a la biblioteca de IBM MQ (WebSphere MQ) a la variable de entorno PATH. De ese modo, el Agente de IBM Integration Bus podrá cargar las bibliotecas de IBM MQ (WebSphere MQ) necesarias para el inicio.
    1. Añada la vía de acceso a biblioteca de IBM MQ (WebSphere MQ) al principio de la variable de entorno PATH.

      Por ejemplo, si la vía de acceso de instalación de IBM MQ (WebSphere MQ) es C:\IBM\WMQ75, añada C:\IBM\WMQ75\bin al principio de la variable de entorno PATH del sistema Windows.

    2. Reinicie el sistema Windows para que los cambios entren en vigor.
  • Puede que necesite proporcionar la información siguiente en función del entorno durante la configuración del agente. Si no conoce el valor de configuración adecuado que debe especificar, recopile la información del administrador de IBM MQ (WebSphere MQ) e IBM Integration Bus.
    • Si IBM MQ (WebSphere MQ) está instalado en el mismo sistema con el Agente de IBM Integration Bus, debe especificar la vía de acceso a biblioteca de 64 bits de IBM MQ (WebSphere MQ).
    • Si el Agente de IBM Integration Bus está configurado para supervisar los nodos de integración de IBM Integration Bus V10 o IBM App Connect Enterprise V11, debe proporcionar el directorio de instalación de IBM Integration Bus V10 o IBM App Connect Enterprise V11.
    • Si desea que el Agente de IBM Integration Bus supervise algunos nodos de integración (intermediarios) específicos en lugar de todos los del mismo sistema, debe especificar el nombre y la vía de instalación de cada nodo de integración (intermediario).

Acerca de esta tarea

El Agente de IBM Integration Bus es un agente de varias instancias; debe crear la primera instancia e iniciar el agente de forma manual.

Puede elegir configurar el agente con o sin interacciones en sistemas UNIX o Linux. En sistemas Windows, sólo puede configurar el agente sin interacciones.

  • Para configurar el agente con interacción, ejecute el script de configuración y responda a las solicitudes. Consulte Configuración interactiva.
  • Para configurar el agente sin interacción, edite el archivo de respuestas silencioso y, a continuación, ejecute el script de configuración. Consulte Configuración silenciosa.
Importante: si también ha instalado ITCAM Agent for WebSphere Message Broker, que se entrega como uno de los productos de ITCAM for Applications, en el mismo sistema que el Agente de IBM Integration Bus, que se entrega en Cloud APM, no los utilice para supervisar el mismo nodo de integración (intermediario) en el sistema.

Configuración interactiva

Procedimiento

Para configurar el agente mediante la ejecución del script y las respuestas a las solicitudes, siga estos pasos:

  1. Especifique el mandato siguiente:
    dir_instalación/bin/iib-agent.sh config nombre_instancia
    donde nombre_instancia es el nombre que desea proporcionar a la instancia de agente.
    Importante: La configuración interactiva no está soportada en sistemas Windows.
  2. Después de confirmar que desea configurar el Agente de IBM Integration Bus, especifique los valores de configuración para los valores generales del agente.
    1. Cuando se le solicite el parámetro ID de agente, especifique una serie alfanumérica exclusiva con una longitud máxima de 8 caracteres.
      Recuerde: la longitud máxima de ID de agente ha cambiado a 8 caracteres a partir de Agente de IBM Integration Bus versión 7.3.0.1. Para las versiones anteriores, la longitud máxima del ID de agente es de 4 caracteres. Para obtener instrucciones sobre cómo comprobar la versión del agente, consulte Versión del agente.

      El nombre del sistema gestionado incluye el ID del agente que especifique, por ejemplo, nombreintermediariosupervisado:idAgente:KQIB, donde nombreintermediariosupervisado es el nombre del nodo de integración (intermediario) supervisado.

    2. Cuando se le solicite el parámetro de directorio de instalación de IIB versión 10 o ACE versión 11, si desea supervisar nodos de integración de IBM Integration Bus V10 o IBM App Connect Enterprise V11, especifique el directorio de instalación de IBM Integration Bus V10 o IBM App Connect Enterprise V11. Por ejemplo, /opt/ibm/mqsi/ace-11.0.0.3. Si no desea supervisar IBM Integration Bus V10 e IBM App Connect Enterprise V11, pulse Intro para aceptar el valor predeterminado.
      Recuerde: Puede especificar sólo un directorio de instalación para el parámetro de directorio de instalación de IIB versión 10 o ACE versión 11. Si ha instalado IBM Integration Bus V10 o IBM App Connect Enterprise V11 en diferentes directorios y desea supervisarlos todos, cree varias instancias de agente y especifique un directorio de instalación de IBM Integration Bus V10 o IBM App Connect Enterprise V11 para cada instancia de agente.
  3. Opcional: Utilice la sección Valores del intermediario supervisado para especificar si desea utilizar este agente para supervisar solo algunos nodos de integración (intermediarios) específicos.

    De forma predeterminada, se supervisan todos los nodos de integración (intermediarios) que se ejecutan en el mismo sistema host que el Agente de IBM Integration Bus, tal como lo ha determinado el autodescubrimiento. Si desea que el agente supervise algunos nodos de integración (intermediarios) específicos, especifique el nombre del nodo de integración (intermediario) que desea supervisar y establezca el valor de Recopilar datos de nodo en No, que es el valor predeterminado, en la sección Valores del intermediario supervisado. Puede haber varias secciones Valores del intermediario supervisado. Cada sección controla los valores de supervisión para un nodo de integración (intermediario).

    Consejo: Puede especificar más de una sección Valores del intermediario supervisado. Al editar la sección Valores del intermediario supervisado, están disponibles las opciones siguientes:
    • Añadir: para crear una sección Valores del intermediario supervisado y configurarla para otro nodo de integración (intermediario).
    • Editar: para modificar los valores de la sección Valores del intermediario supervisado actual.
    • Suprimir: para suprimir la sección Valores del intermediario supervisado actual.
    • Siguiente: para trasladarse a la sección Valores del intermediario supervisado siguiente.
    • Salir: para salir de la configuración de Valores del intermediario supervisado.
  4. Si confirma que IBM MQ (WebSphere MQ) está instalado en el mismo sistema, se le solicitará el parámetro Vía de acceso a biblioteca de WebSphere MQ de 64 bits. Pulse Intro para aceptar el valor predeterminado, que es la vía de acceso a biblioteca de 64 bits de IBM MQ (WebSphere MQ) descubierta automáticamente por el agente. Si no se visualiza ningún valor predeterminado, debe proporcionar la vía de acceso a biblioteca de 64 bits de IBM MQ (WebSphere MQ) antes de continuar con el paso siguiente. Por ejemplo, /opt/mqm8/lib64.
    Recuerde: si los nodos de integración (intermediarios) utilizan distintas versiones de los gestores de colas, especifique la última versión de la vía de acceso de biblioteca de 64 bits de IBM MQ(WebSphere MQ) para este parámetro.
  5. Una vez finalizada la configuración, especifique el mandato siguiente para iniciar el agente:
    dir_instalación/bin/iib-agent.sh start nombre_instancia

Configuración silenciosa

Procedimiento

Para configurar el agente mediante la edición del archivo de respuestas silenciosas y la ejecución del script sin interacción, siga estos pasos:

  1. Abra el archivo de respuestas silencioso siguiente en un editor de texto.
    • Linux o AIXdir_instalación/samples/iib_silent_config.txt
    • Windowsdir_instalación\tmaitm6_x64\samples\qi_silent_config.txt
    Donde dir_instalación es el directorio de instalación del Agente de IBM Integration Bus. El directorio de instalación predeterminado es como sigue:
    • Linux o AIX/opt/ibm/apm/agent
    • WindowsC:\IBM\APM
  2. Para el parámetro agentId, especifique una serie alfanumérica exclusiva con una longitud máxima de 8 caracteres como identificador corto para el agente.
    Recuerde: la longitud máxima de ID de agente ha cambiado a 8 caracteres a partir de Agente de IBM Integration Bus versión 7.3.0.1. Para las versiones anteriores, la longitud máxima del ID de agente es de 4 caracteres. Para obtener instrucciones sobre cómo comprobar la versión del agente, consulte Versión del agente.

    El nombre del sistema gestionado incluye el ID del agente que especifique, por ejemplo, nombreintermediariosupervisado:idAgente:KQIB, donde nombreintermediariosupervisado es el nombre del nodo de integración (intermediario) supervisado.

  3. Si desea supervisar los nodos de integración de IBM Integration Bus V10 o IBM App Connect Enterprise V11, especifique el directorio de instalación de IBM Integration Bus V10 o de IBM App Connect Enterprise V11 para el parámetro defaultWMBInstallDirectory. Por ejemplo, C:\Archivos de programa\IBM\ACE\11.0.0.3\ para un sistema Windows, o /opt/ibm/mqsi/ace-11.0.0.3 para un sistema Linux. Si no desea supervisar IBM Integration Bus V10 e IBM App Connect Enterprise V11, este parámetro no es necesario, ya que el Agente de IBM Integration Bus puede descubrir automáticamente los nodos de integración (intermediarios) de las versiones anteriores.
    Recuerde: puede especificar solo un directorio de instalación para el parámetro defaultWMBInstallDirectory. Si ha instalado IBM Integration Bus V10 o IBM App Connect Enterprise V11 en diferentes directorios y desea supervisarlos todos, cree varias instancias de agente y especifique un directorio de instalación de IBM Integration Bus V10 o IBM App Connect Enterprise V11 para cada instancia de agente.
  4. Opcional: Especifique si desea utilizar este agente para supervisar solo algunos nodos de integración (intermediarios) específicos.

    De forma predeterminada, se supervisan todos los nodos de integración (intermediarios) que se ejecutan en el mismo sistema host que el Agente de IBM Integration Bus, tal como lo ha determinado el autodescubrimiento. Para supervisar nodos de integración (intermediarios) específicos, establezca los parámetros collectNodeData y WMBInstallDirectory para cada nodo de integración (intermediario) que desee supervisar.

    collectNodeData
    Especifica si los datos de definición de nodo se recopilan para el nodo de integración (intermediario) supervisado. La sintaxis es collectNodeData.nombre_intermediario=NO|YES, donde nombre_intermediario es el nombre del nodo de integración (intermediario).
    El valor predeterminado es NO. Se recomienda utilizar el valor predeterminado, porque los datos de definición de nodo no están soportados en la Consola de Cloud APM.
    WMBInstallDirectory
    El directorio de instalación del nodo de integración (intermediario) que se va a supervisar. La sintaxis es WMBInstallDirectory.nombre_intermediario=dir_instalación_intermediario, donde dir_instalación_intermediario es el directorio de instalación del nodo de integración (intermediario) que se va a supervisar.
    Recuerde: En el caso de un nodo de integración de la versión 10, el parámetro WMBInstallDirectory puede alterar temporalmente el parámetro defaultWMBInstallDirectory que ha establecido en el paso anterior.
    Por ejemplo, para supervisar sólo dos nodos de integración (intermediarios) denominados BK1 y BK2, establezca los parámetros tal como se indica a continuación:
    collectNodeData.BK1=NO
    collectNodeData.BK2=NO
    WMBInstallDirectory.BK1=dir_instal_BK1
    WMBInstallDirectory.BK2=dir_instal_BK2
  5. Para supervisar intermediarios anteriores a IBM Integration Bus V10, especifique la vía de acceso a biblioteca de 64 bits de IBM MQ(WebSphere MQ) para el parámetro WMQLIBPATH. Por ejemplo, C:\Archivos de programa\IBM\WebSphere MQ\bin64 para un sistema Windows, o /opt/mqm8/lib64 para un sistema Linux.
    Recuerde: si los nodos de integración (intermediarios) utilizan distintas versiones de los gestores de colas, especifique la última versión de la vía de acceso de biblioteca de 64 bits de IBM MQ(WebSphere MQ) para este parámetro.
  6. Guarde y cierre el archivo de respuestas silencioso del agente y luego especifique el mandato siguiente:
    • Linux o AIXdir_instalación/bin/iib-agent.sh config nombre_instancia vía_acceso_a_archivo_respuestas
    • Windowsdir_instalación\BIN\iib-agent.bat config "nombre_instancia vía_acceso_a_archivo_respuestas"
    Donde nombre_instancia es el nombre de la instancia que configura, y vía_acceso_archivo_respuestas es la vía de acceso completa del archivo de respuestas silencioso.
    Aviso: En sistemas Windows, no incluya comillas dobles ("") que rodean la vía de acceso completa al archivo de respuestas silencioso, ya que esto causará un error de configuración.
  7. Una vez finalizada la configuración, especifique el mandato siguiente para iniciar el agente:
    • Linux o AIX
      dir_instalación/bin/iib-agent.sh start nombre_instancia
    • Windows
      dir_instalación\bin\iib-agent.bat start nombre_instancia

Resultados

Ahora, puede iniciar la sesión en la Consola de Cloud APM y utilizar el editor de aplicaciones para añadir la instancia del Agente de IBM Integration Bus al Panel de instrumentos del rendimiento de aplicaciones. Si desea instrucciones sobre cómo iniciar la Consola de Cloud APM, consulte Inicio de la Consola de Cloud APM. Para obtener información sobre cómo utilizar el editor de aplicaciones, consulte Gestión de aplicaciones.

Recuerde: cada vez que actualice o migre un nodo de integración supervisado, debe reiniciar el Agente de IBM Integration Bus después de la actualización o migración del nodo de integración (intermediario).

Qué hacer a continuación

El siguiente paso consiste en configurar IBM Integration Bus para la habilitación de datos. Los datos siguientes sólo están disponibles en el Panel de instrumentos del rendimiento de aplicaciones después de habilitarlos en IBM Integration Bus:

  • Estadísticas y contabilidad de archivado
  • Estadísticas de recursos de JVM
  • Rastreo de transacciones

Encontrará instrucciones en: Configuración de IBM Integration Bus para la habilitación de datos.