Capítulo 4 Instalación de la documentación de SEAS 3.0

Este capítulo proporciona información sobre las colecciones de documentación que se proporcionan con Solaris Easy Access Server 3.0 e instrucciones para instalar el visualizador de documentación AnswerBook2^TM.

• "La documentación de SEAS"

• "Instalación del servidor Answerbook2"

• "Instalación de las colecciones de SEAS"

• "Registro de un servidor de documentos Answerbook2"

• "Uso del servidor AnswerBook2"

Véase "Conversión a Solstice DiskSuite 4.2" in Solaris Easy Access Server 3.0 Release Notes y "Documentation Errata" in Solaris Easy Access Server 3.0 Release Notes para obtener información de última hora relacionada con la documentación de SEAS.

La documentación de SEAS

Toda la documentación de SEAS está disponible en el CD de documentación de SEAS, excepto las Notas sobre la versión, editadas en un manual impreso. La mayoría de la documentación está disponible en formato AnswerBook2, aunque parte de ella se proporciona en otros formatos, como HTML, ayuda en línea, archivos de texto, PDF y PostScript\256. La documentación se puede instalar mediante Solaris Web Start o el comando pkgadd.

Tabla 4-1 enumera los manuales y la información que componen el conjunto de documentación de SEAS.

Instalación del servidor Answerbook2

El producto AnswerBook2 es el sistema de documentación en línea de Sun Microsystems. Utiliza una interfaz de navegador para ver, imprimir y efectuar búsquedas en la documentación.

Para ver la documentación en línea de SEAS, debe tener acceso a un servidor de documentación AnswerBook2, el cual le permitirá ver la documentación de Sun mediante su navegador preferido. Presenta la documentación en HTML compatible con 3.2 y la envía a un navegador para su visualización; también admite el formato de documentación AnswerBook ^TM anterior. El software del servidor de documentación AnswerBook2 está incluido en los CD de documentación de SEAS y de Solaris 7.

Para una visualización ocasional de las colecciones de documentos de SEAS, no es necesario que instale el software de servidor de documentación AnswerBook2; puede ejecutarlo directamente desde el CD de documentación de SEAS con la secuencia ab2cd. Para obtener información detallada sobre esta función, véase el archivo LÉAME del CD de documentación de SEAS. Para ello, debe tener acceso de root en el sistema al que está conectado el CD.

Sin embargo, para proporcionar el acceso a la documentación de los productos SEAS a sus usuarios, debe instalar el software de servidor de documentación AnswerBook2. Una vez instalado el software de servidor SEAS, debe instalar la documentación de SEAS en este servidor. Para obtener información sobre la instalación del software de servidor y la documentación incluida en el CD de documentación de SEAS, véase el archivo LÉAME de este CD. Para obtener información general sobre el uso del producto AnswerBook2, véase el módulo "Acceso a documentación en línea" de Solaris 7: Biblioteca de instalación (Edición SPARC) o Solaris 7: Biblioteca de instalación (Edición Intel).

Si no tiene acceso a un servidor de documentos AnswerBook2 o no desea instalarlo localmente, puede ver toda la documentación de Solaris publicada en la sede Web http://docs.sun.com.

Ejecución del servidor AnswerBook2 desde el CD de documentación de SEAS

Tenga en cuenta que ejecutar el servidor de documentos directamente desde el CD es bastante lento. Por tanto, si tiene previsto que otros usuarios accedan a las colecciones de documentos de SEAS no es aconsejable que utilice este método.

1. Entre en el sistema como usuario root.

2. Cambie el directorio o arranque el Gestor de archivos y vaya a la ubicación que contenga la secuencia ejecutable ab2_cd.

3. Ejecute el comando ab2_cd.

4. Acceda al servidor de documentación mediante el URL: http://localhost:8888

   donde localhost es el nombre de la máquina en la que está instalado el CD.

5. Para parar la ejecución del servidor desde el CD, ejecute el comando ab2_cd stop.

Instalación del servidor de documentación AnswerBook2

1. Inserte el CD de documentación de SEAS en la unidad de CD-ROM.

2. Inicie una sesión de root en la máquina del servidor de documentación y cambie el directorio a la ubicación de los paquetes de instalación.

