Configuración del rastreo de transacciones para el Agente de WebLogic

La prestación de rastro de transacciones del Agente de WebLogic requiere cambios en el archivo de valores de entorno de instancia de agente y en el archivo de arranque del servidor WebLogic. Se proporciona un script para ayudarle a hacer los cambios.

Antes de empezar

Asegúrese de que el límite de recursos para archivos abiertos es mayor que 5.000 para que el kit de herramientas de rastreo de transacciones funcione adecuadamente.

• Muestra el valor límite de archivos abiertos actual. ulimit -n
• Ejemplo que establece el límite de archivos abiertos en 5.056. ulimit -n 5056

Ejecute el procedimiento Configuración de la supervisión de WebLogic paso 1 o paso 2 antes de seguir este procedimiento.

Nota: La prestación de rastreo de transacciones está disponible para el Agente de WebLogic en la oferta Cloud APM, Advanced. Para el Agente de WebLogic con prestación de supervisión de recursos básica, que se encuentra en la oferta Cloud APM, Base, omita este paso.

El Agente de WebLogic debe estar instalado localmente en el servidor WebLogic supervisado con la prestación de rastreo de transacciones.

La cuenta de usuario que ejecuta este script debe tener permiso de escritura sobre los directorios y archivos siguientes:

1. El directorio WEBLOGIC_HOME.
2. El directorio y los archivos de WEBLOGIC_HOME/bin.
3. El directorio dir_instalación/config.
4. El archivo dir_instalación/config/nombre_host_wb_nombre_instancia.cfg.

donde

WEBLOGIC_HOME

Directorio de instalación del servidor WebLogic.

dir_instalación

Vía de acceso donde está instalado el agente. Las vías de acceso predeterminadas a estos registros son las siguientes.

• /opt/ibm/apm/agent
• C:\IBM\APM\TMAITM6_x64

nombreHost

Nombre del sistema principal en el que se instala el agente.

nombre_instancia

Nombre de la instancia de agente asignada en el tema de método de configuración de agente:

• Configuración del agente en sistemas Windows, paso 3
• Configuración del agente respondiendo a solicitudes, paso 1
• Configuración del agente mediante el archivo de respuestas silencioso, paso 2

Ejecute el script simpleConfig.

1. Inicie la sesión en el servidor WebLogic con el Agente de WebLogic instalado.
2. Vaya al directorio de instalación del agente.
   • dir_instalación
   • dir_instalación\TMAITM6_x64

   Donde dir_instalación es la vía de acceso donde está instalado el agente.

   Las vías de acceso de dir_instalación predeterminadas se listan aquí:

   • /opt/ibm/apm/agent
   • C:\IBM\APM\TMAITM6_x64
3. Vaya al directorio wbdchome/8.1.4.0.0/bin.
4. Ejecute el script de configuración.
   • ./simpleConfig.sh
   • simpleConfig.bat
5. Siga las indicaciones para especificar parámetros para su entorno:
   1. Elija el nombre_instancia y el subnodo del Agente de WebLogic para la configuración en la lista de combinaciones de instancias de agente y subnodos detectados, donde nombre_instancia es el nombre de la instancia de agente.
   2. Escriba el número del método de arranque del servidor WebLogic.
   3. Escriba la vía de acceso de búsqueda raíz del dominio de WebLogic.
      Esta vía de acceso se utiliza como la base desde la que realizar búsquedas en dominios de WebLogic. Si la variable de entorno WEBLOGIC_HOME está establecida, el valor correspondiente se ofrece como el valor predeterminado.
   4. Escriba el número del dominio WebLogic del servidor WebLogic a configurar.
   5. Escriba el número del nombre del servidor WebLogic a configurar.
   Configuración de ejemplo con un método de arranque de WebLogic de Script de inicio de WebLogic.

   ./simpleconfig.sh
   
   Los agentes y subnodos siguientes no están configurados todavía para el rastreo de transacciones:
   
   1) wlinst1 Server1
   2) wlinst1 Server2
   
   Escriba el número que corresponde a la instancia y el subnodo de agente que desea configurar.
   
   Escriba aquí su selección (por ejemplo: 1): 1
   
   Se da soporte a los métodos de arranque de WebLogic siguientes:
   
   1) Script de inicio de WebLogic
   2) Gestor de nodos de WebLogic
   
   Escriba aquí su selección (el valor predeterminado es 1): 1
   
   La vía de acceso para empezar a buscar dominios de WebLogic.
   Raíz de la búsqueda de dominios de WebLogic (el valor predeterminado es: ): /home/wlsadmin
   
   Las vías de acceso de dominio de WebLogic encontradas son:
   
   1) /home/wlsadmin/oracle/user_projects/domains/ttdd
   
   Escriba el número correspondiente al dominio de WebLogic que contiene el servidor de
   WebLogic que desea configurar.
   
   Escriba aquí la selección (por ejemplo: 1): 1
   
   Los servidores WebLogic siguientes están disponibles para configuración:
   
   1) AdminServer
   2) Server1
   
   Seleccione un nombre de servidor de WebLogic (el valor predeterminado es: 2): 2
   INFO: [2000] La configuración automática del archivo de entorno de agente ha sido satisfactoria.
   INFO: [3000] La configuración automática del script de inicio de WebLogic ha sido satisfactoria.
   INFO: [9000] Reinicie el agente de WebLogic y el servidor de WebLogic para que la configuración
   entren en vigor.

