Este capítulo explica cómo instalar y utilizar el producto AnswerBook2TM 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\363digo 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\363digo o ru ta tal como se hayan escrito.
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 SolarisTM, incluidas colecciones de AnswerBookTM basadas en SGML y en Display PostScriptTM 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.
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.
El producto AnswerBook2 ofrece las siguientes características y funciones:
Utiliza una interfaz basada en un navegador de web, que permite 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 el almacenaje de los documentos en una única ubicación (servidor) y el acceso 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
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.
Admisión 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 haya definido en su navegador para la admisión 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 de éste y tiene acceso de usuario root al sistema al que aquél está. 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 ServerTM o Sun WebServerTM). 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.
El producto AnswerBook2 está compuesto de los siguientes elementos:
Un navegador de Web: 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.
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 las funciones de consulta y "sirve" los 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).
Esta sección presenta una lista de algunas preguntas habituales relativas al producto AnswerBook2, junto con respuestas a estas preguntas.
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.
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.
Flexibilidad de fuente: el servidor AnswerBook2 puede proporcionar documentos AnswerBook1 ( Display PostscriptTM) 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 fallos" 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).
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.
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.
El software del servidor de documentos y las colecciones de documentos de Solaris 7 están en CD de documentación de Solaris 7. Las figurasFigura 9-1 a Figura 9-6 muestran las colecciones de documentos concretas disponibles e identifican los documentos que sólo se encuentran en formato de copia impresa.
Para ver la documentación en línea mediante el sistema AnswerBook2, necesita un navegador compatible con HTML 3.2 (tal como HotJavaTM, Netscape NavigatorTM, o LynxTM) 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.
La tabla siguiente indica qué debe hacer o instalar para proporcionar determinadas funciones de AnswerBook2.
Tabla 9-1 Cuándo y qué instalarSi 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 OpenWindowsTM, si está ejecutando 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 CD de documentación de Solaris 7. Véase "Instalación del software del servidor de documentación". |
Agregar documentación desde 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". |
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 NavigatorTM 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 3.2. Inicie su navegador de Web 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 mediante el número de puerto predeterminado, debería escribir el URL: http://servidor:8888/
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, véase la Ayuda de AnswerBook2.
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. El servidor predeterminado 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/
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. Quienes ú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.
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 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".
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 Tabla 9-2 y Tabla 9-3.
Tabla 9-2 Requisitos de hardware y software
Componente |
Requisito |
---|---|
Hardware del sistema servidor de documentación |
Computador SPARCstationTM 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 9-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, necesitará reservar una cantidad determinada de espacio en disco (se recomienda 600 Megabytes) para los archivos de manual. La cantidad exacta dependerá de las colecciones. Para obtener una lista de las colecciones disponibles en CD de documentación de Solaris 7, véase el archivo README ubicado en tal CD.
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 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. Es posible que desee hacer esto si dispone de espacio limitado en el sistema de su servidor o si tiene colecciones existentes en otro. Para hacerlo, 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 funciona en un entorno sin conexión en red (independiente) o sólo ocasionalmente consulta la documentación en línea, puede ejecutar el servidor AnswerBook2 directamente desde 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 del servidor de documentación puede utilizar o bien la interfaz de señalar y hacer clic, disponible desde la utilidad Solaris Web StartTM, o bien las utilidades de instalación estándar, como pkgadd.
Inserte 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 a 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.00 Megabytes): proporciona archivos compartidos para realizar el proceso de documentos.
SUNWab2u (26.00 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 ningún documento para poderlo servir. Puede instalar las colecciones desde 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.
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 CD de documentación de Solaris 7 o desde otras ubicaciones, tal como colecciones de documentos ya existentes o provenientes de otros CD.
Para instalar paquetes de colecciones de documentos desde CD de documentación de Solaris 7, puede usar la interfaz de señalar y hacer clic, disponible desde la utilidad Solaris Web Start, o las utilidades de instalación estándar como pkgadd. Para instalar las colecciones de documentos:
Inserte 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 a 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 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 CD de documentación de Solaris 7, véase el archivo README ubicado en ese CD.
Los paquetes de colección de documentos incluidos en CD de documentación de Solaris 7 incorporan una secuencia de postinstalació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 deba 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 |
Para proporcionar a los usuarios la capacidad de localizar el servidor de documentación sin conocer el URL, puede registrar el nombre de aquél con el sistema FNS. Los usuarios pueden acceder a los servidores de documentación no registrados si conocen el URL.
El método para 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.
Para registrar su servidor, utilice el comando ab2regsvr. El comando ab2regsvr 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 resultarle ú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).
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 answers: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:
Lockup of 'thisorgunit/service/answerbook2' failed: \ Name Not Found: 'answerbook2' |
Para más información sobre FNS, incluida la instalación, véase la documentación de FNS.
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 mediante como URL el nombre de ese servidor.
Inserte CD de documentación de Solaris 7 en su unidad de CD-ROM.
Asegúrese de estar 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 ab2cd para ejecutar el servidor de documentación directamente desde el CD.
Escriba el comando siguiente:
# ./ab2cd |
Puede acceder al servidor de documentación mediante 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 |
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.
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 mediante 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/.
Para ejecutar dos servidores AnswerBook2 (uno en su sistema y el otro desde el CD), tenga presente estas reglas:
El comando /etc/init.d/ab2mgr start siempre ejecuta el servidor de su sistema.
El comando ab2cd siempre ejecuta el servidor desde el CD.
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 utilice /etc/init.d/ab2mgr stop o /usr/lib/ab2/bin/ab2admin -o stop para detener la ejecución del servidor de su sistema.
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 de 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
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 utiliza /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 de 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 de 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 de 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.
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 del mismo:
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 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 |
La tabla Tabla 9-4 muestra algunas áreas del producto AnswerBook2 con equivocaciones conocidas y proporciona sugerencias para solucionarlas.
Tabla 9-4 Problemas posibles del servidor
Para esta cuestión... |
Tenga en cuenta esto... |
Vea también... |
||
---|---|---|---|---|
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:
|
Si el problema continúa, desactive la función de delegados en el examinador 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á ejecutando un proceso del servidor, pero no 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 no colecciones 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 examinador) 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 add 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. |