Solaris 7: Biblioteca de instalación (Edición SPARC)

Capítulo 8 Acceso a la documentación en línea

Este capítulo explica cómo instalar y utilizar el producto AnswerBook2^TM para explorar, buscar e imprimir documentación en línea. Incluye la información siguiente:

Nota: el nombre de este producto es Solaris 7 pero el código y la ruta o el nombre de la ruta del paquete pueden utilizar Solaris 2.7 o SunOS 5.7 indistintamente. Siga siempre el código o ruta tal como se hayan escrito.

Introducción al producto AnswerBook2

El producto AnswerBook2 es el sistema de documentación en línea de Sun. Utiliza un navegador de web que permite visualizar e imprimir información diversa de Solaris^TM, incluidas colecciones de AnswerBook^TM basadas en SGML y en Display PostScript^TM y páginas del comando man.

El producto AnswerBook2 proporciona un mecanismo de búsqueda que permite encontrar información a través de la biblioteca de documentación. Puede instalar las colecciones de documentos en un servidor de documentación centralizado o en un servidor local.

Nota -

A lo largo de la documentación de AnswerBook2, el término AnswerBook1 se refiere a la versión del producto AnswerBook proporcionada con las versiones del sistema operativo Solaris anteriores a 2.6.

Características y funciones de AnswerBook2

El producto AnswerBook2 ofrece las siguientes características y funciones:

Utiliza una interfaz basada en un navegador de web, para que pueda visualizar documentación en línea desde cualquier plataforma (con cualquier sistema operativo), mientras disponga de un navegador de web que admita HTML 3.2
Según las funciones de su navegador de web, permite copiar información de los documentos de AnswerBook2 y pegarla en otros lugares, como su línea de comandos.
Proporciona una interfaz de búsqueda para localizar palabras y frases a través de toda la biblioteca de documentación
Proporciona la capacidad de imprimir capítulos y manuales directamente desde la interfaz de AnswerBook2 en un formato PostScript con calidad similar a la de imprenta
Permite visualizar documentos AnswerBook antiguos y nuevos mediante una única interfaz
Permite definir un subconjunto de colecciones de documentos (una biblioteca personal) para que se muestre al utilizar un servidor de documentos específico
Permite elegir un idioma en el que visualizar las instrucciones en pantalla y la información de ayuda
Utiliza arquitectura cliente-servidor, que posibilita que los documentos estén almacenados en una única ubicación (servidor) y se acceda a ellos desde el escritorio del usuario (cliente)
Proporciona tanto una interfaz de línea de comandos (CLI, Command Line Interface) como una interfaz gráfica (GUI, Graphical User Interface) para llevar a cabo tareas administrativas

Nuevas funciones de AnswerBook2 para esta versión

La lista siguiente identifica las funciones nuevas o sustancialmente mejoradas de esta versión del software AnswerBook2.

Páginas del comando man (Manual de referencia) en formato AnswerBook2

Las páginas de manual (man) en estilo tradicional de UNIX® están disponibles en formato AnswerBook2. La interfaz de búsqueda permite optar por buscar sólo en las páginas del comando man basadas en SGML instaladas en el servidor de documentación.
Soporte de contenidos multimedia

Si la fuente del documento incluye archivos de audio o vídeo, el sistema AnswerBook2 permite acceder a ellos según lo que se haya definido en el navegador para el soporte de audio y vídeo.
Posibilidad de ejecutar el servidor AnswerBook2 directamente desde el CD de documentación de Solaris 7 (sólo administradores del servidor)

Puede ejecutar el servidor AnswerBook2 directamente desde el CD de documentación de Solaris 7 mediante la secuencia ab2cd, si dispone del CD y tiene acceso de usuario root al sistema en el que está conectado el CD. Para obtener información detallada sobre esta función, véase "Para ejecutar un servidor de documentación desde CD de documentación de Solaris 7".
Capacidad para utilizar varios servidores de web basados en CGI (sólo administradores del servidor)

El servidor AnswerBook2 puede ejecutarse como un módulo NSAPI mediante el servidor incluido en los paquetes de servidor de AnswerBook2 o como una aplicación basada en CGI mediante cualquier servidor httpd que admita CGI (tal como Netscape Server^TM o Sun WebServer^TM). Para obtener información detallada sobre cómo cambiar a un servidor de web basado en CGI y algunas limitaciones posibles, véase "Ejecución del servidor AnswerBook2 como un proceso CGI".
Capacidad para controlar la visualización de los errores de las hojas de estilo (sólo administradores del servidor)

Para controlar si se muestra la palabra "DEFECTO" en color rojo a los usuarios cuando se producen errores en las hojas de estilo, active o desactive la función de depuración de AnswerBook2. Esta función se define al iniciar el servidor de documentación. Para más información, véase Inicio y paro del servidor de documentación en la ayuda de AnswerBook2.

Componentes y piezas

El producto AnswerBook2 está compuesto de los siguientes elementos:

Un navegador de web cliente: la versión Solaris 7 incluye el navegador Netscape; sin embargo, puede utilizar cualquier examinador que cumpla el estándar HTML 3.2 para visualizar la documentación en línea de Sun.

Nota -
Si únicamente desea ver la documentación en línea y tiene acceso al URL de un servidor de documentación, sólo necesita este elemento. El resto de elementos son parte del sistema del servidor de documentación (una máquina en la que se instalan las colecciones de documentos y que ejecuta un servidor basado en web para proporcionárselos). Si no tiene acceso a un servidor de documentación en su sede, puede ver toda la documentación publicada de Solaris en: http://docs.sun.com
Un servidor de documentación: realiza funciones de consulta y "sirve" documentos al navegador cliente; incluye plantillas que proporcionan un "aspecto" común para la visualización e impresión de documentos; también proporciona interfaces de administración de navegador de web y línea de comandos que realizan funciones de administración de bases de datos, autentificación de contraseña y otras funciones administrativas.
Colecciones de documentos: pueden ser documentos nuevos (SGML) o antiguos (Display PostScript).

Preguntas habituales sobre el tema

Esta sección presenta una lista de algunas preguntas habituales relativas al producto AnswerBook2, junto con respuestas a estas preguntas.

¿Qué es AnswerBook2?

