Guía de instalación para IBM Performance Optimization Toolkit para Rational Performance Tester, Versión 6.1.2

Bienvenido a IBM(R) Performance Optimization Toolkit 6.1.2 para Rational(R) Performance Tester. Esta guía contiene información acerca de la instalación y la configuración del kit de herramientas.

Puede encontrar información adicional de última hora acerca de las limitaciones y las soluciones provisionales en el kit de herramientas notas del release.

IBM Performance Optimization Toolkit requiere que el producto Rational Performance Tester esté instalado. El kit de herramientas proporciona las características siguientes:

Contenido


Requisitos previos de hardware

Kit de herramientas

El hardware siguiente debe estar instalado antes de instalar este kit de herramientas. Se utilizan estas cifras porque se supone que también se instala la infraestructura de recopilación de datos en la misma máquina:

Infraestructura de recopilación de datos

Los requisitos mínimos necesarios para instalar la infraestructura de recopilación de datos en una máquina distinta de donde está instalado el espacio de trabajo es el hardware siguiente:


Requisitos previos de software

Kit de herramientas

El software siguiente debe estar instalado antes de instalar esta actualización del kit de herramientas:

Importante: Desinstale todas las versiones beta de Rational Performance Analyst y Rational Performance Tester e instale el producto Rational Software Development Platform apropiado listado anteriormente, antes de instalar el kit de herramientas.

Infraestructura de recopilación de datos

Instale la infraestructura de recopilación de datos en todos los sistemas principales que participan en la aplicación distribuida desde la que desea recopilar datos. También se recomienda (y para algunos casos es necesario) que instale la infraestructura de recopilación de datos en la máquina local dónde se ha instalado el kit de herramientas.

Nota para Linux: la característica Motor de recogida de datos de Hyades de la infraestructura de recopilación de datos se compila utilizando la biblioteca compartida libstdc++-libc6.2-2.so.3. Asegúrese de que esta biblioteca compartida existe bajo el directorio /usr/lib. Si no existe, debe instalar el paquete RPM compat-libstdc++ que se adjunta con el soporte de instalación del sistema operativo.

Se ha comprobado la infraestructura de recopilación de datos en las plataformas siguientes:

No se ha probado, pero se espera que se ejecute en Red Flag Advance Server v4.0 en Intel IA32.

En general, la infraestructura de recopilación de datos funciona con la versión 1.4 y posteriores de JVM. Éstas son las versiones de JVM (java -fullversion) en las que se ha probado la recopilación de datos:


Requisitos del servidor para casos de ejemplo de recopilación de datos soportados

El kit de herramientas recopila datos de perfilado de rendimiento para aplicaciones distribuidas y las envía al área de trabajo donde se puede visualizar y analizar los datos recopilados. Puede consultar una base de datos de servidor de gestión Tivoli Monitoring for Transaction Performance (TMTP), IBM Tivoli Composite Application Manager para Response Time Tracking (ITCAM para RTT) o IBM Tivoli Composite Application Manager para WebSphere (ITCAM para WebSphere) de modo que recopile los datos de rendimiento anteriores para una aplicación que se despliega en un entorno de producción. Con IBM Performance Optimization Toolkit para Rational Performance Tester, también puede supervisar una aplicación activa en un entorno de desarrollo o prueba y recopilar sus datos en tiempo real.

En un entorno de producción, puede recopilar datos consultando la base de datos del servidor de gestión para el software de gestión del sistema siguiente:

Para una aplicación Web activa, la infraestructura de recopilación de datos recopila los datos de perfilado de rendimiento de los servidores Web siguientes:

Consulte las guías de instalación para obtener todas las instrucciones para instalar estos productos. Las instrucciones de instalación siguientes incluyen información sobre cómo configurar estos productos para utilizarlos con la infraestructura de recopilación de datos.


Instalación, inicio y desinstalación del kit de herramientas en Windows

Instalación del kit de herramientas

Antes de instalar el kit de herramientas, compruebe que la variable de entorno TEMP o TMP señala hacia un directorio temporal válido que tenga como mínimo 100 MB libres. Esto es además del espacio necesario para instalar el producto.

Puede obtener el kit de herramientas V 6.x.0, que es un requisito previo, junto con las instrucciones de instalación en el sitio Web siguiente:

Para actualizar el kit de herramientas a la versión 6.x.1:

  1. Inicie Rational Product Updater seleccionando Inicio > IBM Rational > Rational Product Updater.
  2. Pulse en Buscar actualizaciones. De este modo, accederá a Internet para obtener información sobre las actualizaciones disponibles para cualquier producto de Rational Software Development Platform que tenga instalado.
  3. En la pestaña Actualizaciones, compruebe que están seleccionadas las actualizaciones 6.0.1 para el kit de herramientas y, si lo hay, cualquier producto base.
  4. Pulse en Instalar actualizaciones. Lea la información de licencia que se muestra.
  5. El actualizador descargará e instalará las actualizaciones del kit de herramientas y cualquier actualización necesaria de otros productos de Rational; esta acción puede tardar varios minutos.
  6. Cuando la instalación haya finalizado, pulse en Limpiar para liberar espacio del disco duro mediante la eliminación de la versiones anteriores. Recuerde que este paso le impedirá volver a las versiones anteriores del kit de herramientas, o realizar una desinstalación completa del kit de herramientas sin eliminar totalmente todos los productos de Rational Software Development Platform.
