Guía de instalación de Sun Java Enterprise System 5 para Microsoft Windows

Capítulo 8 Resolución de problemas

Este capítulo proporciona consejos para resolver problemas de instalación y desinstalación de Sun Java^TM Enterprise System (Java ES).

Este capítulo incluye los siguientes apartados:

Métodos generales de resolución de problemas

Este apartado contiene directrices generales para identificar el origen de los problemas. Se tratan los siguientes temas:

Conectividad de red

No es posible realizar la instalación de Java ES en un host independiente. Es preciso disponer de un host conectado a una red para instalar Java ES.

Comprobación de la conexión con Directory Server

Si instala un componente que depende de Directory Server, los problemas pueden deberse a uno de los siguientes motivos:

Ha especificado una contraseña y un Id. de usuario incorrectos para Directory Server.
Ha especificado un puerto LDAP incorrecto.
Directory Server no está accesible.

Se ha elegido la opción Configurar manualmente después de la instalación, debe asegurarse de que Directory Server esté en ejecución antes de configurar los productos que dependan de este componente.

Comprobación de la configuración posterior a la instalación

Si se produce algún problema al iniciar los componentes, compruebe si los procesos descritos en el Capítulo 5, Finalización de la configuración posterior a la instalación, se han realizado correctamente.

Comprobación de los recursos y la configuración

Las siguientes cuestiones relacionadas con el host pueden provocar problemas de instalación:

Actualizaciones. ¿Ha instalado los Service Pack recomendados?
Espacio en el disco. ¿Cómo está particionado el disco y a qué particiones se dirigen los directorios de instalación?

Puertos de red. Durante la configuración, debe especificar los números de puerto de los componentes de Java ES. Compruebe si la información de los puertos es correcta de la forma siguiente:
- Examine los números de puerto estándar del archivo.
- Revise el archivo de registro de resumen para comparar sus preferencias con las opciones estándar. ¿Ha escrito mal algún número de puerto o ha asignado a algún servidor un puerto que normalmente se usa para otro?
- Utilice el comando netstat -a para ver el puerto que se está usando actualmente en el sistema. ¿Ha asignado un número de puerto que ya estaba en uso?
- Compruebe si ha escrito los nombres de host y de dominio correctos durante la configuración.

Consulte Requisitos de sistema para verificar si se han cumplido todos los requisitos antes de proceder a la instalación.

Comprobación de los medios de distribución

Si está realizando la instalación desde un DVD, examine el soporte para comprobar si está sucio o dañado. Los discos sucios pueden originar problemas de instalación.

Comprobación de los archivos de registro de los componentes

Si se produce un problema al iniciar un componente, compruebe el archivo de registro correspondiente. Muchos de los archivos de registro se citan en el apartado Información para resolver problemas de los componentes.

Comprobación de los archivos del registro de la instalación

Si se produce algún problema durante la instalación o la desinstalación, examine el archivo de registro correspondiente en el directorio %TEMP%/SunJavaES.log .

%TEMP% el la carpeta TEMP definida por el usuario en ese sistema.

El examen de los archivos de registro generados por los programas de instalación y desinstalación (junto con el registro de configuración de Java ES) puede ayudar a detectar la causa de los problemas.

Para examinar los archivos de registro de la instalación

Revise el archivo de resumen de la instalación, que proporciona una descripción general de lo que se instaló y configuró. Este archivo se encuentra en dir-instalación-JavaEs\Summary.txt. Si se ha producido un problema, averigüe qué componente lo ha causado. Si se han producido varios problemas, identifique el primero.

Revise los archivos de registro detallados.
1. Busque el primer error o advertencia que se haya producido e intente solucionarlo. En ocasiones, la solución de un error supone la solución de sucesivos errores que parecían inconexos.
2. Busque el nombre del componente o el paquete que produjo el problema.
3. Revise los registros de configuración. Los registros de configuración se encuentran en los directorios de instalación de los componentes. Examine Summary.txt para localizar la ubicación exacta de los archivos de registro de los componentes.
4. Examine el archivo de registro de la instalación para buscar problemas de instalación o desinstalación. Consulte los registros de configuración para buscar problemas relacionados con la configuración.

Eliminación de los archivos y el directorio

Para impedir la posibilidad de sobreescribir archivos personalizados tales como los archivos de configuración editados, los componentes de Java ES 5 no pueden instalarse en sus respectivos directorios de instalación si contienen archivos.

Si está reinstalando Java ES 5, asegúrese de que los directorios de instalación estén vacíos. Si no lo están, guarde los archivos en otro lugar y vuelva a realizar la instalación.

Verificación de las contraseñas