6. Siga estos pasos si se ha seleccionado Gestor de nodos de WebLogic se ha seleccionado como Método de arranque de servidor WebLogic en el paso 5.b. De lo contrario, continúe con el paso 7.
   1. Abra el archivo weblogic_nodemanager_dc_opts que se lista en el mensaje de información número 3011 del texto de salida del paso 5.
      Salida de configuración de ejemplo con un método de arranque de WebLogic de Gestor de nodos de WebLogic.

      INFO: [2000] La configuración automática del archivo de entorno de agente ha sido satisfactoria.
      INFO: [3010] La configuración automática del script de inicio de WebLogic se ha saltado.
      INFO: [3011] Revise C:\IBM\APM\TMAITM6_x64\wbdchome\8.1.4.0.0\runtime\ttdd_win\win_Server1\
      staging\weblogic_nodemanager_dc_opts.win para conocer las opciones de inicio de máquina
      virtual Java de WebLogic necesarias.
      INFO: [9000] Reinicie el agente de WebLogic y el servidor de WebLogic para que la configuración
      entren en vigor.

   2. Inicie la sesión en la consola de WebLogic y seleccione Entorno > Servidores.
   3. Seleccione el servidor a configurar.
   4. Seleccione la pestaña Configuración > Inicio de servidor.
   5. Copie los argumentos de inicio de servidor del archivo weblogic_nodemanager_dc_opts a los argumentos de Inicio de servidor del servidor en la consola WebLogic y guarde los cambios.
      Los argumentos de inicio de servidor son todas las líneas que siguen a la línea de comentario # Añada las líneas siguientes a los argumentos de inicio de servidor en el archivo weblogic_nodemanager_dc_opts.
   6. Asegúrese de que el kit de herramientas de rastreo de transacción está en la vía de acceso de biblioteca compartida durante el tiempo de ejecución.
      Elija un método.

      • Actualice el script de inicio del Gestor de nodos.
        Nota: Todos los servidores de WebLogic iniciados por el Gestor de nodos tienen esta vía de acceso de bibliotecas establecida con las bibliotecas de archivo de objeto de kit de herramientas de transacción incluidas.
        1. Abra el archivo weblogic_nodemanager_dc_opts que se lista en el mensaje de información número 3011 del texto de salida del paso 5.
        2. Establezca la vía de acceso del kit de herramientas de rastreo de transacciones en el script de inicio del Gestor de nodos. El mandato para establecer la vía de acceso es la línea que sigue a la línea de comentario # Asegúrese de que la vía de acceso ejecutable disponible para el servidor de WebLogic incluye el directorio lib del kit de herramientas en el archivo weblogic_nodemanager_dc_opts.
           • Copie la línea LD_LIBRARY_PATH del archivo weblogic_nodemanager_dc_opts.linux generado y péguela bajo la línea export JAVA_OPTIONS en el script de inicio del Gestor de nodos. Por ejemplo, WEBLOGIC_HOME/user_projects/domains/nombre_dominio/bin/startNodeManager.sh.
           • Copie la línea PATH del archivo weblogic_nodemanager_dc_opts.win generado y péguela bajo la línea export JAVA_OPTIONS del script de inicio del Gestor de nodos. Por ejemplo, WEBLOGIC_HOME\user_projects\domains\nombre_dominio\bin\startNodeManager.bat.

           donde WEBLOGIC_HOME es el directorio de instalación del servidor WebLogic y nombre_dominio es el nombre del dominio de WebLogic.

      • Actualice el entorno de la cuenta de usuario que inicia el Gestor de nodos.
        Nota: Todas las aplicaciones iniciadas por la cuenta de usuario tienen esta vía de acceso de biblioteca establecida con las bibliotecas de archivo de objeto de kit de herramientas incluidas.
        1. Edite los valores de entorno para el usuario que inicia el Gestor de nodos.
           • Edite el archivo de recursos de shell o el archivo de perfil de shell. Por ejemplo, en el shell bash, .bashrc o .bash_profile.
           • Edite Panel de control > Seguridad y sistema > Sistema > Valores avanzados del sistema > Variables de entorno... > Variables de usuario para nombre_usuario > Path, donde nombre_usuario es el nombre de la cuenta de usuario utilizada para iniciar el servidor WebLogic.
        2. Establezca la vía de acceso del kit de herramientas de rastreo de transacciones en el entorno de cuenta de usuario. El mandato para establecer la vía de acceso es la línea que sigue a la línea de comentario # Asegúrese de que la vía de acceso ejecutable disponible para el servidor de WebLogic incluye el directorio lib del kit de herramientas en el archivo weblogic_nodemanager_dc_opts.
           • Copie la línea export LD_LIBRARY_PATH del archivo weblogic_nodemanager_dc_opts.linux generado. Si una línea de export LD_LIBRARY_PATH no existe, añádala. Si existe, edítela para añadir solo la vía de acceso desde la derecha del signo igual a la vía de acceso existente con el delimitador de vía de acceso correcto.
           • Copie la línea set PATH del archivo weblogic_nodemanager_dc_opts.win generado. Si una variable Path no existe en la sección Variables de usuario para nombre_usuario, donde nombre_usuario es el nombre de la cuenta de usuario utilizada para iniciar el servidor WebLogic, añádala especificando Path como el nombre de variable y la vía de acceso desde la derecha del signo igual como valor. Si existe, edite el valor para añadir solo la vía de acceso desde la derecha del signo igual a la vía de acceso existente con el delimitador de vía de acceso correcto.
        3. Vuelva a cargar el entorno.
   Aviso: El programa de utilidad de configuración de WebLogic genera los scripts de startNodeManager. Por lo tanto, puede perder los cambios cuando se vuelve a ejecutar la configuración de WebLogic.
7. Si el servidor y el agente de WebLogic se están ejecutando, reinícielos.