3. En el indicador del sistema, inicie Solaris Product Registry; escriba:

   prodreg &

4. Haga clic en Instalar en la parte inferior de la ventana Registro de productos.

5. Localice el programa instalador de AnswerBook2 y haga clic en Aceptar.

6. Siga las indicaciones según se le solicite.

Instalación del servidor de documentación Answerbook2 con pkgadd

1. Inserte el CD de documentación de SEAS en la unidad de CD-ROM.

2. Inicie una sesión de root en la máquina del servidor de documentación y cambie el directorio a la ubicación de los paquetes de instalación.

3. Escriba el comando:

   pkgadd nombre_paquete

   Para instalar los paquetes del servidor en un directorio no predeterminado, utilice el comando pkgadd -d . -a none. La utilidad pkgadd solicitará el directorio donde desea instalar el software.

   SUNWab2r (0,02 Megabytes): se instala en la partición raíz y proporciona archivos de configuración e inicio.

   SUNWab2s (0,21 Megabytes): proporciona archivos compartidos para realizar el proceso de documentos.

   SUNWab2u (21,02 Megabytes): proporciona archivos ejecutables y de procesos secundarios para las funciones de servidor y administración.

4. Inicie el servidor si fuera necesario.

   La instalación de los paquetes debe iniciar el servidor en el puerto predeterminado 8888. Si no se inicia, escriba el comando siguiente para iniciarlo:

   # /usr/lib/ab2/bin/ab2admin -o start

Instalación de las colecciones de SEAS

Antes de que el servidor de documentación AnswerBook2 pueda hacer su trabajo, debe instalar las colecciones de documentos. Véase Tabla 4-1 para obtener una lista de las colecciones de documentación de SEAS.

Para instalar las nuevas colecciones de manuales en su servidor, utilice la utilidad pkgadd. Para agregar las colecciones de documentos de SEAS a una base de datos AnswerBook, utilice la función Agregar colección a lista o el comando ad2admin -o add_coll.

Si ya hay instalados paquetes de colecciones en el servidor de documentación, puede utilizar la función Explorar colecciones instaladas localmente del servidor o el comando ab2admin -o scan para encontrarlos y para que se agreguen automáticamente a la base de datos de documentación del servidor. Esta función sólo es válida para paquetes instalados localmente.

Para ofrecer colecciones de documentación situadas en otro servidor de documentación, utilice la función Agregar colección a lista o el comando ab2admin -o add_coll y proporcione el nombre de ruta completo para el archivo ab_cardcatalog o collinfo. Por ejemplo, si el servidor de documentos es ab2docserver y desea ofrecer las colecciones de documentos de DiskSuite 4.2 del sistema bingo, podría escribir el comando siguiente:

ab2admin -o add_coll -d /net/bingo/opt/answerbooks/english/DiskSuite_4.2/SUNWdsab

Registro de un servidor de documentos Answerbook2

Si desea que otros usuarios encuentren automáticamente su servidor de documentos mediante FNS (Federated Naming Services, Servicio de asignación de nombres federado), debe registrar el servidor. Así incluirá su servidor en una agrupación de servidores para una sede y dará a los usuarios la capacidad para elegir un servidor de documentos.

Registro de un servidor de documentos AnswerBook2

1. Escriba el comando siguiente:

   # /usr/lib/ab2/bin/ab2regsvr url_servidor

   donde url_servidor es el URL completo para llegar a este servidor.

   Por ejemplo: ab2docserver.eng.sun.com:8888

Para obtener más información sobre la instalación del software de servidor AnswerBook2, consulte Solaris 2.5: Biblioteca de información (Edición SPARC).

Uso del servidor AnswerBook2

Si utiliza el sistema operativo Solaris 2.6 o Solaris 7, puede iniciar AnswerBook2 de una de las formas siguientes.

• Desde el panel frontal de CDE, haga clic con el botón derecho del ratón en Programa y luego seleccione AnswerBook2.

• En el menú Programas de Open Windows, elija AnswerBook2.

• Escriba answerbook2 en la línea de comandos de UNIX.

• Desde un navegador de Web, introduzca el nombre del servidor AnswerBook2 y el puerto, con esta sintaxis:

  http://servidor_documentos:puerto.

  Por ejemplo: http://ab2docserver:8888.