WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Sistemas operativos: AIX, HP-UX, Linux, Solaris, Windows

Resolución de problemas de instalación

Si detecta un problema al instalar WebSphere ESB, puede usar una serie de actividades y herramientas para resolver el problema.

Por qué y cuándo se efectúa esta tarea

Utilice este tema para diagnosticar posibles problemas cuando la instalación no se realice correctamente. El programa de instalación registra los indicadores siguientes de éxito al final del archivo de registro primario, que puede encontrarse en raíz_instalación/logs/wbi/log.txt en plataformas Linux y UNIX o raíz_instalación\logs\wbi\log.txt en plataformas Windows: Si el resultado es INSTCONFPARTIALSUCCESS o INSTCONFFAILED, continúe analizando el problema siguiendo estos pasos:

Pasos para realizar esta tarea

  1. Si el proceso de instalación ha mostrado mensajes de error, revise el apartado Mensajes de error: instalación, creación y aumento de perfiles para obtener una explicación.

    Si el mensaje corresponde a alguno de los que se describe, corrija el problema, limpie las partes instaladas y vuelva a intentar la instalación.

    Para obtener detalles sobre la desinstalación de partes que todavía están instaladas, antes de la reinstalación, consulte el apartado Preparación para una nueva instalación tras una desinstalación con errores.

  2. Determine si la instalación de WebSphere Application Server Network Deployment se ha realizado correctamente. Si la instalación de WebSphere ESB no se ha realizado correctamente, primero compruebe si hay errores en raíz_instalación/logs/log.txt en plataformas Linux y UNIX o raíz_instalación\logs\log.txt en plataformas Windows para determinar si la instalación de WebSphere Application Server Network Deployment se ha realizado correctamente.
    • Si la instalación de WebSphere Application Server Network Deployment ha fallado, revise la información de resolución de problemas de instalación para WebSphere Application Server Network Deployment. Utilice la información detectada para corregir el problema antes de intentar la reinstalación de WebSphere ESB.
    • Si la instalación de WebSphere Application Server Network Deployment se ha realizado correctamente y la instalación de WebSphere ESB ha fallado, utilice la información de resolución de problemas siguiente para corregir los problemas.
  3. Compruebe en los archivos de registro de instalación de WebSphere ESB si hay errores después de la instalación.

    Consulte el apartado Archivos de registro para conocer los nombres, las ubicaciones y las descripciones de los diferentes archivos de registro que se crean. Compruebe los archivos de registro en esta secuencia:

    Plataformas LINUX Plataformas UNIX En plataformas Linux y UNIX:
    1. raíz_instalación/logs/wbi
    2. %tmp% si no se encuentran archivos en raíz_instalación/logs/wbi
    3. raíz_instalación/logs/wasprofile/wasprofile_create_ nombre_perfil.log o raíz_instalación/logs/wasprofile/wasprofile_augment_ nombre_perfil.log. Si ha realizado una instalación completa, que crea un servidor autónomo llamado default, el valor de nombre_perfil será default.
    4. Los archivos de registro o rastreo adicionales que generan acciones de instalación. Busque en raíz_instalación/logs/wbi archivos de rastreo generados durante el proceso de instalación (o desinstalación). Busque en raíz_instalación/logs los que ha generado la creación o el aumento de perfiles, donde raíz_perfil representa la ubicación de instalación de los perfiles de WebSphere ESB (de forma predeterminada, raíz_instalación/profiles/nombre_perfil en plataformas Linux y UNIX). Estos archivos están destinados principalmente para que los utilice el servicio de soporte técnico de IBM.
    Para plataformas Windows En plataformas Windows:
    1. raíz_instalación\logs\wbi
    2. %tmp% si no se encuentran archivos en raíz_instalación\logs\wbi
    3. raíz_instalación\logs\wasprofile\wasprofile_create_ nombre_perfil.log o raíz_instalación\logs\wasprofile\wasprofile_augment_ nombre_perfil.log. Si ha realizado una instalación completa, que crea un servidor autónomo llamado default, el valor de nombre_perfil será default.
    4. Los archivos de registro adicionales que generan acciones de instalación. Busque en raíz_instalación\logs\wbi archivos de rastreo generados durante el proceso de instalación (o desinstalación). Busque en raíz_instalación\logs los que ha generado la creación o el aumento de perfiles, donde raíz_perfil representa la ubicación de instalación de los perfiles de WebSphere ESB (de forma predeterminada, raíz_instalación\profiles\nombre_perfil en plataformas Windows). Estos archivos están destinados principalmente para que los utilice el servicio de soporte técnico de IBM.
  4. Si no hay información en los registros de instalación, utilice el parámetro -log con un archivo de respuestas.
    Determinados sucesos pueden impedir que InstallShield para multiplataformas (ISMP) inicie el asistente de instalación. Un suceso de este tipo es que no hay suficiente espacio de disco para iniciar el asistente de instalación, por ejemplo. Si la instalación falla y no hay información en los registros de instalación, utilice el parámetro -log con un archivo de respuestas para registrar entradas de sucesos que provocan que el programa ISMP no pueda iniciar el asistente de instalación. Esto funcionará con cualquiera de los archivos de respuestas siguientes:
    • responsefile.esb.txt
    • responsefile.pcaw.esb.standAloneProfile.txt
    • responsefile.pcaw.esb.dmgrProfile.txt
    • responsefile.pcaw.esb.managedProfile.txt

    Para obtener más información sobre archivos de respuestas, consulte el apartado Instalación silenciosa de WebSphere ESB.

    Deberá copiar un archivo de respuestas del CD 1 de WebSphere ESB en la unidad de disco duro del sistema para usarlo. La sintaxis del mandato install para registrar tales sucesos es la que se muestra en los ejemplos siguientes (las vías de acceso al archivo de respuestas y al archivo de registro, así como el nombre real del archivo de respuestas, pueden diferir):

    Para plataformas AIX En plataformas AIX:
    install -options "/usr/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/usr/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    Plataformas LINUX Plataformas Solaris En plataformas HP-UX, Linux y Solaris:
    install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    Para plataformas Windows En plataformas Windows:
    install.exe -options "C:\IBM\WebSphere\silentFiles\myresponsefile.txt" 
                -silent -log # !C:\IBM\WebSphere\silentFiles\log.txt  @ALL
  5. Determine si un script de configuración anómalo ha provocado el problema de instalación.

    El archivo raíz_instalación/logs/wbi/instconfig.log en plataformas Linux y UNIX o raíz_instalación\logs\wbi\instconfig.log en plataformas Windows indica problemas de configuración que pueden impedir el correcto funcionamiento del producto. Busque la serie action failed para encontrar el nombre del script de configuración que ha fallado.

  6. Verifique no existan archivos en el directorio raíz_instalación/classes.

    En ocasiones, el soporte de IBM coloca en cola trabajo para los clientes y proporciona arreglos de prueba o depuración. Una ubicación común de los arreglos es el directorio raíz_instalación/classes.

    De forma predeterminada, el directorio raíz_instalación/classes se selecciona primero en la vía de acceso de clase de WebSphere ESB para permitir alterar temporalmente otras clases.

    La colocación de un arreglo en el directorio permite verificar que el arreglo resuelve su problema. Después de verificar que el arreglo resuelve el problema, debe suprimir el arreglo del directorio raíz_instalación/classes para devolver el sistema a un estado operativo.

    Si no elimina estos arreglos del directorio raíz_instalación/classes, puede sufrir errores.

  7. Desinstale el producto, limpie los archivo de registro u otros elementos que puedan haber quedado y vuelva a realizar la instalación después de activar el rastreo si los archivos de registro de errores no contienen bastante información para determinar la causa del problema.
    • Proporcione los registros stdout y stderr en la ventana de la consola añadiendo el parámetro -is:javaconsole al mandato install:
      • Plataformas LINUX Plataformas UNIX En plataformas Linux y UNIX:
        install -is:javaconsole
        Capture el flujo en un archivo con los mandatos siguientes:
        install -is:javaconsole > nombre_archivo_captura.txt 2>&1
      • Para plataformas Windows En plataformas Windows:
        install.exe -is:javaconsole
        Capture el flujo en un archivo con los mandatos siguientes:
        install.exe
        -is:javaconsole > unidad:\nombre_archivo_captura.txt
    • Capture información adicional en un registro que elija con la opción -is:log nombre_archivo.
    • Active el registro de instalación adicional pasando el parámetro -W Setup.product.install.logAllEvents="true" al mandato install:
      • Plataformas LINUX Plataformas UNIX En plataformas Linux y UNIX:
        install -W Setup.product.install.logAllEvents="true"
      • Para plataformas Windows En plataformas Windows:
        install.exe -W Setup.product.install.logAllEvents="true"
  8. Si ha creado correctamente un perfil de servidor, utilice la consola Primeros pasos o el método de línea de mandatos para iniciar el servidor.
    Inicie la consola Primeros pasos para un nodo determinado (donde raíz_perfil representa la ubicación de instalación del perfil de WebSphere ESB (de forma predeterminada, raíz_instalación/profiles/nombre_perfil en plataformas Linux y UNIX y raíz_instalación\profiles\nombre_perfil en plataformas Windows):
    • Plataformas LINUX Plataformas UNIX En plataformas Linux y UNIX: raíz_perfil/firststeps/esb/firststeps.sh
    • Para plataformas Windows En plataformas Windows: raíz_perfil\firststeps\esb\firststeps.bat
    Inicie el servidor desde la línea de mandatos:
    1. Cambie al directorio raíz_perfil/bin en el perfil.
    2. Inicie el proceso de servidor.
      • Plataformas LINUX Plataformas UNIX En plataformas Linux y UNIX: ./startServer.sh nombre_servidor
      • Para plataformas Windows En plataformas Windows: startServer.bat nombre_servidor
  9. Verifique que el servidor se inicie y se cargue correctamente buscando un proceso Java en ejecución y el mensaje Open for e-business en los archivos SystemOut.log y SystemErr.log.

    Si no hay procesos Java o si este mensaje no aparece, examine los mismos registros para errores varios. Corrija los errores y reinténtelo.

    Puede buscar los archivos SystemOut.log y SystemErr.log en los siguientes directorios específicos de la plataforma:
    • Plataformas LINUX Plataformas UNIX En plataformas Linux y UNIX: raíz_perfil/logs/nombre_servidor
    • Para plataformas Windows En plataformas Windows: raíz_perfil\profiles\logs\nombre_servidor
  10. Utilice la consola Primeros pasos y el método de línea de mandatos para detener el servidor nombre_servidor, si está en ejecución, para iniciar el gestor de despliegue si existe.
    Para detener nombre_servidor desde la línea de mandatos:
    • Plataformas LINUX Plataformas UNIX En plataformas Linux y UNIX: raíz_perfil/bin/stopServer.sh nombre_servidor
    • Para plataformas Windows En plataformas Windows: raíz_perfil\bin\stopServer.bat nombre_servidor
    Si habilita la seguridad, especifique los parámetros -user y -password del mandato.
    Para iniciar el gestor de despliegue desde la línea de mandatos:
    • Plataformas LINUX Plataformas UNIX En plataformas Linux y UNIX: raíz_perfil/bin/startManager.sh
    • Para plataformas Windows En plataformas Windows: raíz_perfil\bin\startManager.bat
  11. Verifique que el servidor se inicie y se cargue correctamente buscando un proceso Java en ejecución y el mensaje Server dmgr open for e-business en el archivo raíz_perfil/logs/server_name/SystemOut.log.
    Plataformas LINUX Plataformas UNIX En plataformas Linux y UNIX: abra una ventana de mandatos y emita el mandato top para ver una pantalla de procesos en ejecución. Si el mandato top no está disponible en su sistema, utilice el mandato ps:
    ps -ef | grep java

    Para plataformas Windows En plataformas Windows: pulse Ctrl+Alt+Suprimir y escriba T para abrir el Administrador de tareas. Pulse la ficha Procesos y la cabecera de columna Nombre de imagen para ordenar la lista por nombre de imagen. Busque los procesos llamados java.exe.

    Si no hay procesos Java o si este mensaje no aparece, examine los mismos registros para errores varios. Corrija los errores e inténtelo de nuevo para iniciar el gestor de despliegue.

Qué hacer a continuación

Para obtener información actual disponible para el soporte de IBM sobre problemas conocidos y su resolución, consulte la página de soporte de IBM WebSphere ESB.


Task topic

Condiciones de uso | Evalúe esta página

Icono de fecha y horaÚltima actualización: 2 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\doc\tins_trouble.html

(C) Copyright IBM Corporation 2005. Reservados todos los derechos.
Este centro de información está basado en tecnología Eclipse. (http://www.eclipse.org)