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

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

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 StartTM, o bien utilizar las utilidades de instalación estándar, como pkgadd.

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

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

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

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

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

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

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

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

  9. (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:

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

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

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

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

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

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

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

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

  2. Compruebe que está conectado como el superusuario.


    % su -
    
  3. 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.

  4. Escriba el comando siguiente:


    # ./ab2cd
    
  5. 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.

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

  7. Para detener la ejecución del servidor desde el CD, escriba:


    # /cdrom/sol_2_7_doc/ab2cd stop
    

Precaución - 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:

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:

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:

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.

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

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

  4. 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
  5. 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/.

  6. 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/).

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

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

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

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

  5. 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/).

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

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

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

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