El producto AnswerBook2 utiliza un servidor de documentos estándar para distribuir documentación en línea de Sun mediante su navegador de web favorito. La interfaz de AnswerBook2 permite examinar, buscar e imprimir información diversa de Solaris, incluidas colecciones de AnswerBook1 y páginas del comando man.

¿En qué se diferencia AnswerBook2 de AnswerBook?

El anterior producto AnswerBook (llamado ahora AnswerBook1) utilizaba Display PostScript para mostrar versiones electrónicas de documentos inicialmente desarrollados para su impresión en papel. El producto AnswerBook2 utiliza un navegador de web para mostrar documentación desarrollada para su distribución en línea mediante SGML y para mostrar los documentos de AnswerBook1 ya existentes.

Algunas diferencias clave entre los productos son:

Interfaz de navegador de web: con el producto AnswerBook2 puede utilizar cualquier navegador compatible con HTML 3.2 en cualquier plataforma para ver documentación en línea con el producto AnswerBook2.
Flexibilidad de fuente: el servidor AnswerBook2 puede proporcionar documentos AnswerBook1 ( Display Postscript^TM) o documentos AnswerBook2 (SGML).
Soporte cliente-servidor: el producto AnswerBook2 permite instalar el servidor y las colecciones de documentos en una ubicación central y visualizar los documentos desde otros sistemas. Además, incluye un mecanismo "a prueba de anomalías" mediante el cual el administrador de documentos puede definir varios servidores de documentación para que siempre funcionen los enlaces entre documentos.
Plataformas cruzadas: en esta versión, debe ejecutarse el servidor de documentos AnswerBook2 en el sistema operativo Solaris 7 (SPARC o Intel). No obstante, los clientes AnswerBook2 pueden ejecutarse en cualquier plataforma, y las versiones futuras pueden proporcionar las funciones de servidor en plataformas adicionales.
Comportamiento de búsqueda predeterminado: el producto AnswerBook2 utiliza AND para su comportamiento de búsqueda predeterminado en lugar de OR (el comportamiento de búsqueda predeterminado del producto AnswerBook1).

¿Puedo seguir visualizando mis colecciones de AnswerBook antiguas con AnswerBook2?

Sí, a menos que haya creado sus documentos AnswerBook antiguos antes de la publicación del sistema operativo Solaris 2.2. Para agregar colecciones de AnswerBook1 a la base de datos del servidor AnswerBook2, el administrador de documentos utiliza la función "agregar colección" de AnswerBook2 y señala al directorio que contiene el archivo ab_cardcatalog de AnswerBook1.

¿Ofrece AnswerBook2 la misma funcionalidad para los documentos de AnswerBook1 que para los de AnswerBook2?

No. Por coherencia, la interfaz de AnswerBook2 para los documentos AnswerBook1 es similar a la del producto AnswerBook1. Sin embargo, el producto AnswerBook2 posee las siguientes diferencias de funcionalidad para las colecciones de AnswerBook1 y de AnswerBook2:

No es posible mostrar u ocultar todos los niveles de un listado de tabla del contenido de AnswerBook1; sólo puede mostrar u ocultar detalles para un apartado específico de la tabla del contenido.
Las páginas de índice de AnswerBook1 no incluyen secciones Otros temas. Para navegar de una página a otra, puede utilizar el enlace Siguiente tema o regresar a la Tabla del contenido y seleccionar una sección distinta del manual.
Las páginas de índice de AnswerBook1 muestran todo el capítulo de una sola vez, no secciones menores.
Los iconos de resultado de búsqueda no representan bien la probabilidad de haber encontrado la información buscada en los AnswerBook1; estos iconos tienden a estar completamente llenos o completamente vacíos.
Los términos buscados no quedan resaltados en el texto de los AnswerBook1.
No es posible mostrar en el mismo documento algunos gráficos AnswerBook1; éstos están identificados por un icono que cuando se pulsa muestra una imagen PostScript del gráfico.
Una búsqueda Páginas del comando man por palabra clave sólo incluye las páginas del comando man de AnswerBook2 (basadas en SGML) del servidor y no las páginas del comando man de AnswerBook1.
Las páginas del comando man de AnswerBook1 utilizan la misma interfaz que el resto de documentos AnswerBook1; no tienen una interfaz especial de páginas de comando man.

¿Dónde está la documentación?

El software del servidor de documentos y las colecciones de documentos de Solaris 7 están en el CD de documentación de Solaris 7. De la Figura 8-1 a la Figura 8-6 se muestran las colecciones de documentos concretas que hay disponibles y se identifican los documentos que sólo se encuentran en formato de copia impresa.

Figura 8-1 Documentación de escritorio

Figura 8-2 Documentación de referencia (páginas del comando man)

Figura 8-3 Documentación de administración de sistema: parte 1

Figura 8-4 Documentación de administración de sistema: parte 2

Figura 8-5 Documentación de desarrollador: parte 1

Figura 8-6 Documentación de desarrollador: parte 2

Primeros pasos

Para ver la documentación en línea mediante el sistema AnswerBook2, necesita un navegador compatible con HTML 3.2 (tal como HotJava^TM, Netscape Navigator^TM, o Lynx^TM) y tener acceso a un servidor de documentación (un URL que identifica una máquina en la que están instaladas las colecciones de documentos y que ejecuta un servidor basado en web para proporcionárselas). Para más información, elija una de las opciones siguientes:

Para obtener información detallada sobre el uso del producto AnswerBook2 o la administración de un servidor de documentación, utilice la Ayuda de AnswerBook2 cuando tenga acceso a un servidor de documentación.

¿Debo instalar algo?

La tabla siguiente indica qué debe hacer o instalar para proporcionar determinadas funciones de AnswerBook2.

Tabla 8-1 Cuándo y qué instalar


