Configurar variables de entorno para definir el perfil de un servidor
Definir el perfil de un servidor permite analizar el rendimiento, las hebras y el uso de memoria cuando se ejecuta una aplicación web. En algunos casos, debe configurar las variables de entorno en el equipo del host de destino antes de iniciar el servidor en modo de perfil. las variables de entorno deben definirse antes de iniciar el servidor para crear perfiles. En equipos que ejecuten z/OS también debe definir permisos en los directorios utilizados por Rational Agent Controller.
Determinar si las variables de entorno para perfiles deben definirse manualmente
En algunos casos, no es necesario definir las variables de entorno manualmente en el equipo de destino cuando se definen perfiles; el espacio de trabajo define dichas variables automáticamente. No obstante, en algunos casos las variables de entorno deben definirse manualmente. Los factores siguientes determinan si es necesario definir las variables de entorno manualmente y qué variables deben definirse:
- Si el equipo de destino para el servidor es el mismo equipo en el que se ha instalado el espacio de trabajo (servidor local) o si el servidor se encuentra en otro equipo (servidor remoto).
- Si el ID de usuario tiene acceso de escritura al directorio /java/jre/bin/ para WebSphere Application Server (servidor local).
- La versión instalada de Rational Agent Controller (servidor remoto).
En la tabla siguiente se muestran las condiciones en que las variables de entorno se definen automática o manualmente.
| Variable de entorno | Servidor local | Servidor remoto |
|---|---|---|
|
Se define automáticamente en el espacio de trabajo. | Se define automáticamente si el servidor remoto utiliza Rational Agent Controller V8.3
o posterior. En caso contrario, se define manualmente. Nota:
![]() Por ejemplo, si ha instalado el kit de herramientas XML en /usr/lpp/ixm/IBM/xml4c-5_7, la variable de entorno LIBPATH debe contener la vía de acceso: LIBPATH=/usr/lpp/ixm/IBM/xml4c-5_7/lib. Nota:
![]() |
| TPTP_AC_HOME | Se define automáticamente en el espacio de trabajo. | Se define automáticamente si el servidor remoto utiliza Rational Agent Controller V8.3 o posterior. En caso contrario, se define manualmente. |
| PROBEKIT_HOME (solo se necesita si se utiliza la opción de supervisor Probe Insertion.) | Se define automáticamente en el espacio de trabajo. | Se define manualmente. |
| JAVA_PROFILER_HOME | Se define automáticamente en el espacio de trabajo. | Se define automáticamente si el servidor remoto se encuentra en un sistema operativo Windows o Linux que utiliza Rational Agent Controller V8.3 o posterior. En caso contrario, se define manualmente. |
Definir manualmente variables de entorno de perfiles para un servidor local
Par aun servidor que se ejecuta en la misma máquina que el entorno de trabajo, siga estos pasos:
- Localice las siguientes carpetas de plugin en el directorio de instalación de IBM® Rational Software Delivery Platform. Nota: Seleccione siempre el que tenga el número de versión y la fecha más recientes si existen varias versiones del mismo plugin.
Tabla 2. Vías de acceso de los plugin utilizadas para definir variables de entorno para crear perfiles en un servidor local. Utilice la vía de acceso del plugin para determinar la variable de entorno. Descripción Vía de acceso de plugin <Inicio de Agent Controller> - <dir_instalación>\IBMIMShared\plugins\org.eclipse.tptp.platform.ac.win_<XXXX>\agent_controller

- <dir_instalación>/IBMIMShared/plugins/org.eclipse.tptp.platform.ac.linux_<XXXX>/agent_controller

<Inicio de Probekit> - <dir_instalación>\IBMIMShared\plugins\org.eclipse.hyades.probekit<n.n.n>.v<aaaammddtttt>\os\win32\x86

- <dir_instalación>/IBMIMShared/plugins/org.eclipse.hyades.probekit<n.n.n>.v<aaaammddtttt>/os/linux/x86