Ahora debe instalar la infraestructura de recopilación de datos. Consulte el apartado Instalación de la infraestructura de recopilación de datos para obtener instrucciones.
Nota:

Inicio del kit de herramientas

El kit de herramientas se ha instalado como parte adicional de un producto Rational Software Development Platform que ya tiene instalado (Rational Performance Tester, Rational Application Developer o Rational Software Architect). Para utilizar las herramientas, lance el programa del modo habitual. Por ejemplo, en el menú Inicio, seleccione Programas > IBM Rational > Rational Software Development Platform.

La primera vez que inicie tras la instalación, se abrirá un recuadro de diálogo con el directorio de área de trabajo por omisión ya especificado. Si desea guardar su trabajo en algún otro sitio, puede cambiar el nombre y la ubicación del espacio de trabajo. Si desea utilizar siempre este espacio de trabajo, active el recuadro de selección Utilizar como valor predeterminado y no volver a preguntar. Puede cambiar el valor predeterminado después de iniciar el producto en la página Ventana > Preferencias > Espacio de trabajo > Inicio y conclusión.

El espacio de trabajo se abre primero a una serie de páginas de bienvenida que proporcionan una visión general del producto, que incluye información general acerca del kit de herramientas, información acerca de las novedades, además de enlaces a guías de aprendizaje, ejemplos y recursos web externos para el producto base. Dedique algún tiempo a explorar estas opciones. Fíjese también en las fuentes de información disponibles en el menú Ayuda. Puede volver a estas páginas de bienvenida seleccionando Ayuda > Bienvenida.

Desinstalación del kit de herramientas

Nota: si tiene instalada la infraestructura de recopilación de datos, desinstálela antes de desinstalar el kit de herramientas. Consulte el apartado Desinstalación de la infraestructura de recopilación de datos para obtener instrucciones.

Para desinstalar el kit de herramientas:

  1. Cierre todos los programas de Rational Software Development Platform y detenga la infraestructura de recopilación de datos.
  2. Abra el Panel de control (en el menú Inicio de Windows) y después abra la ventana Agregar o quitar programas. Seleccione Herramientas de análisis de problemas y rendimiento distribuido de Rational y pulse Cambiar/Quitar. Vaya al asistente de desinstalación para desinstalar el producto.
  3. Se suprimen automáticamente todos los archivos de los directorios de plug-ins o características, incluyendo los datos de usuario y los plug-ins de terceros que residan en cualquiera de estos directorios. El directorio del espacio de trabajo, que contiene su trabajo, no se suprime. Otros directorios que permanecen:
  4. Para eliminar todos los archivos del kit de herramientas, también debe desinstalar otros productos de Rational Software Development Platform. Siga las instrucciones de desinstalación que se proporcionan en las guías de instalación de los productos. Compruebe que se han eliminado todos los archivos y directorios del directorio de instalación de la plataforma. Después, puede volver a instalar esos productos.

    Nota: puede omitir este paso si, cuando realizó la actualización a la versión 6.x.1, no pulsó el botón Limpiar. Si no realizó la limpieza:

    1. Ejecute Rational Product Updater en modalidad de anulación con el siguiente mandato desde el subdirectorio updater\eclipse del directorio de instalación de Rational Software Development Platform:
      rpu -enableRollback
    2. En la pestaña Anulaciones, seleccione la actualización del kit de herramientas 6.0.1 y pulse Anular actualización. Tenga en cuenta que esta acción puede obligarle a anular otros productos de Rational Software Development Platform para garantizar la compatibilidad. Puede volver a aplicar las actualizaciones más tarde.
    3. Cuando haya finalizado la anulación, salga de Rational Product Updater.
    4. Desinstale el kit de herramientas, siguiendo los pasos del 1 al 3 anteriores.

Si intenta desinstalar parcialmente una o varias de las características necesarias, obtendrá un mensaje de error parecido a este:

Selección no válida:
No se ha podido desinstalar ide_required: la raíz no está establecida para desinstalar

Para solucionar este problema, marque el recuadro de selección Desinstalación del producto en el asistente para la desinstalación. El panel de desinstalación se reiniciará de forma que ahora podrá desinstalar el kit de herramientas totalmente o deseleccionar las características que no desee desinstalar.

 


Instalación, inicio y desinstalación del kit de herramientas en Linux

Instalación del kit de herramientas

Antes de instalar el kit de herramientas, compruebe lo siguiente:

Puede obtener el kit de herramientas V 6.x.0, que es un requisito previo, junto con las instrucciones de instalación en el sitio Web siguiente:

Para actualizar el kit de herramientas a la versión 6.x.1:

  1. Inicie Rational Product Updater desde el subdirectorio updater/eclipse del directorio de instalación, ejecutando el mandato: ./rpu.bin. Puede que haya un método abreviado en el menú principal, en Programación o IBM Rational.
  2. Pulse en Buscar actualizaciones. De este modo, accederá a Internet para obtener información sobre las actualizaciones disponibles para cualquier producto de Rational Software Development Platform que tenga instalado.
  3. En la pestaña Actualizaciones, compruebe que están seleccionadas las actualizaciones 6.0.1 para el kit de herramientas y, si lo hay, cualquier producto base.
  4. Pulse en Instalar actualizaciones. Lea la información de licencia que se muestra.
  5. El actualizador descargará e instalará las actualizaciones del kit de herramientas y cualquier actualización necesaria de otros productos de Rational; esta acción puede tardar varios minutos.
  6. Cuando la instalación haya finalizado, pulse en Limpiar para liberar espacio del disco duro mediante la eliminación de la versiones anteriores. Recuerde que este paso le impedirá volver a las versiones anteriores del kit de herramientas, o realizar una desinstalación completa del kit de herramientas sin eliminar totalmente todos los productos de Rational Software Development Platform.

Ahora debe instalar la infraestructura de recopilación de datos. Consulte el apartado Instalación de la infraestructura de recopilación de datos para obtener instrucciones.

Notas:

Inicio del kit de herramientas

El kit de herramientas se ha instalado como parte adicional de un producto Rational Software Development Platform que ya tiene instalado (por ejemplo, Rational Performance Tester o Rational Application Developer). Para iniciar Software Development Platform desde una línea de mandatos, vaya al directorio de instalación y ejecute el mandato: ./rationalsdp.bin.

De forma alternativa, si está trabajando en Gnome (que es el valor predeterminado de Red Hat), el acceso directo al producto estará en el menú principal bajo Programación > Rational Software Development Platform. Si está trabajando en KDE (que es el valor por omisión SuSE) el acceso directo al producto será IBM Rational > Rational Software Development Platform.

La primera vez que inicie tras la instalación, se abrirá un recuadro de diálogo con el directorio de área de trabajo por omisión ya especificado. Si desea guardar su trabajo en algún otro sitio, puede cambiar el nombre y la ubicación del espacio de trabajo. Si desea utilizar siempre este espacio de trabajo, active el recuadro de selección Utilizar como valor predeterminado y no volver a preguntar. Puede cambiar el valor predeterminado después de iniciar el producto en la página Ventana > Preferencias > Espacio de trabajo > Inicio y conclusión.

El espacio de trabajo se abre primero a una serie de páginas de bienvenida que proporcionan una visión general del producto e información acerca de las novedades, además de enlaces a guías de aprendizaje, ejemplos y recursos web externos. Dedique algún tiempo a explorar estas opciones. Fíjese también en las fuentes de información disponibles en el menú Ayuda. Puede volver a estas páginas de bienvenida seleccionando Ayuda > Bienvenida.

Desinstalación del kit de herramientas

Nota: si tiene instalada la infraestructura de recopilación de datos, desinstálela antes de desinstalar el kit de herramientas. Consulte el apartado Desinstalación de la infraestructura de recopilación de datos para obtener instrucciones.

Para desinstalar el kit de herramientas en Linux, siga estos pasos:

  1. Inicie una sesión como root.
  2. Vaya al subdirectorio rpa_prod/_uninst/ en el directorio de instalación.
  3. Desinstale tecleando este mandato: ./uninstall.bin. Si está trabajando en un gestor de archivos, puede pulsar el archivo para lanzar el desinstalador.
  4. Se suprimen automáticamente todos los archivos o características de los directorios de plug-ins o características, incluyendo los datos de usuario y los plug-ins de terceros que residan en cualquiera de estos directorios. El directorio del espacio de trabajo, que contiene su trabajo, no se suprime. Otros directorios que permanecen:
  5. Para eliminar todos los archivos del kit de herramientas, también debe desinstalar otros productos de Rational Software Development Platform. Siga las instrucciones de desinstalación que se proporcionan en las guías de instalación de los productos. Compruebe que se han eliminado todos los archivos y directorios del directorio de instalación de la plataforma. Después, puede volver a instalar esos productos.

    Nota: puede omitir este paso si, cuando realizó la actualización a la versión 6.x.1, no pulsó el botón Limpiar. Si no realizó la limpieza:

    1. Ejecute Rational Product Updater en modalidad de anulación con el siguiente mandato desde el subdirectorio updater\eclipse del directorio de instalación de Rational Software Development Platform:
      rpu.bin -enableRollback
    2. En la pestaña Anulaciones, seleccione la actualización del kit de herramientas 6.0.1 y pulse Anular actualización. Tenga en cuenta que esta acción puede obligarle a anular otros productos de Rational Software Development Platform para garantizar la compatibilidad. Puede volver a aplicar las actualizaciones más tarde.
    3. Cuando haya finalizado la anulación, salga de Rational Product Updater.
    4. Desinstale el kit de herramientas, siguiendo los pasos del 1 al 4 anteriores.