Si desea...	Debe...
Ver documentación en línea desde su escritorio (cualquier plataforma, cualquier sistema operativo).	Iniciar un navegador de web e introducir el URL del servidor de documentación (por ejemplo, `http://servidor:8888/`). Véase "Ejecución del visualizador AnswerBook2".
Ejecutar automáticamente un navegador de web con el URL del servidor apropiado desde su escritorio.	Identificar un servidor de documentación y seleccionar la opción AnswerBook2 desde el menú Ayuda de CDE o el menú Programas de OpenWindows^TMsi ejecuta el sistema operativo Solaris 7. Véase "Ejecución del visualizador AnswerBook2".
Activar su sistema (máquina) para proporcionar (ofrecer) documentación.	Instalar el software de servidor de documentación desde el CD de documentación de Solaris 7. Véase "Instalación del software del servidor de documentación".
Agregar documentación desde el CD de documentación de Solaris 7 u otras ubicaciones a su servidor de documentos.	El administrador de documentos es el único usuario autorizado para realizar esta función. Véase "Para instalar colecciones de documentos en el servidor".

Ejecución del visualizador AnswerBook2

El sistema ejecuta un navegador de web con el URL para el servidor de documentos si está ejecutando el sistema operativo Solaris 2.6 (o una versión posterior) y:

Selecciona el icono de AnswerBook2 en el menú Ayuda del Panel frontal de CDE.
Selecciona AnswerBook2 en el menú Programas de OpenWindows.
Introduce el comando answerbook2 en la línea de comandos.

El sistema determina qué navegador de web se ejecutará buscando en su ruta de acceso y ejecutando Netscape Navigator^TM o el primer navegador de web que encuentre. Para obtener información sobre cómo determina el sistema el URL para el servidor de documentación, véase "Búsqueda de un servidor de documentación".

Puede también acceder al producto AnswerBook2 desde cualquier navegador de web, compatible con HTML; inicie éste e introduzca el URL del servidor de documentación apropiado. Por ejemplo, si el administrador de su sistema instaló un servidor de documentación AnswerBook2 en el sistema servidor con el número de puerto predeterminado, debería escribir el URL: http://servidor:8888/

Visualización de información

Una vez ejecutado el visualizador de AnswerBook2, puede desplazarse a un manual o capítulo haciendo clic en el texto subrayado (según cómo esté configurado su navegador para mostrar sus enlaces). Para obtener más información sobre cómo desplazarse por el sistema AnswerBook2, véase la Ayuda de AnswerBook2.

Búsqueda de un servidor de documentación

Cuando se ejecuta el visualizador de AnswerBook2 desde el sistema operativo Solaris, el software muestra una lista de las colecciones instaladas en el servidor de documentación predeterminado. Éste se identifica mediante los siguientes mecanismos de esta secuencia:

Si ha definido la variable de entorno AB2_DEFAULTSERVER, se ejecuta el visualizador de AnswerBook2 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 inició la función de AnswerBook2 es un servidor de documentación, se ejecuta el visualizador de AnswerBook2 mediante el URL: http://localhost:puerto

Donde puerto es el número de puerto en el que se está ejecutando el servidor de documentación y tiene como valor predeterminado 8888.
Si su administrador de documentos ha registrado el servidor AnswerBook2 con FNS (Federated Naming Service), el visualizador de AnswerBook2 utiliza el URL del servidor registrado.

Si no dispone de ningún servidor de documentación y tiene acceso a Internet, puede también acceder al servidor de documentación maestro de Sun en la dirección: http://docs.sun.com/

Instalación del software del servidor de documentación

En esta sección se explican los requisitos que se deben cumplir y las decisiones que se deben tomar antes de instalar el software de servidor AnswerBook2.

Este apartado sólo es aplicable al administrador de un sistema servidor de AnswerBook2. Los usuarios que únicamente visualizan documentación en línea no necesitan leer este apartado. No se precisa una instalación específica para ser cliente de AnswerBook2.

Nota -

En este producto no hay control de acceso a nivel de cliente. Si una máquina cliente puede acceder al URL de un servidor de documentación, podrá ver los documentos del servidor.

Esta sección contiene la siguiente información:

Para obtener información detallada sobre la administración de un servidor de documentación, utilice la ayuda en línea disponible desde la interfaz de AnswerBook2 cuando haya instalado el software de servidor de documentación.

Antes de instalar el software de servidor

Antes de iniciar el proceso de instalación, compruebe que su sistema cumple los requisitos que se muestran en "Requisitos de hardware y software" y decida dónde desea instalar el software, tal como se explica en "Opciones de instalación".

Requisitos de hardware y software

Antes de iniciar el proceso de instalación, verifique que el sistema en el que tiene pensado instalar el software de servidor AnswerBook2 cumple los requisitos de hardware y software que se muestran en la Tabla 8-2 y la Tabla 8-3.

Tabla 8-2 Requisitos de hardware y software


Componente	Requisito
Hardware del sistema servidor de documentación	Computador SPARCstation^TM 2 o superior (computador SPARCstation 5 recomendado) Computador personal con microprocesador Intel
Sistema operativo	Solaris 7 (para SPARC o x86, según sea apropiado)
GUI de Admin y visualizador cliente de AnswerBook2	Cualquier navegador compatible con HTML 3.2, tal como Netscape Navigator, HotJava o Lynx

Tabla 8-3 Tabla de requisitos de espacio en disco


Ruta de acceso	Descripción	Espacio
`/usr/lib/ab2/`	Contiene los archivos ejecutables, archivos de proceso del servidor, archivos de biblioteca y archivos fuente de gráficos y documentos para la interfaz del producto.	26 megabytes
`/var/log/ab2/`	Contiene archivos de catálogo y, si las funciones de registro están activadas, archivos de registro.	5 Megabytes (recomendado; aumenta a medida que se utiliza el servidor)
`/etc/init.d/ab2mgr`	Archivo de inicio del servidor	0,01 megabytes

Además, tendrá que reservar una cantidad determinada de espacio en disco (se recomiensa 600 Megabytes) para los archivos de manual. La cantidad exacta dependerá de las colecciones. Para obtener una lista de las colecciones disponibles en el CD de documentación de Solaris 7, véase el archivo README de este CD.

Opciones de instalación

Antes de instalar el software de servidor AnswerBook2, debería considerar las opciones de instalación:

Instalar todos los componentes en un sistema

El software de servidor AnswerBook2 y las colecciones de documentos de Solaris 7 están en el CD de documentación de Solaris 7. Si instala ambas partes del producto servidor en un sistema único, cuando termine la instalación e inicie el servidor estará preparado para servir documentos a todos los clientes. Véase "Para instalar el software de servidor AnswerBook2" para más información.
Instalación del servidor y la documentación en sistemas independientes