El programa de instalación necesita que introduzca una serie de contraseñas para los componentes. Si está instalando diferentes componentes en distintos hosts, asegúrese de introducir las contraseñas adecuadas en cada host.

Para solucionar problemas con las contraseñas, es posible que deba desinstalar y volver a instalar. Si fracasa la desinstalación, consulte Fallo de la instalación debido a archivos dejados en la desinstalación.

Verificación de las dependencias entre componentes

Algunos componentes están sometidos a interdependencias en el momento de la instalación. Los problemas que atañan a un componente pueden afectar a otros componentes. Para averiguar si hay interdependencias incumplidas, familiarícese con la información del apartado Comprobación de las dependencias. A continuación, haga lo siguiente:

Revise el archivo de resumen y los archivos de registro para saber qué producto relacionado es el que ha fallado. Estos fallos pueden servir como indicación para determinar qué debe arreglar primero.
Compruebe si ha especificado la información de conexión correcta. Por ejemplo:
- ¿La información que proporcionó al configurar Directory Server concuerda con la información que proporcionó para los componentes que utilizan Directory Server?
- ¿Proporcionó la misma información de Access Manager para Portal Server o Portal Server Secure Remote Access que para Access Manager?

Problemas de instalación

En este apartado se describen los siguientes problemas que pueden producirse durante la instalación:

Fallo de la instalación debido a archivos dejados en la desinstalación

Si falla un proceso de desinstalación, puede que componentes que deberían haberse eliminado permanezcan en el host. En ese caso, debe eliminar tales componentes manualmente antes de reinstalar Java ES.

Para eliminar archivos residuales

Es preciso realizar los pasos siguientes antes de volver a instalar Java ES tras el fallo del proceso de instalación o configuración.

Asegúrese de que todos los servicios de Java ES se hayan detenido y eliminado del menú Panel de control > Herramientas administrativas > Servicios.

Borre cualquier carpeta de Sun instalada con anterioridad. Si no puede borrar la carpeta, reinicie el sistema y bórrela.

Compruebe si queda alguna entrada relacionada con los servicios. Si queda alguna entrada de servicio en la página Servicios, deberá borrarla para limpiar el registro. Las posibles entradas figuran en la tabla siguiente.