Si intenta desinstalar parcialmente una o varias de las características necesarias, obtendrá un mensaje de error parecido a este:

Selección no válida:
No se ha podido desinstalar ide_required: la raíz no está establecida para desinstalar

Para solucionar este problema, marque el recuadro de selección Desinstalación del producto. El panel de desinstalación se reiniciará de forma que ahora podrá desinstalar el kit de herramientas totalmente o deseleccionar las características que no desee desinstalar.

 


Instalación, configuración, inicio y desinstalación de la infraestructura de recopilación de datos

La infraestructura de recopilación de datos debe estar instalada en una máquina que participe en la ejecución de la aplicación que se supervisa, de la que se van a recopilar datos de rendimiento. A continuación, debe configurar los servidores de aplicaciones en las máquinas para habilitar el perfilado de las aplicaciones. Asimismo, para recopilar datos a través de pruebas de rendimiento o para cargar planificaciones de pruebas, debe instalar la infraestructura de recopilación de datos en la misma máquina donde se encuentra instalado el kit de herramientas frontal.

Notas importantes:

Desinstalación de los mecanismos de recopilación de datos existentes (Agent Controller)

La infraestructura de recopilación de datos está en conflicto con otros mecanismos de recopilación de datos basados en Hyades. Si tiene una versión anterior de Rational Agent Controller o de cualquier software derivado del Motor de recogida de datos de Hyades, deténgala, desinstálela y borre los archivos que queden antes de instalar esta versión de Agent Controller. Es posible que se dejen los archivos siguientes tras la desinstalación y se han de eliminar:

Windows:

%RASERVER_HOME%\*.* (directorio donde está instalado Agent Controller)
%SystemRoot%\system32\piAgent.dll (directorio system32 de Windows)
%SystemRoot%\system32\LogAgent.dll
%SystemRoot%\system32\hcbnd.dll
%SystemRoot%\system32\hcclco.dll
%SystemRoot%\system32\hccldt.dll
%SystemRoot%\system32\hccls.dll
%SystemRoot%\system32\hcclserc.dll
%SystemRoot%\system32\hcclsert.dll
%SystemRoot%\system32\hcclsm.dll
%SystemRoot%\system32\hcjbnd.dll
%SystemRoot%\system32\hclaunch.dll
%SystemRoot%\system32\hcthread.dll
%SystemRoot%\system32\piAgent.dll
%SystemRoot%\system32\rac.dll
%SystemRoot%\system32\sysperf.dll

Linux, AIX, HP-UX, Solaris:

