test

Instalación y administración de servidores AnswerBook2

Ejecución del servidor deAnswerBook2 como un proceso CGI

De forma predeterminada, el servidor de documentación AnswerBook2 se ejecuta como un módulo NSAPI sobre el servidor httpd incluido 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 de 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:

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

Para cambiar 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. Inhabilite el inicio automático del servidor AnswerBook2 al rearrancar el sistema.

    Utilice la página Modificar configuración del servidor de la página Administración de AnswerBook2 o el comando siguiente:


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

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

  3. 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 detalles concretos, 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.

  4. Enlace los documentos de ayuda de AnswerBook2 a la raíz de documentación actual.

    Vaya al directorio raíz de documentación de su servidor Web y cree un enlace simbólico (blando) a /usr/lib/ab2/data/docs/.

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


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

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

    La documentación de su servidor Web debería explicar detalles concretos, tales como dónde encontrar el archivo de configuración. Necesita cambiar la entrada para /ab2/ a /usr/lib/ab2/bin/ab2bin/nph-dweb/ab2/.

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

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

Para cambiar a Sun Web Server mediante CGI

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 instaló SUNWab2u en la ubicación predeterminada (/usr/), todas las rutas de acceso que comiencen por /usr/lib/ab2/ deben ser aquélla en la que instaló los archivos (por ejemplo, /usr2/lib/ab2/).

  1. Inhabilite el inicio automático del servidor AnswerBook2 y apague éste.

    Utilice los comandos siguientes:


    # /usr/lib/ab2/bin/ab2admin -o autostart_no
# /usr/lib/ab2/bin/ab2admin -o stop

  2. Edite el archivo /etc/http/httpd.conf y en la sección server de éste coloque la línea siguiente:


    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 como valor predeterminado 8888.

  3. Vaya al directorio /var/http/demo/public/ y añada el enlace simbólico:


    # ln -s /usr/lib/ab2/data/docs/Help Help

    Para verificar sus cambios, escriba 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 como valor predeterminado 8888.

  4. Vaya al directorio /var/http/demo/cgi-bin/ y cree los enlaces simbólicos:


    # ln -s /usr/lib/ab2/bin/ab2bin/admin
# ln -s /usr/lib/ab2/bin/ab2bin/nph-dweb
# ln -s /usr/lib/ab2/bin/ab2bin/gettransbitmap
# ln -s /usr/lib/ab2/bin/ab2bin/getepsf
# ln -s /usr/lib/ab2/bin/ab2bin/getframe
# ln -s /usr/lib/ab2/bin/ab2bin/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 como valor predeterminado 8888.

  5. Edite el archivo /etc/http/httpd.conf y agregue la entrada siguiente en la sección host del archivo:


    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 como valor predeterminado 8888.

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


    setenv servertype sws 
setenv errorlog 
setenv accesslog /var/http/logs/http.elf.1
Para cambiar a Netscape Server mediante CGI

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 instaló SUNWab2u en la ubicación predeterminada ( /usr/), todas las rutas de acceso que comiencen por /usr/lib/ab2/ deben ser aquélla en la que instaló los archivos (por ejemplo, /usr2/lib/ab2/).

  1. Inhabilite el inicio automático del servidor AnswerBook2 y apague éste.

    Utilice los comandos siguientes:


    # /usr/lib/ab2/bin/ab2admin -o autostart_no
# /usr/lib/ab2/bin/ab2admin -o stop

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

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

  3. Vaya al directorio /ul/netscape/suitespot/docs/ y coloque el enlace simbólico:


    # 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:port/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 como valor predeterminado 8888.

  4. Vaya al directorio /ul/netscape/suitespot/cgi-bin y cree los enlaces simbólicos:


    # ln -s /usr/lib/ab2/bin/ab2bin/admin
# ln -s /usr/lib/ab2/bin/ab2bin/nph-dweb
# ln -s /usr/lib/ab2/bin/ab2bin/gettransbitmap
# ln -s /usr/lib/ab2/bin/ab2bin/getepsf
# ln -s /usr/lib/ab2/bin/ab2bin/getframe
# ln -s /usr/lib/ab2/bin/ab2bin/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 como valor predeterminado 8888.

  5. Edite el archivo /ul/netscape/suitespot/httpd-threads1/config/obj.conf y agregue la entrada:


    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 como valor predeterminado 8888.

  6. Edite el archivo /usr/lib/ab2/bin/ab2bin/nph-dweb y cambie las entradas:


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