Puede instalar el software del servidor de documentación en un sistema y señalar a colecciones de documentos que estén ubicadas en otro sistema. Es posible que desee hacer esto si dispone de espacio limitado en el sistema de su servidor o si tiene colecciones existentes en otro sistema. Para hacer esto, debe agregar cada colección manualmente a la base de datos del servidor, y la función Buscar colecciones instaladas localmente no encontrará estas colecciones. Véase "Para instalar el software de servidor AnswerBook2" para más información.
Ejecución de un servidor desde el CD

Si está funcionando en un entorno sin conexión en red (independiente) o sólo consulta la documentación en línea de forma ocasional, puede ejecutar el servidor AnswerBook2 directamente desde el CD de documentación de Solaris 7. La ejecución del servidor de documentación desde el CD suele ser más lenta que si se instalara en su sistema. No utilice este método si espera que otros usuarios accedan a este servidor de documentación. Para más información, consulte "Para ejecutar un servidor de documentación desde CD de documentación de Solaris 7".

Para instalar el software de servidor AnswerBook2

Para instalar el software del servidor de documentación puede utilizar la interfaz de señalar y hacer clic disponible desde la utilidad Solaris Web Start^TM, o bien utilizar las utilidades de instalación estándar, como pkgadd.

Inserte el CD de documentación de Solaris 7 en su unidad de CD-ROM.

Volume Manager debería montar el CD automáticamente.

Si opta por utilizar la utilidad Solaris Web Start para instalar sus productos, haga doble clic en el icono installer, siga las instrucciones de las pantallas de Web Start y vaya al Paso 6.

La utilidad Web Start proporciona grupos preseleccionados de paquetes para que los instale. Siga las instrucciones de las pantallas de Web Start para continuar.

Si opta por utilizar las utilidades pkgadd o swmtool, entre como superusuario en la máquina del servidor de documentación.

Por ejemplo, en la línea de comandos escriba:
% su -

Cambie el directorio a la ubicación de los paquetes del servidor de documentación.

Por ejemplo, para ir a la ubicación de los paquetes de software del servidor para un servidor SPARC introduciría un comando similar al siguiente:
# cd cdrom/Solaris_2.7_Doc/sparc/Product/
Donde cdrom es el punto de montaje para el dispositivo de CD-ROM y tiene como valor predeterminado: /cdrom/sol_2_7_doc

Ejecute la utilidad de instalación y seleccione los paquetes de software del servidor.

Por ejemplo, utilice el comando siguiente para ejecutar la utilidad pkgadd:
# pkgadd -d .
Seleccione estos paquetes de software del servidor:
- SUNWab2r (0.,25 Megabytes): se instala en la partición raíz y proporciona archivos de configuración e inicio.
- SUNWab2s (1 Megabyte): proporciona archivos compartidos para realizar el proceso de documentos.
- SUNWab2u (26 Megabytes): proporciona archivos ejecutables y de procesos secundarios para las funciones de servidor y administración.

Arranque el servidor, si es necesario.

La instalación de los paquetes debe provocar el arranque del servidor en el puerto predeterminado: 8888. Si el servidor no arranca, utilice el siguiente comando para arrancarlo:
# /usr/lib/ab2/bin/ab2admin -o start

Instale las colecciones de manuales.

Su servidor de documentación no puede hacer su trabajo si no hay instalado algún documento que pueda servir. Puede instalar las colecciones desde el CD de documentación de Solaris 7 o desde otras ubicaciones, tal como colecciones de documentos ya existentes o provenientes de otros CD. Para obtener más información sobre la instalación de colecciones de documentos, véase "Para instalar colecciones de documentos en el servidor".

(Opcional) Cambie los archivos de configuración y cree enlaces para ejecutar el servidor de documentación como un proceso CGI en un servidor httpd existente.

Si ya ejecuta un servidor httpd en su sistema, puede ejecutar el servidor de documentación como un proceso CGI en ese servidor. Para ello, debe instalar el software de servidor de documentación estándar y luego cambiar varios archivos de configuración y crear enlaces. Para más información, véase "Ejecución del servidor AnswerBook2 como un proceso CGI".

(Opcional) Registre el servidor.

