Capítulo 4 Resolución de problemas de AnswerBook2
Esta sección explica cómo resolver los problemas conocidos con el producto AnswerBook2 e incluye la información siguiente:
Errores de servidor
La tabla siguiente muestra problemas que pueden producirse al servir documentación en línea.
Tabla 4-1 Problemas posibles del servidor|
Si usted ve... |
Pruebe... |
Vea también... |
||
|---|---|---|---|---|
|
Edite el archivo /usr/lib/ab2/dweb/data/config/dwhttpd.cfg y cambie el nombre de sistema por nombresistema.dominio. Por ejemplo, en lugar de la línea siguiente:
|
Si el problema continúa, desactive la función de delegados en el navegador de web. |
|||
|
Errores de navegador que indican que el servidor de documentación no responde |
Si el servidor de documentación no responde, reinícielo. |
Para más información sobre cómo parar y arrancar el servidor, consulte "Inicio y paro del servidor de documentación". |
||
|
404 Not Found cuando se intenta acceder al servidor de documentación |
Se está ejecutando un proceso de servidor; sin embargo, se ha eliminado su software. Reinstale el software de servidor. |
Para obtener información sobre cómo instalar el software, véase "Instalación del software de AnswerBook2". |
||
|
La página Biblioteca sólo muestra la barra de navegación y ninguna colección de documentos |
Compruebe que el archivo de plantilla de las colecciones (/usr/lib/ab2/dweb/data/config/ab2_collections.template) no contenga ningúna entrada vacía o duplicada. |
Si no se soluciona el problema al corregir el archivo de plantilla, es posible que necesite reinstalar las colecciones de documentos o el software de servidor. Para obtener información sobre cómo instalar el software, véase "Instalación del software de AnswerBook2". |
||
|
Aparece texto en rojo y la palabra "DEFECTO" en un manual (o varios) |
El código fuente del manual contiene etiquetas de marcado no reconocidas por AnswerBook2 y la variable de entorno AB2_DEBUG está establecida a "1" en el servidor. |
Para desactivar la visualización de defectos, establezca el indicador AB2_DEBUG a "0", pare el servidor e inícielo de nuevo. Póngase en contacto con el proveedor del manual para solucionar sus marcas. |
||
|
No es posible acceder a las funciones de administración del servidor de documentación |
El servidor de documentación AnswerBook2 utiliza mecanismos de control de acceso para identificar qué usuarios pueden llevar a cabo las funciones administrativas. Las herramientas de administración de AnswerBook2 permiten que el administrador de documentos para la máquina del servidor pueda agregar y eliminar usuarios de administración al servidor y cambiar sus contraseñas. |
Para agregar o eliminar usuarios de administración del servidor, véase "Control de acceso administrativo". Si necesita acceder a otro servidor, póngase en contacto con el administrador de documentos para ese servidor. |
||
|
No es posible llevar a cabo los comandos de administración desde la página Administración de AnswerBook2 (interfaz de navegador) |
Algunas funciones no actúan desde la página Administración de AnswerBook2 debido a cuestiones de permisos. Intente realizar la misma función desde la interfaz de línea de comandos de ab2admin. |
Para obtener información sobre la interfaz de línea de comandos, véase Apéndice A. |
||
|
La función Explorar colecciones instaladas localmente no muestra las colecciones de documentos que estén instaladas en un punto de montaje local |
Compruebe que el directorio en que se instalaron las colecciones tenga establecido el acceso de lectura para otros. |
|
||
|
Ha agregado una colección AnswerBook1, pero los usuarios no la ven en sus bibliotecas |
Esto significa que hay algún problema con los datos de la colección en el archivo ab_cardcatalog. Compruebe que la información de /var/log/ab2/catalog/ab1_cardcatalog sea correcta. |
|
||
|
Aparece el mensaje Failed to add collection al intentar agregar una colección mediante la página Administración de AnswerBook2 |
Compruebe que la ruta de acceso a los archivos collinfo o ab_cardcatalog de la colección sea correcta. |
|
||
|
El uso del comando restart para reiniciar el servidor de documentación no fue satisfactorio o no se obtuvieron los resultados previstos |
En algunos casos, el comando restart no funciona correctamente. Utilice los comandos stop y start en su lugar. |
Para más información, véase "Inicio y paro del servidor de documentación". |
||
|
Las colecciones de documentos parecen estar en mal estado y es necesario reinstalarlas |
Utilice la función ab2admin -o del_coll o Suprimir colecciones de la lista en la página Administración de AnswerBook2 para eliminar estas colecciones de la base de datos del servidor de documentación. A continuación, utilice pkgrm para eliminarlas del servidor antes de instalar los paquetes nuevos. |
Para más información sobre cómo eliminar las colecciones, véase "Supresión de colecciones de AnswerBook2". Para más información sobre cómo agregar colecciones, véase "Adición de colecciones nuevas". |
Mensajes de error de AnswerBook2
Este apartado enumera los mensajes de error de AnswerBook2 y cómo responder a ellos.
- Authentication failed, try again.
-
Significado: Un usuario administrador ha escrito mal la contraseña de administración.
Cómo responder: Vuelva a escribir la contraseña. Si vuelve a ser no satisfactoria, asegúrese de que está intentando administrar el servidor para el que son válidos este administrador y contraseña.
- Cannot find local AnswerBook2 server to administer.
-
Significado: El intento de utilizar la secuencia answerbook2_admin o ejecutar la página Administración de AnswerBook2 desde el Panel frontal de CDE no ha sido satisfactorio porque no hay ningún servidor de documentación en este sistema.
Cómo responder: Vaya al sistema donde está el servidor de documentación y utilice el mismo procedimiento o escriba el URL del servidor de documentación que desea administrar en su navegador.
- Cannot talk to alternate server nombre_servidor.
-
Significado: El intento de contactar con el servidor alternativo especificado no ha sido satisfactorio porque no existe el nombre o el puerto del servidor o porque está bloqueado el acceso a los servidores externos a la red de su empresa.
Cómo responder: Verifique que el nombre y el puerto del servidor alternativo son correctos. De ser así, verifique que el servidor alternativo esté dentro del cortafuegos de su empresa. Si el servidor alternativo que está intentando agregar está fuera del cortafuegos de su empresa, es posible que la seguridad de la red le impida agregarlo como servidor alternativo.
- No AnswerBook2 documentation server was found.
-
Significado: El intento de utilizar la secuencia answerbook2 o de ejecutar el visualizador cliente desde el Panel frontal de CDE no ha sido satisfactorio porque no hay definido ningún servidor de documentación.
Cómo responder: El visualizador cliente utiliza el método siguiente para encontrar un servidor de documentación predeterminado:
-
Si está definida la variable de entorno AB2_DEFAULTSERVER, se ejecuta el visualizador de AnswerBook2 mediante el URL definido por tal variable. Por ejemplo, es posible que su archivo .cshrc contenga la línea siguiente:
setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888/
-
Si la máquina desde la que inició la función AnswerBook2 es un servidor de documentación, el visualizador de AnswerBook2 intenta acceder al URL: http://localhost:8888
-
Si hay registrado un servidor AnswerBook2 con FNS (Servicio de asignación de nombres federado), el visualizador de AnswerBook2 utiliza el URL del servidor registrado.
-
- © 2010, Oracle Corporation and/or its affiliates