$RASERVER_HOME/* (directorio de instalación de Agent Controller
/usr/lib/libpiAgent.so (o .sl en HP-UX)
/usr/lib/libLogAgent.so
/usr/lib/libhcbnd.so
/usr/lib/libhcclco.so
/usr/lib/libhccldt.so
/usr/lib/libhccls.so
/usr/lib/libhcclserc.so
/usr/lib/libhcclsert.so
/usr/lib/libhcclsm.so
/usr/lib/libhcjbnd.so
/usr/lib/libhclaunch.so
/usr/lib/libhcthread.so

Para obtener las instrucciones de desinstalación completas, consulte las instrucciones de desinstalación que se proporcionan con Agent Controller u otros mecanismos de recopilación de datos basados en Hyades que pudiera tener instalados.

Instalación de la infraestructura de recopilación de datos en Windows o Linux

Nota: existen problemas intermitentes conocidos con la instalación de la infraestructura de recopilación de datos en máquinas Windows Server 2003 que utilizan vías de acceso largas o vías de acceso con espacios. Si es posible, evite estos directorios. Esto no se aplica únicamente al directorio de instalación de destino, sino también al directorio desde el que se realiza la instalación.

Para instalar la infraestructura de recopilación de datos:

  1. Inicie sesión como usuario root (Linux) o bien como Administrador (Windows).
  2. Vaya al directorio temporal de instalación donde se encuentra la imagen de instalación.
  3. Linux: Escriba ./setup.bin para visualizar la ventana del Launchpad de la instalación. Windows: Efectúe una doble pulsación en setup.exe.

    Nota (Linux): Si tiene problemas para iniciar el instalador o el resto de la instalación, puede que sea necesario ejecutar los derechos de ejecución en los archivos implicados. Ejecute los mandatos siguientes en el directorio temporal donde ha descargado y desempaquetado la imagen:

    chmod 755 setup.bin
    chmod 755 setup/lplinuxbin
    chmod 755 dci_linux/disk1/setup/setup.bin
  4. Desde la ventana de instalación, seleccione Instalar IBM Rational Data Collection Infrastructure v6.0.
  5. Cuando aparezca la página de bienvenida, pulse Siguiente.
  6. Siga las instrucciones para leer el acuerdo de licencia. Pulse Siguiente.
  7. Especifique el nombre de un directorio donde instalar la infraestructura.

    Nota: Si va a instalar en la misma máquina que un producto Rational Software Development Platform como Rational Application Developer o Rational Performance Tester, debe instalar la infraestructura de recopilación de datos en la misma ubicación donde el producto ha instalado Agent Controller.

    Pulse Siguiente.

  8. La página siguiente muestra las características disponibles; en este caso sólo hay una, que está seleccionada por omisión. Pulse Siguiente.
  9. En la página siguiente, especifique el tiempo de ejecución de Java que debe utilizar la infraestructura de recopilación de datos. Los datos JRE que indique aquí los utilizará la infraestructura de recopilación de datos para lanzar aplicaciones Java. Recomendamos que se especifique JRE versión 1.4.2. Pulse Siguiente.
  10. Opcional: En la página WebSphere Application Server, si utiliza la versión 5.0 o la versión 5.1, especifique el lugar en el que está instalado el servidor en esta máquina. Se trata del servidor en el que se ejecutará la aplicación de la que desea recopilar datos. Nota: si utiliza la versión 6.0 de WebSphere Application Server, no tendrá que especificar nada porque se detecta automáticamente. Pulse Siguiente.
  11. En la página del listado de sistemas principales, especifique qué sistemas principales pueden acceder al motor de recopilación de datos. Las opciones son las siguientes:

    Pulse Siguiente.

  12. En la página Seguridad, seleccione Inhabilitar. La opción Habilitar entra en conflicto con Rational Performance Tester y no se soporta (este es un error conocido). Como alternativa de seguridad, utilice la opción Lista de sistemas principales que se proporciona en la página anterior. Pulse Siguiente.
  13. Revise la página de resumen y pulse Siguiente Comenzará la transferencia de archivos, instalando la infraestructura de recopilación de datos.

    Nota: Si obtiene errores en esta fase de la instalación y tiene Agent Controller instalado a partir del producto Rational Application Developer, salga de la instalación, desinstale Agent Controller (siguiendo las instrucciones de la guía de instalación de Rational Application Developer) e intente instalar de nuevo la infraestructura de recopilación de datos.

  14. Cuando se haya terminado la instalación, pulse Finalizar.
  15. Se abrirá otro asistente de instalación para instalar el componente de recopilación de datos de Tivoli. Pulse Siguiente.
  16. Siga las instrucciones del asistente para leer el acuerdo de licencia. Pulse Siguiente.
  17. Revise la información de resumen de la instalación y pulse Siguiente. Comenzará la transferencia de archivos, instalando el componente de recopilación de datos de Tivoli.
  18. Cuando se haya terminado la instalación, pulse Finalizar.

El paso siguiente es configurar el servidor de aplicaciones para utilizar la infraestructura de recopilación de datos.

Instalación de la infraestructura de recopilación de datos en AIX, HP-UX o Solaris

Para instalar la infraestructura de recopilación de datos:

  1. Inicie la sesión como usuario root.
  2. Desde el directorio donde se encuentra la imagen de instalación, ejecute el mandato siguiente:
    /installDCIComponents.sh -console
  3. El proceso de instalación le solicitará la información siguiente: Entre según corresponda:
    1. Aceptación de la licencia.
    2. Directorio de instalación de la infraestructura de recopilación de datos. Entre un nombre de directorio, como ./rpa_dci.
    3. La vía de acceso al tiempo de ejecución de Java que debe utilizar la infraestructura de recopilación de datos. Los datos JRE que indique aquí los utilizará la infraestructura de recopilación de datos para lanzar aplicaciones Java. Recomendamos que se especifique JRE versión 1.4.2.
    4. Opcional: La vía de acceso a donde está instalado WebSphere Application Server V5.0 o V5.1. Se trata del servidor en el que se ejecutará la aplicación de la que desea recopilar datos. Nota: si utiliza la versión 6.0 de WebSphere Application Server, no tendrá que especificar nada porque se detecta automáticamente.
    5. Qué sistemas principales pueden acceder al motor de recopilación de datos. Entre uno de los siguientes:
      • CUALQUIERA - permite que todos los clientes puedan acceder.
      • LOCAL - permite que todos los sistemas principales locales puedan acceder al mismo.
      • PERSONALIZADA - permite que una lista específica de clientes acceda al mismo. A continuación, entrará una lista de nombres de clientes, separados por comas.
    6. El valor de seguridad. Escriba FALSO. La opción de seguridad = VERDADERO entra en conflicto con Rational Performance Tester y no se soporta (este es un error conocido). Como alternativa de seguridad, utilice la opción PERSONALIZADO del paso anterior.
  4. Cuando acabe de entrar esta información, la infraestructura principal de recopilación de datos se instalará.
  5. El proceso de instalación le solicitará que acepte la licencia de instalación del Agent Controller.
  6. Acepte la ubicación de instalación por omisión para el componente Agent Controller (si no, el producto no funcionará correctamente). A continuación se instalará el componente Agent Controller.
  7. El proceso de instalación le solicitará que acepte la licencia de instalación del componente motor de recopilación de datos Tivoli ARM.
  8. Acepte la ubicación de instalación por omisión para el componente motor de recopilación de datos Tivoli Arm (si no, el producto no funcionará correctamente). A continuación se instalará el componente motor de recopilación de datos de Tivoli ARM.

Los errores que se produzcan durante la instalación se mostrarán en la consola. Los mensajes de error indicarán el nombre del registro de errores de instalación donde puede obtener más información acerca de lo que ha sucedido. Los errores en una fase detendrán la instalación y los componentes siguientes no se instalarán.

Nota importante si utiliza WebSphere Application Server V6.x en HP-UX: después de instalar la infraestructura de recopilación de datos, asegúrese de que SHLIB_PATH está establecido. De lo contrario, puede que no se recopilen los datos de la transacción y no habrá informes de los errores NoClassDef en ARM. Para establecer SHLIB_PATH, ejecute el mandato siguiente:

export SHLIB_PATH=$(SHLIB_PATH):$tivoli_comp/app/instrument/5301/lib/$(interp):$tivoli_comp/bin/$(interp)/USRLIB

El paso siguiente es configurar el servidor de aplicaciones para utilizar la infraestructura de recopilación de datos.

Configuración de los servidores de aplicación para trabajar con la infraestructura de recopilación de datos

Para que el servidor de aplicaciones envíe correctamente datos de rendimiento a la infraestructura de recopilación de datos, debe estar configurado correctamente y se debe reiniciar antes de que empiece a utilizar la recopilación de datos.

Notas:

Para configurar un servidor de aplicaciones:

  1. ¡Importante! Asegúrese de que el servidor de aplicaciones que va a configurar se está ejecutando.
  2. Abra una línea de mandatos y vaya al directorio rpa_prod debajo del directorio de instalación de la infraestructura de recopilación de datos.
  3. El programa de utilidad de configuración se denomina instrumentServer.sh (instrumentServer.bat en Windows). Escriba el nombre del mandato sin argumentos para ver los detalles de sintaxis para el mandato.
  4. Escriba el nombre del mandato con los argumentos deseados para configurar un servidor. Consulte los ejemplos siguientes.

Los cambios entrarán en vigor cuando detenga y vuelva a iniciar el servidor.

Repita los pasos de configuración para cada servidor en la máquina que participa en la recopilación de datos para las aplicaciones de las que realiza el perfilado (Habitualmente, sólo existirá un servidor de aplicaciones, pero es posible que tenga más de uno en una máquina).

Sintaxis y ejemplos de mandatos de configuración

Para ver la sintaxis del mandato instrumentServer, escriba el mandato sin argumentos:

AIX, HP-UX, Linux, Solaris:

./instrumentServer.sh

Windows:

instrumentServer

Ejemplos:

En una máquina que no ejecute Windows, para configurar un servidor IBM WebSphere Application Server V5.x denominado server1, instalado en el directorio /opt/WebSphere/AppServer (sin seguridad):

./instrumentServer.sh -install -type IBM -serverName server1 -serverHome /opt/WebSphere/AppServer -serverVersion 5

En una máquina que no ejecute Windows, para configurar un servidor WebSphere Application Server V6.0 denominado server2, instalado en el directorio /opt/WebSphere/AppServer, con el nombre de perfil profile1 y la seguridad habilitada:

./instrumentServer.sh -install -type IBM -serverName server2 -serverHome /opt/WebSphere/AppServer 
      -profileName default -user myUserId -password myPassword -serverVersion 6

En una máquina que no ejecute Windows, para configurar un servidor BEA WebLogic (con las especificaciones que se indican):

./instrumentServer.sh -install -type BEA -serverName server1 -serverHome /opt/bea/weblogic81 
      -domain mydomain -domainPath /opt/bea/weblogic81/mydomain -javaHome /opt/bea/jdk141_02 
      -nodeManagedHost hostname.xyz.com -nodeManagedPort 7001 -adminServer my_server
      -startScript /opt/bea/weblogic81/mydomain/startManagedWeblogic.sh

En una máquina que ejecute Windows, para configurar un servidor WebSphere Application Server V5.1 denominado my_Server, instalado en C:\Archivos de programa\was-5.1, con la seguridad habilitada:

instrumentServer -install -type IBM -serverName my_Server -serverHome "C:\Archivos de programa\was5.1" 
      -user myUserId -password myPassword -serverVersion 5

En una máquina que ejecute Windows, para configurar un servidor BEA WebLogic (con las especificaciones que se indican):

instrumentServer -install -type BEA -serverName server1 -serverHome C:\bea\weblogic81 
      -domain mydomain -domainPath C:\bea\weblogic81\mydomain -javaHome C:\bea\jdk141_02 
      -nodeManagedHost localhost -nodeManagedPort 7001 -adminServer my_server
      -startScript C:\bea\weblogic81\mydomain\startManagedWeblogic.cmd

Inicio y detención de la infraestructura de recopilación de datos

La infraestructura de recopilación de datos debe iniciarse para recopilar datos de rendimiento de las aplicaciones y las pruebas que se están ejecutando.

Al iniciar la infraestructura de recopilación de datos, se inicia el componente de Agent Controller; es importante detener otras instancias de Agent Controller antes de iniciar la infraestructura de recopilación de datos. Por este motivo, si está utilizando Rational Performance Tester, debe iniciar la infraestructura de recopilación de datos (en la máquina local) antes de iniciar Rational Performance Tester (que, de lo contrario, inicia Agent Controller).

En las plataformas que lo admitan, las entradas se realizarán en el menú de inicio principal (por ejemplo, el menú Inicio de Windows) para iniciar y detener la infraestructura de recopilación de datos. Por ejemplo, en Windows, pulse Inicio > Programas > IBM Rational > IBM Rational Software Development Platform > Iniciar la infraestructura de recopilación de datos o Detener la infraestructura de recopilación de datos.

O bien, para iniciar la infraestructura de recopilación de datos:

  1. Vaya al subdirectorio rpa_prod/rpa_comp dentro del directorio de instalación de infraestructura de recopilación de datos.
  2. Ejecute ./start_DCI.bat/sh.

Nota para la recopilación de datos de servicios en WebSphere Application Server: inicie la infraestructura de recopilación de datos antes de iniciar WebSphere Application Server. De lo contrario, no se recopilarán datos del servicio web. Si no le fuera posible reiniciar el servidor después de iniciar la infraestructura de recopilación de datos, puede forzar la reconexión al motor de ARM inhabilitando y, a continuación, habilitando ARM a través de JMX o la consola administrativa.

Para detener la infraestructura de recopilación de datos:

  1. Vaya al subdirectorio rpa_prod/rpa_comp dentro del directorio de instalación de infraestructura de recopilación de datos.
  2. Ejecute ./stop_DCI.bat/sh.

Sugerencia para la resolución de problemas en HP-UX: si tiene problemas para iniciar el componente del agente ARM de la infraestructura de recopilación de datos en HP-UX, es posible que la máquina tenga una limitación de configuración que impide que el agente ARM se inicie correctamente. Compruebe los siguientes parámetros de configuración del kernel y asegúrese de que son, como mínimo, tan grandes como los valores dados:

sema 1
semaem 16384
semmap 4098
semmni 4096
semmns 8192
semmnu 4092
semmsl 2048
semume 512
semvmx 32767

Estos parámetros de configuración del kernel están relacionados con la utilización del semáforo en el sistema. Consulte la documentación del sistema HP-UX o póngase en contacto con un administrador del sistema para obtener instrucciones detalladas sobre la modificación de los parámetros de configuración del kernel. De forma alternativa, si no desea actualizar la configuración del kernel, puede editar el archivo tapm_ep.cfg, que se encuentra en el directorio de instalación de la infraestructura de recopilación de datos. En este archivo, encontrará dos parámetros:

IPCAppToEngSize=500
IPCEngToAppSize=500

Cambie estos valores por:

IPCAppToEngSize=50
IPCEngToAppSize=50

El efecto secundario de este cambio es una reducción potencial del rendimiento de la recopilación de datos.

Adición de más sistemas principales a la infraestructura de recopilación de datos

Tras instalar (y probablemente cuando esté utilizando) la infraestructura de recopilación de datos, podrá añadir más sistemas principales a la lista de acceso realizando lo siguiente:

  1. Ejecute el mandato SetConfig en el directorio de instalación de la recopilación de datos, dentro del subdirectorio bin.
  2. Así se leerán sus valores actuales y se le solicitarán otros nuevos.
  3. Cuando aparezca la solicitud de los sistemas principales, escriba CUSTOM.
  4. A continuación, especifique una lista separada por comas de los sistemas principales que desea añadir. Esta lista se añadirá a la configuración actual.

Desinstalación de la infraestructura de recopilación de datos

Nota: Si desinstala la infraestructura de recopilación de datos en una máquina que también incluye un producto de Rational Software Development Platform como Rational Performance Tester, Rational Application Developer o Rational Software Architect, se eliminará Agent Controller o el componente de recopilación de datos instalado por ese producto. Si desea utilizar Agent Controller o la recopilación de datos con el producto después de desinstalar la infraestructura de recopilación de datos del kit de herramientas, debe volver a instalarla utilizando los procedimientos de instalación de ese producto.

Asimismo, si va a desinstalar un producto de Rational Software Development Platform que ha instalado Agent Controller, como Rational Application Developer o Rational Performance Tester, se eliminará este componente de la infraestructura de recopilación de datos y se inhabilitará. Deberá volver a instalar la infraestructura de recopilación de datos.

Desconfiguración del servidor de aplicaciones

Antes de desinstalar la infraestructura de recopilación de datos, debe desconfigurar los servidores de aplicaciones configurados para trabajar con esta. Para desconfigurar un servidor:

  1. Abra una línea de mandatos y vaya al directorio rpa_prod debajo del directorio de instalación de la infraestructura de recopilación de datos.
  2. La utilidad de configuración, que también se utiliza para desconfigurar servidores, se denomina instrumentServer.sh (instrumentServer.bat en Windows). Escriba el nombre del mandato sin argumentos para ver los detalles de sintaxis para el mandato.
  3. Escriba el nombre de mandato con el argumento -uninstall y el resto de argumentos utilizados para configurarlo originalmente. Por ejemplo, en Windows, para desinstalar un servidor de instancia WebSphere Application Server V5.1 denominado my_Server, instalado en C:\Archivos de programa\was-5.1, con la seguridad habilitada:
    instrumentServer -uninstall -type IBM -serverName my_Server -serverHome "C:\Archivos de programa\was5.1" 
          -user miIDusuario -password miContraseña -serverVersion 5

    Consulte los ejemplos de configuración para ver otros ejemplos de lo que fueron los argumentos de la configuración original. Nota: Todos los servidores configurados se listan en el archivo serverConfig.xml.

    Nota: Si ha desinstalado el servidor o ha eliminado la instancia de servidor sin desconfigurarla, el programa de utilidad instrumentServer seguirá pensando que existe, pero no podrá contactarla para desconfigurarla. Esto bloqueará el proceso de desinstalación de la infraestructura de recopilación de datos. Para resolverlo, añada el argumento -force al mandato instrumentServer. Esto eliminará la línea correspondiente en serverConfig.xml sin tener que contactar con el servidor que falta para desconfigurarlo. Para el mismo ejemplo anterior:

    instrumentServer -uninstall -force -type IBM -serverName my_Server -serverHome "C:\Archivos de programa\was5.1" 
          -user miIDusuario -password miContraseña -serverVersion 5
  4. Reinicie el servidor.

Repita los pasos de desconfiguración para cada servidor configurado para la recopilación de datos. Cuando haya acabado, el archivo serverConfig.xml estará vacío y se efectuará la desinstalación de la recopilación de datos.

A continuación, desinstale la infraestructura de recopilación de datos.

Desinstalación de la infraestructura de recopilación de datos en Windows o Linux

Para desinstalar la infraestructura de recopilación de datos, utilice el gestor de instalación del sistema operativo (por ejemplo, en Windows, en la ventana Agregar o quitar programas). Busque el programa IBM Rational Data Collection Infrastructure V6.1 y elimínelo.

Si el sistema operativo no dispone de gestor de instalación, para desinstalar la infraestructura de recopilación de datos:

  1. Detenga la infraestructura de recopilación de datos.
  2. Vaya al subdirectorio dci_prod/_uninst dentro del directorio de instalación de infraestructura de recopilación de datos.
  3. Ejecute ./uninstall.bin.
  4. Siga las instrucciones del asistente.

Desinstalación de la infraestructura de recopilación de datos en AIX, HP-UX o Solaris

Para desinstalar la infraestructura de recopilación de datos:

  1. En el directorio de infraestructura de recopilación de datos, ejecute el mandato siguiente para detener la infraestructura de recopilación de datos:
    rpa_prod/rpa_comp/rpa_boot_stop_unix.sh
  2. Desinstale cada componente de recopilación de datos ejecutando los mandatos siguientes en el orden que se muestra. Después de cada mandato, confirme la intención de desinstalar el componente y espere hasta que finalice la desinstalación. Nota: Para cualquiera de los siguientes, puede utilizar -silent, en lugar de -console, para ejecutar la desinstalación silenciosa.

    /dci_prod/_uninst/uninstall.bin -console
    /IBM_Agent_Controller/_uninst/uninstall.bin -console -W prod_id_uninstall.value=dci
    /tau_prod/_uninst/uninstall.bin -console
    /rpa_prod/tivoli_comp/_uninst/uninstall.bin -console

Resolución de problemas

Si tiene problemas para desinstalar la infraestructura de recopilación de datos, asegúrese de que los agentes se han detenido antes de realizar la desinstalación.

Si, después de desinstalar la infraestructura de recopilación de datos, WebSphere Application Server ya no se inicia, realice los pasos siguientes para solucionarlo:

  1. Abra el archivo server.xml de <inst_was>/config/cells/<celda>/nodes/<nodo>/servers/<servidor>/ (<servidor> probablemente sea server1 y <celda> y <nodo>, el nombre de la máquina).

  2. Localice la línea siguiente: genericJvmArgs="<alguna cadena de caracteres>"

  3. Sustitúyala por una cadena de caracteres vacía: genericJvmArgs=""

Ahora debería ser capaz de iniciar el servidor de aplicaciones.


Copyright y avisos