Instalación y administración de servidores AnswerBook2

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