Sun Java Enterprise System 2003Q4 Installation Guide |
Cap�tulo 9
Resoluci�n de problemas de instalaci�nEste cap�tulo proporciona consejos para resolver problemas de instalaci�n. Incluye los siguientes apartados:
Lista de tareas para la resoluci�n de problemasEste apartado proporciona ideas para encontrar el origen de un problema. Incluye los siguientes temas:
Comprobaci�n de los archivos del registro de instalaci�n
Si se produce un problema durante la instalaci�n o la desinstalaci�n, compruebe el archivo de registro adecuado.
Los archivos de registro del programa de instalaci�n est�n ubicados en el directorio /var/sadm/install/logs. La siguiente tabla muestra los archivos de registro junto con sus nombres. La mayor�a de los registros tienen dos versiones:
- La versi�n A del archivo de registro, que almacena la conclusi�n.
- La versi�n B del archivo de registro, que incluye mensajes de registro m�s detallados.
Algunos productos de componentes guardan archivos de registro en el mismo directorio, entre ellos, Administration Server, Application Server, Directory Server, Portal Server e Identity Server. Para obtener m�s informaci�n sobre los archivos de registro de los productos de componentes, consulte “Informaci�n sobre los productos de componentes para la resoluci�n de problemas”.
Si desea utilizar los archivos de registro para resolver problemas, intente identificar el primer problema que se produjo. Con frecuencia, el primer problema conlleva problemas sucesivos. Utilice la siguiente secuencia:
Los archivos de registro pueden darle pistas que determinen los siguientes pasos, como se ve a continuaci�n:
Comprobaci�n de archivos de registro de los productos de componentes
Si se produce un problema al iniciar un producto de componente, compruebe el archivo de registro correspondiente. Muchos de los archivos de registro de productos de componentes se muestran en “Informaci�n sobre los productos de componentes para la resoluci�n de problemas”.
Verificaci�n de las dependencias de los productos
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 comprobar las interdependencias no satisfechas, vaya familiariz�ndose con la informaci�n que aparece en “Dependencias de los productos de componentes”. A continuaci�n, compruebe lo siguiente:
Si desea hacer una consulta r�pida de las dependencias de productos de componentes espec�ficos, consulte “Informaci�n sobre los productos de componentes para la resoluci�n de problemas”.
Adem�s de las interdependencias de componentes, algunos componentes dependen de la existencia de paquetes de Solaris que podr�an no estar instalados en el equipo, lo que provocar�a fallos en la instalaci�n. Consulte el apartado de sobre los requisitos de software de las notas de la versi�n para obtener m�s informaci�n.
Comprobaci�n de los recursos y las preferencias
Las siguientes cuestiones relacionadas con el host pueden provocar problemas de instalaci�n.
- Actualizaciones. �Ha aplicado las actualizaciones recomendadas (parches)?
- Espacio en disco. �C�mo est� particionado el disco y a qu� particiones se dirigen los directorios de instalaci�n? Los directorios de instalaci�n /var/sadm y /etc/opt, o los directorios no predeterminados que especifique, necesitan suficiente espacio en disco.
- Puertos de red. Durante la configuraci�n, debe proporcionar los n�meros de puerto para los productos de componentes de Java Enterprise System. Compruebe lo siguiente:
- Examine los n�meros de puerto est�ndar en el archivo /etc/services.
- Revise el archivo de registro de resumen para comparar sus preferencias con las opciones est�ndar. �Escribi� mal un n�mero de puerto o estableci� un servidor para un puerto que se usa normalmente para otro?
- Utilice el comando netstat -a para ver el puerto que se est� usando actualmente en el sistema. �Asign� un n�mero de puerto que ya estaba en uso?
- Direcciones IP. Durante la configuraci�n, debe especificar las direcciones IP. Compruebe que escribi� las direcciones IP correctas. A�n quedan algunos asuntos por solucionar:
Ejecuci�n de procedimientos de verificaci�n
Si est� resolviendo problemas durante el inicio de los programas, compruebe que los procesos de componentes est�n activos y luego ejecute los procedimientos de verificaci�n que aparecen en el Cap�tulo 8, “Configuraci�n posterior a la instalaci�n e inicio”.
Comprobaci�n de los soportes de distribuci�n
Si ejecuta la instalaci�n desde un DVD o un CD, �est� el soporte sucio? Los discos sucios pueden originar problemas de instalaci�n.
Comprobaci�n de la conectividad de Directory Server
Si ejecuta la instalaci�n de un componente que depende de Directory Server, los problemas pueden deberse a uno de los siguientes motivos:
Los modos interactivos del programa de instalaci�n comprueban la conectividad de Directory Server durante la instalaci�n, pero el modo silencioso no lo hace. Si realiza la instalaci�n silenciosa cuando Directory Server no est� disponible, puede suceder lo siguiente:
Eliminaci�n de archivos y directorios de Web Server
Para evitar que se sobrescriban archivos personalizados como, por ejemplo, archivos de configuraci�n modificados, no debe instalar Web Server en un directorio que contenga archivos.
Si est� reinstalando Web Server, compruebe que los directorios de instalaci�n est�n vac�os. Si no lo est�n, guarde los archivos en otra ubicaci�n y vuelva a ejecutar la instalaci�n.
Comprobaci�n de contrase�as
El programa de instalaci�n necesita que introduzca una serie de contrase�as para los productos de componentes. Si est� instalando diferentes componentes en distintos equipos, debe asegurarse de introducir las contrase�as adecuadas en cada equipo.
Para solucionar problemas con las contrase�as, es posible que deba desinstalar y volver a instalar. Si la desinstalaci�n falla, consulte “Eliminaci�n de instalaciones parciales”.
Uso de la herramienta prodreg para examinar y desinstalar componentes
Si ha instalado componentes pero tiene problemas y no puede ni reinstalar ni desinstalar, la herramienta prodreg puede resultarle �til. Esta herramienta proporciona una interfaz gr�fica para el registro de productos Solaris, as� como una interfaz sencilla tanto para componentes como para paquetes y, adem�s, reemplaza las utilidades pkg.
Para ejecutar prodreg, escriba el nombre del comando en la l�nea de comandos. Para obtener m�s informaci�n, consulte la p�gina al respecto del manual sobre prodreg(1).
Eliminaci�n de instalaciones parcialesSi el proceso de desinstalaci�n no se completa, puede que queden componentes o paquetes. En ese caso, debe eliminar los componentes o paquetes manualmente para volver a instalar. Puede percatarse de este problema de las siguientes formas:
Para eliminar una instalaci�n parcial
- Utilice el siguiente comando para saber qu� paquetes est�n parcialmente instalados.
pkginfo -p
La salida de comando muestra cualquier paquete instalado parcialmente. Para utilizar los nombres de paquetes que se le devuelvan, consulte el Ap�ndice D, “Listado de paquetes instalables” para saber a qu� componente pertenecen los paquetes.
- Elimine los componentes o paquetes.
- Con Solaris 9, utilice la herramienta prodreg.
La herramienta prodreg controla los componentes basados en paquetes en los equipos. Puede ver los componentes y sus paquetes, junto con informaci�n completa en la que se incluyen las interdependencias. Puede utilizar la herramienta prodreg para desinstalar componentes y eliminar paquetes con total seguridad. Una vez que haya eliminado un componente con la herramienta prodreg, podr� reinstalarlo.
- Con Solaris 8, utilice el comando pkgrm.
El comando pkgrm requiere que se eliminen los componentes paquete a paquete. Este comando no actualiza el registro de productos. En funci�n de lo que haya sucedido, puede restaurar el archivo de registro de productos que guard� o puede modificarlo manualmente para que no haga referencia a los componentes que se han eliminado.
Para modificar el archivo de registro de productos, abra el archivo /var/sadm/install/productregistry. Este archivo XML describe cada componente. La descripci�n de cada componente comienza con la etiqueta <compid> y termina con la etiqueta </compid>. Borre la entrada completa del componente.
- Elimine el directorio de instalaci�n de Web Server si lo hubiera.
- Ejecute el programa de instalaci�n de nuevo.
La siguiente tabla muestra los archivos y directorios de los productos de componentes que debe eliminar.
Ejemplos de problemas y sus solucionesEste apartado contiene explicaciones y sugerencias para la resoluci�n de problemas de ejemplo.
Problemas a la hora de configurar IBM WebSphere como el contenedor Web de Identity Server
Motivo. Puede que WebSphere no se est� ejecutando o que se haya especificado un valor para WebSphere que no coincida con la configuraci�n original de WebSphere.
Sugerencia. En primer lugar, compruebe que WebSphere se est� ejecutando.
A continuaci�n, compruebe los valores para estos dos campos del programa de instalaci�n:
Utilice las herramientas de WebSphere para comprobar la configuraci�n, aseg�rese de que coincide con los valores que est� introduciendo y vuelva a intentarlo.
Otra soluci�n ser�a crea nuevas instancias para las entidades de WebSphere y volver a intentarlo, tal y como se indica a continuaci�n:
- Utilice adminclient.sh para iniciar la consola de WebSphere.
- Cree una nueva instancia de host virtual y un nuevo nombre de instancia para el servidor de aplicaciones.
- Haga clic en la entrada que hay bajo “Nodos” (el nombre de host habitual) y seleccione “Regenerar complemento de WebServer”.
El proceso guarda las nuevas entradas en el archivo de configuraci�n plugin que el programa de instalaci�n comprueba para obtener los nombres legales.
- Vuelva al programa de instalaci�n e introduzca los valores que acaba de crear.
Se produjo un error externo inesperado
Motivo. Pudo producirse un corte de luz o un fallo del sistema, o pudo pulsar CTRL+C para detener el proceso de instalaci�n.
Sugerencia. Si el fallo se produjo durante los procesos de instalaci�n o de configuraci�n, es probable que se haya efectuado una instalaci�n parcial. Ejecute el programa de desinstalaci�n. Si el programa de desinstalaci�n falla, siga las instrucciones que aparecen en “Eliminaci�n de instalaciones parciales”.
Parece que el programa de instalaci�n gr�fico no responde
Motivo. A veces, el programa de instalaci�n crea una imagen en pantalla antes de que dicha imagen est� lista para la entrada. No puede hacer clic repetidamente en “Siguiente” en el asistente de instalaci�n, sino que tiene que esperar.
Sugerencia. El bot�n que representa la elecci�n predeterminada incluye un rect�ngulo azul. Este rect�ngulo suele aparecer despu�s del propio bot�n. Espere hasta que vea el rect�ngulo antes de hacer clic en cualquier bot�n.
La instalaci�n silenciosa falla y aparece un error de archivo de estado incompatible o corrupto
Motivo. Si est� utilizando un archivo de estado que fue creado en la misma plataforma en la que lo usa, el problema puede deberse a un error desconocido de archivo corrupto.
Si est� utilizando un archivo de estado creado en una plataforma o versi�n diferente, el problema se debe a que los archivos de estado hay que ejecutarlos en la misma plataforma en la que se crearon. Si cre� el archivo de estado en Solaris 9, no puede utilizarlo en Solaris 8, al igual que si lo cre� en la plataforma x86, no puede usarlo en Sparc.
Sugerencia. Si cre� el archivo de estado en la misma plataforma en la que lo utiliza, genere uno nuevo y reinstale.
Si la plataforma en la que cre� el archivo de estado no es la misma en la que lo utiliza, solucione el problema creando un nuevo ID adecuado a la plataforma para el archivo. Para obtener instrucciones sobre este proceso, consulte “Creaci�n de un ID adecuado para la plataforma”.
La instalaci�n silenciosa falla
Motivo. Si modific� el archivo de estado, pudo introducir errores. Por ejemplo, compruebe lo siguiente:
- �Est�n definidos todos los par�metros de los hosts locales con valores consistentes?
- �Escribi� correctamente las may�sculas y min�sculas de los valores de los par�metros?
- �Borr� un par�metro requerido y no introdujo otro para sustituirlo?
- �Son v�lidos todos los n�meros de puertos y est�n sin asignar?
Sugerencia. Vuelva a generar el archivo de estado. Utilice para ello el programa de instalaci�n en el modo gr�fico y guarde los valores, tal y como se describe en “Generaci�n de un archivo de estado”.
Informaci�n sobre los productos de componentes para la resoluci�n de problemasEste apartado contiene varios consejos acerca de los productos de componentes, junto con referencias a documentaci�n �til.
La siguiente informaci�n adicional incluida en esta gu�a resulta �til para la resoluci�n de problemas:
- El Cap�tulo 2, “Preparaci�n de la instalaci�n” incluye informaci�n sobre las interdependencias de los componentes. Consulte la Tabla 2-4 para obtener m�s informaci�n.
- Cap�tulo 8, “Configuraci�n posterior a la instalaci�n e inicio”. Consulte el apartado “Inicio y detenci�n de los productos de componentes”. Este apartado incluye instrucciones para cada componente para iniciar, detener y comprobar los procesos del componente.
Administration Server
Archivos de registro
Directorio del registro de instalaci�n:
/var/sadm/install/logs
Archivos de registro de configuraci�n:
Administration_Server_install.Atimestamp
Administration_Server_install.BtimestampPara obtener m�s informaci�n acerca de las opciones del inicio de sesi�n, consulte Sun ONE Server Console 5.2 Server Management Guide (http://docs.sun.com/doc/816-6704-10). Consulte el cap�tulo 6, “Administration Server Basics”.
Informaci�n de resoluci�n de problemas
Consulte Sun ONE Server Console 5.2 Server Management Guide (http://docs.sun.com/doc/816-6704-10). Consulte el cap�tulo 1, “Installing Sun ONE Directory Server”.
Application Server
Archivos de registro
Directorio del archivo de registro:
Nombres del archivo de registro:
Directorio de registro de la instancia de Application Server (ubicaci�n predeterminada para la primera instancia que se cree):
Nombre de archivo del registro de mensajes:
Directorio de registro de Application Server (ubicaci�n predeterminada para el dominio administrativo creado inicialmente):
Archivo de registro de Administration Server:
Archivos de configuraci�n
Directorio de los archivos de configuraci�n: /var
Calendar Server
Archivos de registro
Servicio de administraci�n (csadmind): admin.log
Servicio de bases de datos distribuidas (csdwpd): dwp.log
Servicio HTTP (cshttpd): http.log
Servicio de notificaci�n ( csnotifyd): notify.logDirectorio de registro predeterminado: /var/opt/SUNWics5/logs
Para obtener m�s informaci�n, consulte Sun ONE Calendar Server Administrator’s Guide (http://docs.sun.com/doc/816-6708-10). Consulte el cap�tulo 3, “Managing Calendar Server”.
Archivo de configuraci�n
/opt/SUNWics5/cal/config/ics.conf
Modo de depuraci�n
Para utilizar el modo de depuraci�n, un administrador de Calendar Server debe establecer el par�metro de configuraci�n logfile.loglevel en el archivo ics.conf. Por ejemplo:
logfile.loglevel = "debug"
Para obtener m�s informaci�n, consulte Sun ONE Calendar Server Administrator’s Guide (http://docs.sun.com/doc/816-6708-10). Consulte los cap�tulos siguientes:
Informaci�n de resoluci�n de problemas
Consulte Sun ONE Calendar Server Administrator’s Guide (http://docs.sun.com/doc/816-6708-10). Consulte los cap�tulos siguientes:
- Cap�tulo 3, “Managing Calendar Server”, para obtener informaci�n sobre la resoluci�n de problemas con las utilidades start-cal y stop-cal.
- El cap�tulo 10, “Setting Up a High Availability (HA) Configuration”, para obtener informaci�n sobre la resoluci�n de problemas de una configuraci�n de gran disponibilidad.
Directory Proxy Server
Registro
Archivo de registro predeterminado: dps_svr_base/dps-hostname/logs/fwd.log
Para obtener m�s informaci�n, consulte Directory Proxy Server Administration Guide (http://docs.sun.com/doc/816-6391-10). Consulte el cap�tulo 10, “Configuring and Monitoring Logs”.
Resoluci�n de problemas
Consulte Directory Proxy Server Administration Guide (http://docs.sun.com/doc/816-6391-10). Consulte el ap�ndice B, “Directory Proxy Server FAQ, Features, and Troubleshooting”.
Directory Server
Archivos de registro
Archivo del registro de instalaci�n:
/var/sadm/install/log
Archivos de registro de configuraci�n:
Directory_Server_install.Atimestamp
Directory_Server_install.BtimestampPara obtener m�s informaci�n acerca de la administraci�n de los archivos de registro, consulte Sun ONE Directory Server Administration Guide (http://docs.sun.com/source/816-6698-10/logs.html). Consulte el cap�tulo 12, “Managing Log Files”.
Para obtener informaci�n sobre la herramienta logconv.ps, que ayuda en el an�lisis de los registros de acceso, consulte Sun ONE Directory Server Resource Kit Tools Reference (http://docs.sun.com/doc/816-6400-10/logconv.html). Consulte el cap�tulo 24, “logconv.pl”.
Resoluci�n de problemas
Consulte Directory Server Installation and Tuning Guide (http://docs.sun.com/doc/816-6697-10). Consulte el cap�tulo 1, “Installing Sun ONE Directory Server”.
Identity Server
Archivo de configuraci�n
/opt/SUNWam/lib/AMConfig.properties
Modo de depuraci�n
Para obtener informaci�n, consulte Sun ONE Identity Server 6.1 Customization and API Guide (http://docs.sun.com/doc/816-6774-10). Consulte los apartados siguientes:
Instant Messaging
Documentaci�n �til
Consulte Instant Messaging Administrator’s Guide (http://docs.sun.com/doc/817-4113-10).
Message Queue
Archivos de registro
Consulte Sun ONE Message Queue Administrator’s Guide (http://docs.sun.com/doc/817-0354-10). Consulte los cap�tulos siguientes:
La resoluci�n de problemas de Sun ONE Message Queue est� disponible en el foro de MQ en: http://swforum.sun.com/jive/forum.jspa?forumID=24.
Est�n disponibles art�culos adicionales en la base de datos de soluciones, en http://developers.sun.com/prodtech/msgqueue/reference/techart/index.html.
Messaging Server
Documentaci�n para la resoluci�n de problemas
Consulte Sun ONE Messaging Server Administrator’s Guide (http://docs.sun.com/doc/816-6738-10).
Ubicaci�n del ejecutable
/opt/SUNWmsgsr/lib/
Portal Server
Archivos de registro y de depuraci�n
Portal Server utiliza los mismos archivos de registro y de depuraci�n que Identity Server. Los directorios correspondientes son:
Archivo de registro: /var/opt/SUNWam/logs
Archivo de depuraci�n: /var/opt/SUNWam/debugPara obtener informaci�n sobre la administraci�n de los archivos de registro y de depuraci�n de Portal Server, consulte Portal Server Administrator’s Guide, (http://docs.sun.com/doc/816-6748-10).
Los archivos de depuraci�n del escritorio de Portal Server son:
/var/opt/SUNWam/debug/desktop.debug
/var/opt/SUNWam/debug/desktop.dpadmin.debugPara obtener informaci�n sobre la administraci�n de estos archivos, consulte Portal Server Administration Guide. Consulte “Administering the Desktop Service”.
Las utilidades de l�nea de comandos dpadmin, par, rdmgr y sendrdm de Portal Server incluyen opciones para generar mensajes de depuraci�n. Las opciones se describen en Portal Server Administration’s Guide.
Portal Server, Secure Remote Access
Registros de depuraci�n
Los registros de depuraci�n de Portal Server se ubican en los siguientes directorios:
/var/opt/SUNWam/debug
/var/opt/SUNWps/debugLos registros de depuraci�n de la puerta de enlace de Portal Server se ubican en el siguiente directorio: /var/opt/SUNWps/debug
Software de Sun Cluster y Sun Cluster Agents
Para obtener informaci�n sobre el software de Sun Cluster y Sun ONE Agents para Sun Cluster, consulte Sun Cluster 3.1 Software Installation Guide, en http://docs.sun.com/doc/816-3388.
Web Server
Archivos de registro
Existen dos tipos de archivos de registro de Web Server: el archivo de registro errors y el archivo de registro access, ubicados los dos en el directorio /opt/SUNWwbsvr/server_root/https-server_name/logs.
El archivo de registro errors muestra todos los errores registrados por el servidor. El archivo de registro access recopila la informaci�n acerca de las peticiones al servidor y las respuestas que �ste env�a. Para obtener m�s informaci�n, consulte Sun ONE Web Server 6.1 Administrator’s Guide (http://docs.sun.com/doc/817-1831-10). Consulte el cap�tulo 10, “Using Log Files”.
Informaci�n de resoluci�n de problemas
Consulte Sun ONE Web Server 6.1 Installation and Migration Guide (http://docs.sun.com/doc/817-1830-10).
Directorio de archivos de configuraci�n
/opt/SUNWwbsvr/http-instance-name/config
Modo de depuraci�n
Est�n disponibles las siguientes opciones:
- Las salidas de los registros se pueden utilizar para realizar diagn�sticos y depuraciones. Puede establecer el valor del atributo loglevel del elemento LOG en el archivo /server_root/https-server_name/config/server.xml en uno de los siguientes valores: fine, finer o finest. Estos valores indican el nivel de detalle de los mensajes de depuraci�n, donde finest hace referencia al m�ximo nivel de detalle. Para obtener m�s informaci�n acerca del elemento LOG, consulte Sun ONE Web Server 6.1 Administrator’s Configuration File Reference (http://docs.sun.com/doc/817-1834-10).
- Se puede habilitar un indicador de depuraci�n para el inicio del contenedor Web del servidor en el modo de depuraci�n y as� poder adjuntar con Java Platform Debugger Architecture (depurador de JPDA). Para ello, establezca el valor del indicador jvm.debug del elemento JAVA en el archivo /server_root/https-server_name/config/server.xml como true. Para obtener m�s informaci�n, consulte Sun ONE Web Server 6.1 Administrator’s Configuration File Reference (http://docs.sun.com/doc/817-1834-10).
- El complemento de Sun ONE Studio 5, Standard Edition, habilita la depuraci�n de aplicaciones Web. Para obtener m�s informaci�n, consulte Sun ONE Web Server 6.1 Programmer’s Guide to Web Applications (http://docs.sun.com/doc/817-1833-10). Consulte el cap�tulo 7, “Debugging Web Applications”.