La herramienta de recopilador recopila información sobre la instalación de WebSphere Application Server y la empaqueta en un archivo archivador Java™ (JAR) que puede enviar al soporte al cliente de IBM® para ayudarle a determinar y analizar el problema. La
información del archivo JAR incluye registros cronológicos, archivos de propiedades, archivos
de configuración, datos del sistema operativo y Java, y la presencia y el nivel de cada
software de prerequisito.
Antes de empezar
El tipo de información que recopila no es algo que utilice la mayoría de gente. De hecho, la herramienta Recopilador empaqueta su salida en un archivo JAR. IBM incluye la herramienta Recopilador en el código del producto, junto con otras herramientas que ayudan a capturar la información que desea proporcionar cuando informa de un problema. La herramienta Recopilador forma parte de una estrategia para hacer lo más fácil y completos posibles los informes de problemas.
Hay dos fases para utilizar la herramienta de recopilador. La primera fase ejecuta la herramienta de recopilador en el producto WebSphere Application Server y genera un archivo archivador
a Java (JAR). El equipo del servicio de soporte de IBM realiza la segunda fase, que consiste en analizar el archivo JAR (Java Archive) que genera el programa de recopilador. El programa de recopilador se ejecuta hasta el final cuando crea el archivo JAR, a pesar de los errores que pueda encontrar como, por ejemplo, si faltan archivos o si los mandatos no son válidos. La
herramienta de recopilador recopila tantos datos del archivo JAR como
sea posible.
La herramienta de recopilador es una aplicación
Java que requiere un JRE6 (Java SE
Runtime Environment 6 para su ejecución.
Acerca de esta tarea
La herramienta está dentro del directorio raíz de la instalación para WebSphere Application Server, Network Deployment. Pero ejecute la herramienta desde un directorio de trabajo que haya creado fuera del directorio raíz de la instalación. Este procedimiento describe ambos pasos y todos los demás pasos para utilizar la herramienta e informar sobre los resultados de la ejecución de la herramienta.
Hay dos formas de ejecutar la herramienta de recopilador. Ejecute la
herramienta de recopilador para recopilar datos de resumen o
para atravesar el sistema para reunir archivos relevantes y resultados de
mandatos.
La herramienta de recopilador genera un archivo JAR (Java Archive) con la información necesaria para determinar y solucionar el problema. La opción de resumen de recopilador genera
una recopilación ligera de información de la versión y de otro tipo, que resulta muy útil
cuando se informa del problema por primera vez al servicio de soporte de IBM. Ejecute la herramienta Recopilador desde el usuario root o el usuario administrador
para acceder a los archivos de sistema que contienen información sobre los valores del
kernel, paquetes instalados y otros datos vitales.
La herramienta recopila información sobre el perfil predeterminado, si no utiliza el parámetro opcional para identificar otro perfil.
Procedimiento
Ejecute la herramienta del recopilador. - Inicie la sesión en el sistema como root o como miembro de un grupo de administrador en una plataforma Windows.
- Compruebe que en la vía de acceso esté disponible Java 1.2.2 o superior.
El programa de recopilador requiere que se ejecute el código Java. El programa de recopilador también recopila datos sobre IBM Developer Kit, Java Technology Edition donde se ejecuta.
Si existen varios Developer Kits en el sistema, verifique que el que utiliza el producto WebSphere Application Server es el que está en la vía de acceso del programa del recopilador.
Si el Developer Kit que utiliza WebSphere Application Server no está disponible, coloque otro
Developer Kit en la vía de acceso del programa recopilador, para que pueda recopilar todo menos los datos sobre el Developer
Kit que está utilizando WebSphere Application Server, Network Deployment.
- Verifique que toda la información necesaria esté en la vía de acceso utilizada por el programa de recopilador y que no esté ejecutando el programa desde dentro del directorio raíz de instalación del producto WebSphere Application Server.
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
Compruebe que la vía de acceso contiene los directorios del sistema siguientes:- /bin
- /sbin
- /usr/bin
- /usr/sbin
Incluya regedit en la vía de acceso.
- Cree un directorio de trabajo en el que pueda iniciar el programa de recopilador.
- Cree el directorio de trabajo en el directorio activo.
- Ejecute el programa de recopilador especificando el mandato completo desde la línea de mandatos del directorio de trabajo.
- Ejecute el mandato siguiente desde Qshell:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
raíz_servidor_aplic/bin/collector.sh
![[Windows]](../images/windows.gif)
raíz_servidor_aplic\bin\collector.bat
Utilice el mandato sin ningún parámetro adicional para recopilar una copia de los datos de perfil y de los datos de cada servidor del nodo, y para almacenar los datos en un archivo de salida JAR único.
- Utilice el mandato siguiente para recopilar datos de un perfil específico que podría no ser el perfil predeterminado.
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
raíz_servidor_apl/bin/collector.sh -profileName nombre_perfil
![[Windows]](../images/windows.gif)
raíz_servidor_aplic\bin\collector.bat -profileName nombre_perfil
- Opcional: Puede ejecutar la herramienta de recopilador
desde el directorio bin de un perfil en lugar del directorio
raíz_servidor_aplic/bin/.
Debería obtener la misma salida si ejecuta la herramienta de
recopilador desde el directorio bin de
raíz_perfil que si
lo hace desde
raíz_servidor_aplic.
La ejecución del mandato desde el perfil también ejecuta el archivo
setupCmdLine.bat/sh en el directorio bin del perfil. Este
archivo establece un parámetro de entorno que el recopilador utiliza para determinar
qué datos de perfil debe recopilar.
Ejecute la herramienta del recopilador. - Inicie una sesión en el servidor con un perfil de usuario que tenga la autoridad especial de todos los objetos (*ALLOBJ).
- Cree un directorio de trabajo en el que pueda iniciar el programa de recopilador.
- Ejecute el mandato STRQSH desde la línea de mandatos de CL para
preparar la ejecución del programa de recopilador.
- Cree el directorio de trabajo en el directorio activo.
- Ejecute el mandato siguiente desde Qshell:
cd workingDirectory
El programa de recopilador graba su archivo JAR de salida en el directorio actual. El programa también crea y suprime un número de archivos temporales en el directorio actual.
Si crea un directorio de trabajo para ejecutar el programa de recopilador
evitará colisiones de nombres y facilitará la limpieza. No puede ejecutar la herramienta de recopilador en un directorio bajo el directorio raíz de la instalación para WebSphere Application Server, Network Deployment.
- Ejecute el programa de recopilador especificando el mandato completo desde la línea de mandatos del directorio de trabajo.
- Ejecute el mandato siguiente desde Qshell:
raíz_servidor_apl/bin/collector
- Utilice el mandato siguiente para recopilar datos de un perfil específico que podría no ser el perfil predeterminado.
- Ejecute el mandato siguiente desde Qshell:
raíz_servidor_apl/bin/collector -profileName nombre_perfil
- Opcional: También puede ejecutar la herramienta de
recopilador desde el directorio raíz del perfil en lugar del directorio
raíz_servidor_aplic/bin/.
Ejecute el mandato siguiente desde Qshell:
raíz_perfil/bin/collector
Debería obtener la misma salida si ejecuta la herramienta de
recopilador desde el directorio bin de
raíz_perfil que si
lo hace desde
raíz_servidor_aplic.
La ejecución del mandato desde el perfil también ejecuta el archivo setupCmdLine en el directorio bin del perfil.
Este
archivo establece un parámetro de entorno que el recopilador utiliza para determinar
qué datos de perfil debe recopilar.
Para ejecutar este mandato para el gestor de despliegue,
por ejemplo, emita el mandato siguiente:
raíz_servidor_aplic/profiles/dmgr/bin/collector
donde
dmgr es el nombre de perfil del gestor de despliegue.
Resultados
El programa recopilador crea el archivo de registro cronológico Collector.log y un archivo JAR de salida en el directorio activo.
El nombre del archivo JAR está formado por los nombres de host, de célula, de nodo y de perfil.
nombre_host-nombre_célula-nombre_nodo-nombre_perfil.JAR
El archivo de registro cronológico Collector.log es uno de los archivos recopilados en el archivo nombre_host-nombre_célula-nombre_nodo-nombre_perfil.JAR.
Qué hacer a continuación
Envíe el archivo
nombre_host-nombre_célula-nombre_nodo-nombre_perfil.JAR al servicio de soporte de IBM para su análisis.