Instalación y administración de servidores AnswerBook2

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... 

Error de delegado en el navegador

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:


set ServerHost imaserver ;# 
Utilice esta línea:

set ServerHost imaserver.eng.sun.com ;#  
A continuación, reinicie el servidor de documentación.

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".

Mensajes de error de AnswerBook2

Esta sección proporciona una lista de los mensajes de error de AnswerBook2 y cómo actuar.

No puede encontrarse el servidor AnswerBook2 local que administrar.

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.

No se encontró ningún servidor de documentación AnswerBook2.

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:

  1. 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/
    

  2. 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

  3. Si hay registrado un servidor AnswerBook2 con FNS (Federated Naming Service), el visualizador AnswerBook2 utiliza el URL del servidor registrado.

Software de servidor AnswerBook2 no encontrado en la ruta de acceso %s.

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.

Arquitectura no admitida: %s.

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.

ab2cd no admite el entorno nacional %s.

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*.

Autenticación no satisfactoria, inténtelo de nuevo.

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.

Faltan opciones necesarias.

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.