Esta sección explica cómo resolver los problemas conocidos con el producto AnswerBook2 e incluye la información siguiente:
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 No se encuentra el archivo 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 Imposible agregar colección 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". |
Esta sección proporciona una lista de los mensajes de error de AnswerBook2 y cómo actuar.
Significado: ha fallado un intento de utilizar la secuencia answerbook2_admin o ejecutar la página Administración de Answerbook2 desde el panel frontal de CDE porque no hay ningún servidor de documentación en este sistema.
Cómo actuar: vaya el sistema en que está el servidor de documentación y utilice el mismo procedimiento o bien introduzca el URL para el servidor de documentación que desea administrar en su navegador.
Significado: ha fallado un intento de utilizar la secuencia answerbook2 o de ejecutar el visualizador cliente desde el panel frontal de CDE porque no hay definido ningún servidor de documentación predeterminado.
Cómo actuar: el visualizador cliente utiliza el siguiente procedimiento para encontrar un servidor de documentación predeterminado:
Si está definida la variable de entorno AB2_DEFAULTSERVER, el visualizador AnswerBook2 se ejecuta mediante el URL definido por esa 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 ha iniciado la función AnswerBook2 es un servidor de documentación, el visualizador AnswerBook2 intenta acceder al URL: http://localhost:8888
Si hay registrado un servidor AnswerBook2 con FNS (Federated Naming Service), el visualizador AnswerBook2 utiliza el URL del servidor registrado.
Significado: ha fallado un intento de ejecutar la secuencia ab2cd porque la ruta de acceso proporcionada no era válida.
Cómo actuar: escriba el comando desde el directorio en que está la secuencia ab2cd o introduzca la ruta de acceso completa a tal secuencia.
Significado: ha intentado ejecutar la secuencia ab2cd desde un sistema no admitido.
Cómo actuar: el software del servidor de documentación necesita el sistema operativo Solaris 2.5.1, Solaris 2.6, o Solaris 7 que se ejecute en un sistema basado en SPARC o Intel.
Significado: ha intentado ejecutar la secuencia ab2 cd desde un sistema que está definido con un entorno nacional o codificación no admitidos.
Cómo actuar: el software del servidor de documentación admite los siguientes entornos nacionales y codificaciones: C, en_*, es, es_*, fr, fr_*, it, it_*, sv, sv_*, de, de_*, ja, japanese, ja_JP.PCK, ko, zh, zh_TW, zh_TW.BIG5 y *[Uu][Tt][Ff]-8*.
Significado: un usuario administrador ha escrito mal la contraseña de administración.
Cómo actuar: vuelva a escribir la contraseña. Si falla de nuevo, compruebe que está intentando administrar el servidor para el que este administrador y contraseña son válidos.
Significado: se ha proporcionado un comando de ab2cd pero no se incluyeron las opciones correctas.
Cómo actuar: verifique que ha introducido el comando y las opciones de forma correcta. Para más información sobre las opciones, véase la página de comando man ab2cd.