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.
Tabla 1. Escenarios para definir variables de entorno automática o manualmente al crear perfiles. Las variables de entorno se definen para servidores locales y remotos. Variable de entorno |
Servidor local |
Servidor remoto |
- PATH
- LD_LIBRARY_PATH
- LIBPATH
|
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: Debe asegurarse de que
la variable de entorno LIBPATH incluye la vía de acceso <directorio de instalación del kit de herramientas XML>/xml4c-5_7/lib.
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.
|
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
donde <dir_instalación> es el directorio de instalación de IBM Rational Software Delivery
Platform y <XXXX> depende del arquitecto del sistema operativo. Sustituya <XXXX>
por el procesador apropiado seleccionando ia32 para un procesador de 32 bits, em64 para un procesador de 64 bits, o ipf para un procesador de la familia de procesadores Itanium; por ejemplo,
org.eclipse.tptp.platform.ac.win_ia32_<n.n.n>.v<aaaammddtttt>,
donde <n.n.n> es el número de versión y <aaaammddtttt> es la fecha e indicación horaria del plugin. |
<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
donde <dir_instalación> es el directorio de instalación de IBM Rational Software Delivery
Platform y <XXXX> depende del arquitecto del sistema operativo. Sustituya <XXXX>
por el procesador apropiado seleccionando ia32 para un procesador de 32 bits, em64 para un procesador de 64 bits, o ipf para un procesador de la familia de procesadores Itanium; por ejemplo,
org.eclipse.tptp.platform.ac.win_ia32_<n.n.n>.v<aaaammddtttt>,
donde <n.n.n> es el número de versión y <aaaammddtttt> es la fecha e indicación horaria del plugin. |
- 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 uno:
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
Si está creando perfiles en z/OS,
deberá tener permisos de lectura y ejecución sobre los siguientes directorios (y todos los directorios en su vía de acceso):
- <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.