- Configure las variables de entorno siguientes antes de iniciar el espacio de
trabajo y el servidor de aplicaciones. Abra un indicador de mandatos y escriba los
mandatos siguientes sustituyendo <Inicio de Agent
Controller> y el <Inicio de
Probekit> opcional por las vías de acceso de plugin determinadas en
el paso anterior: set TPTP_AC_HOME=<Inicio Agent Controller> set PROBEKIT_HOME=<Inicio Probekit> set PATH=%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%;%PATH%
export TPTP_AC_HOME=<Inicio de Agent Controller> export PROBEKIT_HOME=<Inicio de Probekit> export LD_LIBRARY_PATH=$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME:$LD_LIBRARY_PATH
Definir manualmente variables de entorno para la creación de perfiles en un servidor remoto
Para servidores de aplicaciones que se ejecutan en un equipo distinto del equipo del espacio de trabajo, siga estos pasos:
Nota: Si crea el perfil de un servidor de aplicaciones remoto, debe instalar Rational Agent Controller en la misma máquina en la que se encuentra el servidor de aplicaciones. Verifique que los valores de variable de entorno siguientes se seleccionan en el proceso de inicio del servidor de aplicaciones.
En el equipo en el que se encuentra el servidor de aplicaciones remoto, defina
manualmente las variables de entorno necesarias antes de iniciar el espacio de
trabajo y el servidor de aplicaciones. Puede definir manualmente las siguientes variables de entorno en el sistema de destino sustituyendo <dir_instalación_AC> por el directorio de instalación de Rational Agent Controller.
Además, si utiliza la opción de supervisor Probe Insertion, especifique la variable de entorno PROBEKIT_HOME:
set TPTP_AC_HOME=<dir_instalación_AC>
set JAVA_PROFILER_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.tptp.javaprofiler
set PROBEKIT_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.hyades.probekit
set PATH=%JAVA_PROFILER_HOME%;%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%\lib;%PATH%

export TPTP_AC_HOME=<dir_instalación_AC>
export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler
export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit
export LD_LIBRARY_PATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LD_LIBRARY_PATH
export TPTP_AC_HOME=<dir_instalación_AC>
export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler
export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit
export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH
export TPTP_AC_HOME=<dir_instalación_AC/RACzOS64 o 31bit>
export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler
export XERCESC_HOME=<dir_instalación_kit_herramientas_XML>/xml4c-5_7/lib
export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit
export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$XERCESC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH
donde <dir_instalación_kit_herramientas_XML> suele ser /usr/lpp/ixm/IBM.
Nota: Si ha habilitado la seguridad al instalar Rational Agent Controller, especifique estos mandatos:
- extattr +ap <dir_Rational_Agent_Controller>/lib/*
- extattr +ap <dir_Rational_Agent_Controller>/plugins/org.eclipse.tptp.javaprofiler/*
- extattr +ap <dir_instalación_kit_herramientas_XML>/xml4c-5_7/lib/*
Iniciar el espacio de trabajo
Cuando haya definido las
variables de entorno necesarias, inicie el espacio de trabajo IBM
Rational Software Delivery Platform desde un
indicador de mandatos de modo que las variables de entorno se seleccionen en el proceso
del espacio de trabajo. Por ejemplo, ejecute el siguiente mandato:
C:\Archivos de programa\IBM\SDP>eclipse
/opt/IBM/SDP>./eclipse
Nota: Cuando defina un perfil con WebSphere Application
Server, las variables de entorno configuradas pueden añadirse al archivo setupCmdLine.bat (Windows) o setupCmdLine.sh (Linux) que se encuentra en la carpeta /bin de la instalación del servidor.
Establecimiento de los permisos de archivo para crear perfiles en z/OS

- <Directorio de instalación de Rational Agent Controller >/lib/*
- <Directorio de instalación de Rational Agent Controller>/plugins/org.eclipse.tptp.javaprofiler/*
- <Directorio de instalación de XML Toolkit>/xml4c-5_7/lib*
Nota: Todos los directorios de la vía de acceso a estos directorios también necesitan permiso de lectura y ejecución. Por ejemplo, si <Directorio de instalación de Rational Agent Controller> es /opt/IBM/RAC,
necesitará permisos de lectura y ejecución en los directorios /opt, /opt/IBM, /opt/IBM/RAC y /opt/IBM/RAC/lib/.
Para conceder el permiso correcto a estos directorios, ejecute el mandato umask 022:
- En un indicador de shell de UNIX System Services, vaya al directorio <dir_instalación_Rational_Agent_Controller>/RACzOS31bit/bin.
- Ejecute los mandatos siguientes: umask 022
- Inicie Agent Controller: ./ACStart.sh.