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.
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
  • Para Windows
    PATH
  • Para Linux
    Para Solaris
    LD_LIBRARY_PATH
  • Para AIX
    Para z/OS
    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:
Para z/OS
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.

Nota:
Para z/OS
También debe tener permisos de lectura y ejecución en el <directorio de instalación del kit de herramientas XML>/xml4c-5_7/lib y otros directorios. Consulte Establecimiento de los permisos de archivo para crear perfiles en z/OS.
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:
  1. 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>
    • Para Windows
      <dir_instalación>\IBMIMShared\plugins\org.eclipse.tptp.platform.ac.win_<XXXX>\agent_controller
    • Para Linux
      <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>
    • Para Windows
      <dir_instalación>\IBMIMShared\plugins\org.eclipse.hyades.probekit<n.n.n>.v<aaaammddtttt>\os\win32\x86
    • Para Linux
      <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.
  2. 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:
    Para Windows
    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%
    Para Linux
    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:
Para Windows
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%
Para Linux
Para Solaris
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
Para AIX
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
Para z/OS
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:
Para Windows
C:\Archivos de programa\IBM\SDP>eclipse
Para Linux
/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

Para 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:
  1. En un indicador de shell de UNIX System Services, vaya al directorio <dir_instalación_Rational_Agent_Controller>/RACzOS31bit/bin.
  2. Ejecute los mandatos siguientes: umask 022
  3. Inicie Agent Controller: ./ACStart.sh.
Icono que indica el tipo de tema Tema de referencia
Términos y condiciones para centros de información | Comentarios

Icono de indicación de fecha y hora Última actualización: 22 de abril de 2014

Nombre de archivo: rprofilingenvvar.html