Nombre del componente	Entrada de servicio
Contenedor de agentes común	Common Agent Container 2 (#CRC:default)
HADB	`HADB4.4MgmtAgent`
Message Queue	`MQ3.7UR1_Broker`
Portal Server	`sra.gateway.instanciasra` `sra.netletproxy.instanciasra` `sra.rewriterproxy.instanciasra`
WebAdminServer	`https-admserv70`
Web Console	Web Console 3.0.2 console
Web Proxy Server	Sun Java System Socks Server 4.0.4 (`server1`) Sun Java System Web Proxy Server 4.0.4 (`proxy-server1`) Sun Java System Web Proxy Server 4.0.4 Administration Server
Web Server	Sun Java System Web Server 7.0 (`https-hostname.domainname`) Sun Java System Web Server 7.0 Administration Server

Limpie el registro.

Borre HKEY_LOCAL_MACHINE\Software\Sun Microsystems\Entsys5\Installer.

Si realiza alguno de los pasos anteriores, reinicie el sistema antes de proceder a la instalación.

Errores del programa de instalación de Windows

La instalación puede fracasar debido al siguiente error del programa de instalación de Windows.

Error 1603 - Fatal error during installation: el error se produce si el host de destino es Windows 2003 Enterprise Server con SP1. Las causas posibles del error se mencionan en http://support.microsoft.com/default.aspx?scid=kb;en-us;834484.

En ese caso, necesita instalar la actualización para Windows 2003 Enterprise Server SP1, que encontrará en:http://support.microsoft.com/kb/898715.

Fallo de la instalación silenciosa

Si ha modificado el archivo de respuestas, es posible que haya introducido errores. Por ejemplo, compruebe lo siguiente:

¿Están definidos todos los parámetros de los hosts locales y se han definido con valores coherentes?
¿Ha escrito correctamente las mayúsculas y minúsculas de los valores de los parámetros?
¿Ha borrado algún parámetro necesario y no ha introducido otro para sustituirlo?
¿Son válidos todos los números de puertos y están sin asignar?

Resuelva el problema y vuelva a generar el archivo de respuestas según se indica en Creación de un archivo de respuestas.

Fallo de la instalación silenciosa: el archivo de respuestas es incompatible o está dañado.

Si está utilizando un archivo de respuestas creado en la misma plataforma en la que se usa, el problema puede deberse a un error desconocido de archivo dañado. Trate de generar un nuevo archivo de respuestas y reinstalarlo.

Para obtener más información, consulte Creación de un archivo de respuestas.

Errores externos inesperados

Éstas son las posibles causas de errores externos:

Fallo de la alimentación o del sistema.
Pulsar Control-C o interrumpir el programa de instalación desde el administrador de tareas para detener su proceso.

Si el fallo se produjo durante el proceso de instalación o configuración, es probable que se haya efectuado una instalación parcial. Ejecute el programa de desinstalación. Si falla el programa de desinstalación, consulte Fallo de la instalación debido a archivos dejados en la desinstalación.

No se encuentra la base de datos de Portal Server después de reiniciar Java DB

Este problema puede producirse al implementar un ejemplo de Application Server que utilice Java DB después de ejecutar el comando predeterminado de Application Server para reiniciar Java DB (asadmin stop-databsse y, a continuación, asadmin start-database ). Ya no se podrá acceder a los ejemplos de Portal Server.

Solución: Utilice una de estas alternativas:

No detenga Java DB.
Si se ha detenido Java DB, reinicie esta aplicación con el siguiente comando, lo que permitirá que la base de datos de Application Server se cree en una ubicación alternativa:

asadmin start-database --dbhome Dir-Instalación-JavaES \portal\data\derby
Si quiere que la base de datos permanezca en la ubicación predeterminada, inicie una segunda instancia de Java DB utilizando un puerto que no sea el predeterminado y, a continuación, especifique ese puerto en los ejemplos de Application Server. Por ejemplo, escriba:

asadmin start-database --dbport 1528

Información para resolver problemas de los componentes

Este apartado contiene varias sugerencias para resolver problemas relativos a los componentes y referencias a documentación útil.

Sugerencias para resolver problemas de Access Manager

Tabla 8–1 Sugerencias para resolver problemas de Access Manager


Tema	Detalles
Archivo de configuración	`base-AccessManager\Config\AMConfig.properties`
Archivos de registro y depuración	Directorio del archivo de registro: `base-AccessManager\Logs` Directorio del archivo de depuración: `base-AccessManager\Debug`
Modo de depuración	Consulte el documento Sun Java System Access Manager Developer’s Guide.

Sugerencias para resolver problemas de Application Server

Tabla 8–2 Sugerencias para resolver problemas de Application Server


Tema	Detalles
Archivos de registro	Directorio del archivo de registro: `Dir-Instalación-JavaES\appserver\domain\dominio1 \logs` Nombre de archivo del registro de mensajes: `server.log`, por cada instancia del servidor.
Archivos de configuración	Directorio del archivo de configuración: `base-ApplicationServer \Config.`
Resolución de problemas	Consulte el documento Sun Java System Application Server Enterprise Edition Troubleshooting Guide.

Sugerencias para resolver problemas de Directory Server

Tabla 8–3 Sugerencias para resolver problemas de Directory Server


Tema	Detalles
Archivos de registro	El archivo de registro de la instalación se encuentra en la carpeta `tmp`. Archivos de registro de configuración: `DirectoryServer-base.Amarcahora` `DirectoryServer-base.B marcahora` Para obtener más información sobre la administración de archivos de registro, consulte el documento Sun Java System Directory Server Administration Guide
Resolución de problemas	Consulte el documento Sun Java System Directory Server Administration Guide.

Consejos para resolver problemas de HADB

Tabla 8–4 Consejos para resolver problemas de HADB


Tema	Detalles
Archivos de registro	`dir-instalación-JavaES\Hadb\4.4.3-5\ma\ma.log`
Archivos de configuración	`HADB.properties` `mgt.cfg` Estos archivos están situados en el directorio `dir-instalación-JavaES\Hadb\4.4.3-5\lib\` .
Ubicación del ejecutable	`dir-instalación-JavaES\Hadb\4.4.3-5\bin\`
Resolución de problemas	Consulte el documento High Availability Session Store Administrator’s Guide.

Sugerencias para resolver problemas de Message Queue

Tabla 8–5 Sugerencias para resolver problemas de Message Queue


Tema	Detalles
Archivos de registro	Archivo de registro de instalación: `base-MessageQueue\var\instances\ nombre-instancia\log` Consulte el documento Sun Java System Message Queue 3.7 UR1 Administration Guide.
Resolución de problemas	Para resolver problemas de rendimiento, consulte el Capítulo 11, Analyzing and Tuning a Message Service de Sun Java System Message Queue 3.7 UR1 Administration Guide. La resolución de problemas de Message Queue se trata en el Capítulo 12, Troubleshooting Problems de Sun Java System Message Queue 3.7 UR1 Administration Guide, y en el foro de Message Queue, en: `http://swforum.sun.com/jive/forum.jspa?forumID=24`. También hay otros artículos disponibles en la base de datos de conocimiento, situada en `http://developers.sun.com/prodtech/msgqueue/reference/techart/index.html`.

Sugerencias para resolver problemas de la consola de supervisión

Tabla 8–6 Sugerencias para resolver problemas de la consola de supervisión


Tema	Detalles
Archivos de configuración	Para la consola de supervisión: `base-MonitoringConsole\WEB-INF\web.xml` Para la estructura de supervisión: `dir-instalación-JavaES\share\mfwk\config\mfwk.properties`
Archivos de registro	Para la consola de supervisión: `dir-instalación-JavaES\share\webconsole\console\console_config_log` Para la estructura de supervisión: `dir-instalación-JavaES\share\mfwk\logs`
Resolución de problemas	Si no puede acceder a la consola de supervisión, consulte Solución de problemas de la Consola de supervisión de Guía de supervisión de Sun Java Enterprise System 5. Para resolver problemas de la consola de supervisión, consulte Solución de problemas de Monitoring Framework de Guía de supervisión de Sun Java Enterprise System 5.

Sugerencias para resolver problemas de Portal Server Secure Remote Access

Tabla 8–7 Sugerencias para resolver problemas de Portal Server Secure Remote Access


Tema	Detalles
Archivos de registro de depuración	Los archivos de registro de depuración de la puerta de enlace de Portal Server se encuentran en el directorio `base-PortalServer\debug`. Nota – Los archivos de registro de los servicios de Portal Server (como NetFile) se encuentran en el directorio `base-AccessManager\debug` cuando el registro se activa desde la consola de administración de Access Manager.

Sugerencias para resolver problemas de Portal Server

Tabla 8–8 Sugerencias para resolver problemas de Portal Server


Tema	Detalles
Archivos de registro y depuración	Los archivos de registro de Portal Server son: Registros de psadmin: `base-PortalServer\data\admin` Registros de configuración: `base-PortalServer\data\config` Registros de instancias de Portal Server: `base-PortalServer \data\portals\id-portal\logs\ id-instancia`

Sugerencias para resolver problemas de Service Registry

Tabla 8–9 Sugerencias para resolver problemas de Service Registry


Tema	Detalles
Archivos de registro	Archivo de registro predeterminado:`base-ServiceRegistry\domains\registry\logs\server.log` Para obtener más información, consulte el documento Service Registry 3.1 Administration Guide.
Resolución de problemas	Consulte el documento Service Registry 3.1 Administration Guide.

Sugerencias para resolver problemas de Web Proxy Server

Tabla 8–10 Sugerencias para resolver problemas de Web Proxy Server


Tema	Detalles
Archivos de registro	Archivos de registro predeterminados: `dir-instalación-JavaES\ nombre-instancia\config\logs\errors` `dir-instalación-JavaES\ nombre-instancia\config\logs\access` `dir-instalación-JavaES\ nombre-admin\config\logs\errors` `dir-instalación-JavaES\ nombre-admin\config\logs\access` Para obtener más información, consulte el documento Sun Java System Web Proxy Server Administration Guide.
Resolución de problemas	Consulte el documento Sun Java System Web Proxy Administration Guide.

Sugerencias para resolver problemas de Web Server

Tabla 8–11 Sugerencias para resolver problemas de Web Server


Tema	Detalles
Archivos de registro	Los archivos de registro de errores (`errors`) y accesos (`access`) están situados en el directorio `base-WebServer\WebServer_Install.log` . El archivo `errors` muestra todos los errores detectados por el servidor. El archivo `access` recopila la información acerca de las peticiones de acceso al servidor y las respuestas enviadas por éste. Para obtener más información, consulte el documento Sun Java System Web Server 7.0 Administrator’s Guide.
Resolución de problemas	Consulte el documento Sun Java System Web Server 7.0 Troubleshooting Guide.
Directorio de archivos de configuración	`base-WebServer\https-instance-name\config`

Información adicional sobre la resolución de problemas

La siguiente información incluida en esta guía también resulta útil para resolver problemas:

El Capítulo 5, Finalización de la configuración posterior a la instalación, contiene instrucciones para configurar los componentes después de la instalación.
El Capítulo 6, Verificación de los componentes de Java ES instalados, contiene instrucciones para comprobar los componentes de Java ES que se han instalado.
El capítulo Capítulo 7, Desinstalación de los componentes de Java ES, contiene información sobre los problemas que podrían surgir al desinstalar el software de Java ES.