Si desea que otros usuarios encuentren automáticamente su servidor de documentación a través de Federated Naming Service (FNS), debe registrar el servidor. Para ello, utilice el siguiente comando:
# /usr/lib/ab2/bin/ab2regsvr url_del_servidor
donde url_del_servidor es el URL completamente cualificado para acceder a este servidor (por ejemplo: http://imaserver.eng.sun.com:8888/). Véase "Registro del servidor" para más información.

Para instalar colecciones de documentos en el servidor

Su servidor de documentación no puede hacer su trabajo si no hay instalado ningún documento para poderlo servir. Puede instalar las colecciones desde el CD de documentación de Solaris 7 o desde otras ubicaciones, tal como colecciones de documentos existentes o colecciones provenientes de otros CD.

Para instalar paquetes de colecciones de documentos desde el CD de documentación de Solaris 7, puede utilizar la interfaz de señalar y hacer clic disponible desde la utilidad Solaris Web Start o bien utilizar las utilidades de instalación estándar como pkgadd . Para instalar las colecciones de documentos:

Inserte el CD de documentación de Solaris 7 en su unidad de CD-ROM.

Volume Manager debería montar el CD automáticamente.

Si opta por utilizar la utilidad Solaris Web Start para instalar sus productos, haga doble clic en el icono installer, siga las instrucciones de las pantallas de Web Start y vaya al Paso 6.

La utilidad Web Start proporciona grupos preseleccionados de paquetes para que los instale. Siga las instrucciones de las pantallas de Web Start para continuar.

Si opta por utilizar las utilidades pkgadd o swmtool, entre como superusuario en la máquina del servidor de documentación.

Por ejemplo, escriba lo siguiente en la línea de comandos:
% su -

Cambie el directorio a la ubicación de los paquetes de colecciones de documentos.

Por ejemplo:
# cd cdrom/Solaris_2.7_Doc/common/Product/
Donde cdrom es el punto de montaje para el dispositivo de CD-ROM y tiene como valor predeterminado /cdrom/sol_2_7_doc.

Ejecute la utilidad de instalación y seleccione los paquetes de colecciones de documentos que desea instalar.

Por ejemplo, para ejecutar la utilidad pkgadd:
# pkgadd -d .
Para obtener una lista detallada de las colecciones de documentos incluidas en el CD de documentación de Solaris 7, véase el archivo README ubicado en este CD.

Los paquetes de colección de documentos incluidos en el CD de documentación de Solaris 7 incorporan una secuencia de post-instalación que agregan las colecciones a la base de datos del servidor y lo reinician.

Si instala paquetes de colecciones desde cualquier otra ubicación distinta al CD de documentación de Solaris 7, es posible que tenga que utilizar la función Agregar colección a la lista de la GUI Admin o el comando ab2admin -o add_coll para agregar estas colecciones a la base de datos del servidor de documentación.

Si ya tiene instaladas colecciones de documentos en su sistema, puede utilizar la función Buscar colecciones instaladas localmente de la GUI de Admin o el comando ab2admin -o scan para localizarlas y agregarlas a la base de datos del servidor de documentación. Esta función sólo funciona con los paquetes instalados localmente.

Para ofrecer colecciones de documentos ubicadas en otro sistema, utilice la función Agregar colección a la lista o el comando ab2admin -o add_coll y proporcione la ruta de acceso completa al archivo ab_cardcatalog o collinfo. Por ejemplo, si el servidor de documentación es servidor y desea que ofrezca las colecciones de documentos ubicadas en el sistema elsewhere, podría utilizar el comando siguiente:
# /usr/lib/ab2/bin/ab2admin -o add_coll -d /net/elsewhere/books/SUNWdtad/collinfo

Registro del servidor

Para proporcionar a los usuarios la capacidad de localizar el servidor de documentación sin conocer el URL, puede registrar el nombre de su servidor con el sistema FNS. Los usuarios pueden acceder a los servidores de documentación no registrados si conocen su URL.

La forma de registrar su servidor depende de dos factores:

Su familiaridad con los comandos de FNS

Si está familiarizado con los comandos estándar de FNS, tal como fnbind, puede utilizarlos para registrar el servidor. No obstante, el comando /usr/lib/ab2/bin/ab2regsvr puede registrar el servidor por el usuario para simplificar el proceso de registro. Para obtener más información, véase "Registro de su servidor mediante el comando ab2regsvr" y "Registro de su servidor mediante comandos FNS estándar".
Qué servicio de nombres utiliza

NIS+ (Network Information Service Plus) es el servicio de nombres primario utilizado en los sistemas operativos Solaris 2.6 y posterior. Si su sistema utiliza NIS+ y tiene privilegios de administración, puede registrar el servidor mientras esté conectado en los sistemas NIS+ maestro o cliente.

NIS (Network Information Service) era el servicio de nombres estándar proporcionado en los sistemas SunOS 4.x (Solaris 1.x). Si su sistema utiliza NIS, debe estar conectado como root en el sistema maestro NIS para poder registrar el servidor de documentación.

El producto AnswerBook2 también funciona con un sistema de nombrado definido por sistemas de archivos (files) en el que se introducen manualmente todos los nombres en archivos de datos. Estos archivos se almacenan en el directorio /var/fn/. En este caso, para registrar el servidor debe tener acceso de usuario root al sistema y el registro sólo se aplica a la máquina en que se está realizando. El resto de máquinas no pueden ver los servidores registrados con un mecanismo de sistema de archivos.

Registro de su servidor mediante el comando `ab2regsvr`

Para registrar su servidor, utilice el comando ab2regsvr. Éste consulta la configuración de su sistema y configura el espacio de nombres apropiado para su servidor.

Para registrar su servidor, escriba:

# /usr/lib/ab2/bin/ab2regsvr url_del_servidor

donde url_del_servidor es el URL completamente cualificado para acceder a este servidor (por ejemplo: http://imaserver.eng.sun.com:8888/).

El comando ab2regsvr también proporciona otras opciones que pueden resultar útiles:

Para ver una lista de los URL de servidor AnswerBook2 registrados:
# /usr/lib/ab2/bin/ab2regsvr -l
Para eliminar un servidor registrado de la lista:
# /usr/lib/ab2/bin/ab2regsvr -d
Para cambiar el URL para el servidor AnswerBook2 registrado actualmente:
# /usr/lib/ab2/bin/ab2regsvr -r url_del_servidor
Donde url_del_servidor es el nuevo URL para ir a ese servidor (por ejemplo: http://aserver.eng.sun.com:8888/). Esto sustituye los URL existentes por el URL especificado.

Para obtener más información sobre el comando ab2regsvr, véase la página del comando man ab2regsvr(1m).

Registro de su servidor mediante comandos FNS estándar

Si desea utilizar comandos FNS para registrar su servidor y ya tiene instalado FNS en su ubicación, utilice el comando siguiente para registrar el URL especificado como un servidor de documentación para su organización (dominio):

# fnbind -r thisorgunit/server/answerbook2 onc_answerbook2 \ 
onc_addr_answerbook2 
url_del_servidor

donde url_del_servidor es el URL completamente cualificado para acceder a este servidor (por ejemplo: http://imaserver.eng.sun.com:8888/).

Para averiguar los servidores actualmente registrados, utilice el siguiente comando:

% fnlookup -v thisorgunit/service/answerbook2

Este comando devuelve una lista de los servidores registrados similar a ésta:

Reference type: onc_answerbook2
Address type: onc_addr_answerbook2
  length: 19
  data: 0x68 0x74 0x74 0x70 0x3a 0x2f 0x2f 0x61 0x6e 0x73  http://ans
        0x77 0x65 0x72 0x73 0x3a 0x38 0x38 0x38 0x38       wers:8888

En este ejemplo, el servidor registrado es http://answers:8888.

Si obtiene una respuesta similar a la siguiente, no hay registrado ningún servidor de documentación con FNS:

Lookup of 'thisorgunit/service/answerbook2' failed: \
Name Not Found: 'answerbook2'

Para más información sobre FNS, incluida su instalación, véase la documentación de FNS.

Servicios de nombres y usuarios de AnswerBook2

El usuario puede definir un servidor AnswerBook2 predeterminado mediante la variable de entorno AB2_DEFAULTSERVER en lugar de utilizar los servicios de nombres descritos para encontrar un servidor de documentación. Por ejemplo, el archivo .cshrc del usuario podría contener la línea siguiente:

setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888

Si el usuario no ha definido ninguna variable de entorno, cuando se ejecute el producto AnswerBook2 desde el escritorio, el producto comprobará si el sistema desde el que se ejecutó está ejecutando un servidor de documentación. De ser así, se ejecuta mediante el URL: http://localhost:puerto, donde puerto tiene el valor predeterminado 8888.

Si el usuario no ha definido ninguna variable de entorno y el sistema actual no es un servidor de documentación, cuando el usuario ejecuta AnswerBook2 desde el escritorio, el sistema lleva a cabo un comando fnlookup thisorgunit/service/answerbook2 para averiguar qué servidores de documentación hay disponibles. Luego elegirá uno de estos servidores y ejecutará el navegador de AnswerBook2 utilizando como URL el nombre de ese servidor.

Para ejecutar un servidor de documentación desde CD de documentación de Solaris 7

Inserte el CD de documentación de Solaris 7 en su unidad de CD-ROM.

Compruebe que está conectado como el superusuario.
% su -

Cambie el directorio (o arranque el y vaya) al nivel superior del volumen del CD-ROM.

Éste debería tener un aspecto similar a la ubicación siguiente:
/cdrom/sol_2_7_doc/
Este directorio contiene un directorio, un archivo README, la utilidad installer y la secuencia ab2cd. Utilice la secuencia ésta para ejecutar el servidor de documentación directamente desde el CD.

Escriba el comando siguiente:
# ./ab2cd

Puede acceder al servidor de documentación medianrte el URL:
http://servidor:8888/
Donde servidor es el nombre de la máquina a la que está conectada la unidad de CD-ROM.

Observe que los servidores de documentación ejecutados desde CD siempre se ejecutan en el puerto 8888.

(Opcional) Si ya hay instaladas colecciones de documentos en su máquina de servidor y desea que las reconozca el software de servidor controlado por CD, utilice el comando siguiente: .
# ab2cd -s
Esta forma del comando hace que el software de servidor controlado por CD busque otras colecciones instaladas en ese sistema y las agregue a su base de datos.

Para detener la ejecución del servidor desde el CD, escriba:
# /cdrom/sol_2_7_doc/ab2cd stop

Precaución -

La ejecución del servidor de documentación directamente desde el CD acostumbra a ser lenta. No utilice este método si espera que otros usuarios accedan a este servidor de documentación.

Notas importantes cuando se ejecuta el servidor AnswerBook2 desde el CD

Cuando ejecute el servidor desde el CD, tenga en cuenta:

Cuando se ejecuta desde el CD, el servidor AnswerBook2 siempre se ejecuta en el puerto 8888. Si ya está ejecutando un servidor AnswerBook2 en su sistema en el puerto predeterminado (8888), la secuencia ab2cd mostrará el mensaje siguiente:
```
A document server is already running on this system as server:8888.





Please shut down the current server before running the ab2cd command.
```
Utilice el comando siguiente para parar el servidor existente:
# /usr/lib/ab2/bin/ab2admin -o stop
Para detener la ejecución del servidor desde el CD, utilice siempre ab2cd stop. No utilice /etc/init.d/ab2mgr stop para detener el servidor basado en CD.

El comando ab2cd stop detiene el proceso del servidor AnswerBook2 y elimina todos los archivos de los directorios /tmp/ab2/ y /tmp/ab2cd_config/. El comando /etc/init.d/ab2mgr stop detiene todos los procesos del servidor pero no elimina los archivos de los directorios /tmp/ab2/ y /tmp/ab2cd_config/.

Notas sobre la ejecución de dos servidores

Para ejecutar dos servidores AnswerBook2 (uno en su sistema y el otro desde el CD), tenga presente estas reglas:

Inicio del servidor
- El comando /etc/init.d/ab2mgr start siempre ejecuta el servidor de su sistema.
- El comando ab2cd siempre ejecuta el servidor desde el CD.
Paro del servidor
- Utilice siempre el comando ab2cd stop para detener la ejecución del servidor desde el CD.
- Para detener ambos servidores, utilice primero el comando ab2cd stop para detener la ejecución del servidor desde el CD y luego /etc/init.d/ab2mgr stop o /usr/lib/ab2/bin/ab2admin -o stop para detener la ejecución del servidor de su sistema.

Ejecución del servidor AnswerBook2 como un proceso CGI

De forma predeterminada, el servidor de documentación AnswerBook2 se ejecuta como un módulo NSAPI sobre el servidor httpd que se incluye en el paquete SUNWab2u. Como el servidor AnswerBook2 es compatible con los protocolos de web estándar, puede optar por ejecutar el servidor de documentación como un proceso CGI (Common Gateway Interface) sobre otro servidor web que ya esté en su sistema (por ejemplo, Netscape Server o Sun Web Server).

Tenga en cuenta que si no utiliza el servidor web AnswerBook2 predeterminado no funcionarán las funciones siguientes:

/usr/lib/ab2/bin/ab2admin -o start
/usr/lib/ab2/bin/ab2admin -o stop
/etc/init.d/ab2mgr start
/etc/init.d/ab2mgr stop
restart desde la GUI de Admin

Deberá utilizar las funciones de inicio y paro de su servidor en su lugar.

Para pasar a un servidor basado en CGI

Como los detalles concretos dependen del servidor web, este procedimiento describe los pasos generales que debe seguir para utilizar un servidor web basado en CGI en lugar del servidor predeterminado (módulo NSAPI). A continuación se incluyen ejemplos concretos para Sun Web Server y Netscape Server.

Detenga el servidor AnswerBook2 si se está ejecutando.

Utilice uno de los comandos siguientes:
# /usr/lib/ab2/bin/ab2admin -o stop # /etc/init.d/ab2mgr stop

Edite el archivo de configuración de su servidor web y haga que los iconos estén disponibles.

La documentación de su servidor web debería explicar los detalles específicos, tales como dónde encontrar el archivo de configuración. La entrada /icons/ debería apuntar a /usr/lib/ab2/data/docs/icons/.

Si ya se está utilizando /icons/, enlace todos los archivos de /usr/lib/ab2/data/docs/icons/ al directorio /icons/ existente.

Enlace los documentos de ayuda de AnswerBook2 al directorio raíz de la documentación actual.

Vaya al directorio raíz de la documentación de su servidor web y cree un enlace blando a /usr/lib/ab2/data/docs/.

Haga que los archivos cgi-bin de AnswerBook2 estén disponibles en su servidor.

Vaya al directorio cgi-bin de su servidor web y cree enlaces blandos a los siguientes archivos:

/usr/lib/ab2/bin/cgi/admin 
/usr/lib/ab2/bin/cgi/nph-dweb 
/usr/lib/ab2/bin/cgi/gettransbitmap 
/usr/lib/ab2/bin/cgi/getepsf 
/usr/lib/ab2/bin/cgi/getframe 
/usr/lib/ab2/bin/cgi/ab2srwrap

Edite el archivo de configuración de su servidor web y asigne /ab2/ para que llame al cgi de AnswerBook2.

La documentación de su servidor web debería explicar los detalles específicos, como por ejemplo dónde encontrar el archivo de configuración. Debe cambiar la entrada para /ab2/ a /usr/lib/ab2/bin/cgi/nph-dweb/ab2/.

Edite el archivo de configuración de la administración de AnswerBook2.

Debe editar el archivo /usr/lib/ab2/bin/cgi/nph-dweb y cambiar las entradas para servertype, errorlog y accesslog.

Para ejecutar el servidor AnswerBook2 como un proceso CGI en Sun WebServer

De forma predeterminada, el archivo de configuración de Sun Web Server es /etc/http/httpd.conf y los archivos están en /var/http/demo/. Si no ha instalado en su ubicación predeterminada ( /usr/), todas las rutas de acceso que comiencen por /usr/lib/ab2/ deberán ser la ruta de acceso en donde instaló los archivos (por ejemplo, /usr2/lib/ab2/).

Edite el archivo /etc/http/httpd.conf y coloque la línea siguiente en la sección server de aquél:
map /icons /usr/lib/ab2/data/docs/icons
Cuando haya realizado este cambio, utilice el comando siguiente para reiniciar el servidor SWS:
# /etc/init.d/httpd start
Para verificar sus cambios, introduzca el URL siguiente en su navegador de Web para ver un icono de Ayuda:
http://localhost:puerto/icons/ab2_help.gif
Donde puerto es el número de puerto en que se está ejecutando su servidor de documentación y tiene el valor predeterminado 8888.

Vaya al directorio /var/http/demo/public/ y coloque el enlace blando siguiente:
# ln -s /usr/lib/ab2/data/docs/Help Help
Para verificar sus cambios, introduzca el URL siguiente en su navegador de web para ver un icono de Ayuda:
http://localhost:puerto/Help/C/Help/books/Help/figures/ab2_help.gif
Donde puerto es el número de puerto en que se está ejecutando su servidor de documentación y tiene el valor predeterminado 8888.

Vaya al directorio /var/http/demo/cgi-bin/ y cree los enlaces blandos siguientes:

# ln -s /usr/lib/ab2/bin/cgi/admin 
# ln -s /usr/lib/ab2/bin/cgi/nph-dweb 
# ln -s /usr/lib/ab2/bin/cgi/gettransbitmap 
# ln -s /usr/lib/ab2/bin/cgi/getepsf 
# ln -s /usr/lib/ab2/bin/cgi/getframe 
# ln -s /usr/lib/ab2/bin/cgi/ab2srwrap

Para verificar sus cambios, introduzca el URL siguiente en su navegador de web para ver la página de biblioteca de AnswerBook2:

http://localhost:puerto/cgi-bin/nph-dweb/ab2

Donde puerto es el número de puerto en que se está ejecutando su servidor de documentación y tiene el valor predeterminado 8888.

Edite el archivo /etc/http/httpd.conf y agregue la entrada siguiente en la sección host de aquél:
map /ab2 /var/http/demo/cgi-bin/nph-dweb/ab2 cgi
Reinicie el servidor SWS mediante el comando siguiente:
# /etc/init.d/httpd start
Para verificar sus cambios, introduzca el URL siguiente en su navegador de web para ver la página de biblioteca de AnswerBook2:
http://localhost:puerto/ab2
Donde puerto es el número de puerto en que se está ejecutando su servidor de documentación y tiene el valor predeterminado 8888.

Edite el archivo /usr/lib/ab2/bin/cgi/nph-dweb y cambie las entradas siguientes:

setenv servertype sws 
setenv errorlog 
setenv accesslog /var/http/logs/http.elf.1

Para ejecutar un servidor AnswerBook2 como un proceso CGI en Netscape Server

Para este ejemplo, el archivo de configuración de Netscape Server es /ul/netscape/suitespot/httpd-threads1/config/obj.conf y los archivos están en /ul/netscape/suitespot/docs/. Si no ha instalado en su ubicación predeterminada (/usr/), todas las rutas de acceso que comiencen por /usr/lib/ab2/ deberán ser la ruta de acceso en donde instaló los archivos (por ejemplo, /usr2/lib/ab2/).

Edite el archivo /ul/netscape/suitespot/httpd-threads1/config/obj.conf y agregue la línea siguiente:
NameTrans fn='pfx2dir' from='/icons' dir='/usr/lib/ab2/data/docs/icons'
Para verificar sus cambios, reinicie Netscape Server. A continuación, introduzca el URL siguiente en su navegador de web para ver un icono de Ayuda:
http://localhost:puerto/icons/ab2_help.gif

Vaya al directorio /ul/netscape/suitespot/docs/ y coloque el enlace blando siguiente:
# ln -s /usr/lib/ab2/data/docs/Help Help
Para verificar sus cambios, introduzca el URL siguiente en su navegador de web para ver un icono de Ayuda:
http://localhost:puerto/Help/C/Help/books/Help/figures/ab2_help.gif
Donde puerto es el número de puerto en que se está ejecutando su servidor de documentación y tiene el valor predeterminado 8888.

Vaya al directorio /ul/netscape/suitespot/cgi-bin/ y cree los enlaces blandos siguientes:

# ln -s /usr/lib/ab2/bin/cgi/admin
# ln -s /usr/lib/ab2/bin/cgi/nph-dweb
# ln -s /usr/lib/ab2/bin/cgi/gettransbitmap
# ln -s /usr/lib/ab2/bin/cgi/getepsf
# ln -s /usr/lib/ab2/bin/cgi/getframe
# ln -s /usr/lib/ab2/bin/cgi/ab2srwrap

Para verificar sus cambios, introduzca el URL siguiente en su navegador de web para ver la página de biblioteca de AnswerBook2:

http://localhost:puerto/cgi-bin/nph-dweb/ab2

Donde puerto es el número de puerto en que se está ejecutando su servidor de documentación y tiene el valor predeterminado 8888.

Edite el archivo /ul/netscape/suitespot/httpd-threads1/config/obj.conf y agregue la entrada siguiente:
NameTrans fn="pfx2dir" from="/ab2" dir="/ul/netscape/suitespot/cgi-bin/nph-dweb/ab2" name="cgi"
Para verificar sus cambios, reinicie el servidor Netscape e introduzca el URL siguiente en su navegador de web para ver la página de biblioteca de AnswerBook2:
http://localhost:puerto/ab2
Donde puerto es el número de puerto en que se está ejecutando su servidor de documentación y tiene el valor predeterminado 8888.

Edite el archivo /usr/lib/ab2/bin/cgi/nph-dweb y cambie las entradas siguientes:

setenv servertype netscape 
setenv errorlog /ul/netscape/suitespot/httpd-threads1/logs/errors 
setenv accesslog /ul/netscape/suitespot/httpd-threads1/logs/access

Resolución de problemas de AnswerBook2

La Tabla 8-4 muestra algunas áreas del producto AnswerBook2 con equivocaciones conocidas y proporciona sugerencias para solucionarlas.

Tabla 8-4 Problemas posibles del servidor

Para esta cuestión...

Tenga en cuenta esto...

Vea también...

Error de proxy de navegador

Edite el archivo /usr/lib/ab2/dweb/data/config/dwhttpd.cfg y cambie el nombre de sistema por nombre_sistema.dominio.

Por ejemplo, en lugar de la línea siguiente:

set ServerHost imaserver ;#

Utilice esta línea:

set ServerHost imaserver.eng.sun.com ;#

Luego, reinicie el servidor de documentación.

Si el problema continúa, desactive la función de delegados en el navegador de web.

Errores del navegador que indican que el servidor de documentación no responde

Si el servidor de documentación no responde, reinícielo.

Para obtener información sobre cómo parar e iniciar el servidor, véase la Ayuda de AnswerBook2.

Error 404, File not Found al intentar acceder al servidor de documentación

Se está nejecutando un proceso del servidor, pero se ha eliminado el software del servidor. Reinstale el software del servidor.

Para más información sobre la instalación del software, véase "Instalación del software del servidor de documentación".

El usuario indica que la página de biblioteca muestra únicamente la barra de navegación pero ninguna colección de documentos

Compruebe que el archivo de plantillas de las colecciones ( /usr/lib/ab2/dweb/data/config/ab2_collections.template) no contenga entradas vacías o duplicadas.

Si la reparación del archivo de plantillas no resuelve el problema, posiblemente sea necesario volver a instalar las colecciones de documentos o el software del servidor. Para más información acerca de la instalación del software, véase "Para instalar el software de servidor AnswerBook2".

El usuario informa que se ve texto en rojo y la palabra 'DEFECTO' en un manual (o en varios manuales)

La fuente del manual contiene etiquetas de marcado no reconocidas por AnswerBook2 y la variable de entorno AB2_DEBUG está definida a '1' en el servidor.

Para desactivar la visualización de defectos, defina la variable de entorno AB2_DEBUG a '0', pare el servidor y vuelva a iniciarlo.

Póngase en contacto con el proveedor del manual para solucionar el marcado.

Imposible acceder a las funciones de administración del servidor de documentación

El servidor de documentación utiliza mecanismos de control de acceso para identificar a los usuarios que pueden realizar funciones de administración. Las herramientas de administración de AnswerBook2 permiten que el administrador de documentos de la máquina de servidor agregue y elimine usuarios con capacidad de administración del servidor y cambie sus contraseñas.

Para agregar o eliminar usuarios con capacidad de administración en su servidor, véase la Ayuda de AnswerBook2. Si necesita acceder a otro servidor, póngase en contacto con el administrador de documentos de ese servidor.

No es posible ejecutar comandos de administración desde la GUI (interfaz del navegador) de Administración de AnswerBook2

Ciertos comandos no funcionan desde la interfaz gráfica de administración debido a cuestiones de permisos. Intente llevar a cabo la misma función desde la interfaz de línea de comandos ab2admin.

Para más información acerca de las opciones de línea de comandos, consulte la página del comando man ab2admin(1m).

La función Buscar colecciones instaladas localmente no muestra una lista de las colecciones de documentos instaladas en un punto de montaje local.

Compruebe que el directorio en el que se instalaron las colecciones tiene establecido acceso de lectura para otros.

Ha agregado una colección de AnswerBook1, pero los usuarios no pueden verla en sus bibliotecas

Compruebe que la información del archivo /var/log/ab2/catalog/ab1_cardcatalog sea correcta.

Esto significa que hay algún problema en los datos de la colección, en el archivo ab_cardcatalog.

Ve el mensaje Failed to added collection al intentar agregar una colección desde la GUI de Admin.

Verifique que la ruta de acceso al archivo collinfo o ab_cardcatalog de esa colección sea correcta.

El uso del comando restart para reiniciar el servidor de documentación ha fallado o no produjo los resultados esperados

En algunos casos, el comando restart no funciona correctamente.

Utilice en su lugar los comandos stop y start.

Las colecciones de documentos parecen estar deterioradas y necesitan ser reinstaladas

Utilice la función ab2admin -o del_coll o Eliminar colecciones de la lista de la GUI de Admin para eliminar estas colecciones de la base de datos del servidor de documentación.

Utilice luego pkgrm para eliminarlas del servidor antes de instalar los nuevos paquetes.

Para obtener más información sobre la eliminación de colecciones, véase la Ayuda de AnswerBook2.