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 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 WebServer).


Nota -

Para cambiar el comportamiento del servidor a este nivel se asume que se poseen conocimientos de "experto" de la web. No debe intentar realizar esta tarea a menos que esté completamente familiarizado con la configuración y los requisitos únicos de su servidor web.


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

Nota -

No es posible documentar aquí todas las configuraciones posibles de los servidores web, ya que la tecnología de estos servidores cambia rápidamente. Como resultado de esto, el procedimiento general siguiente es una directriz sobre qué hacer. Antes de realizar este procedimiento debe estar completamente familiarizado con la configuración y los requisitos únicos de su 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).

  1. Inhabilite el inicio automático del servidor AnswerBook2 cuando se rearranque el sistema.

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


    # /usr/lib/ab2/bin/ab2admin -o autostart_no
    
  2. Deesactive el control de acceso de administración para el servidor de documentos predeterminado.

    Utilice el comando siguiente:


    # /usr/lib/ab2/bin/ab2admin -o access_off
    
  3. 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
    
  4. 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, como, por ejemplo, dónde encontrar el archivo de configuración. Debe modificarse la entrada /icons/ para que apunte 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.

    Reinicie su servidor cuando haya realizado este cambio.

    Para verificar sus cambios, escriba 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.

  5. Enlace los documentos de ayuda de AnswerBook2 con 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) con /usr/lib/ab2/data/docs/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/AB2ADMIN/figures/ab2_help.gif
    

    donde puerto es el número de puerto en que se está ejecutando su servidor de documentación.

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

    Vaya al directorio cgi-bin de su servidor de web y cree enlaces simbólicos:


    /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

    Para verificar sus cambios, escriba el URL siguiente en su navegador de web para ver la página 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.

  7. Edite el archivo de configuración de su servidor y reasigne /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/ab2bin/nph-dweb/ab2/.

    Para verificar los cambios, reinicie su servidor y escriba el URL siguiente en su navegador de web para ver la página 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.

  8. Si desea que los usuarios puedan acceder al servidor de documentación sin tener que especificar /ab2 al final del URL, edite el archivo de configuración del servidor y reasigne / a /ab2/.

    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. Necesita cambiar la entrada de / a /ab2/ y agregar un indicador remote a la reasignación.

    Para verificar los cambios, reinicie su servidor y escriba el URL siguiente en su navegador de web para ver la página Biblioteca de AnswerBook2:


    http://localhost:puerto
    

    donde puerto es el número de puerto en que se está ejecutando su servidor de documentación.

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

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


    setenv servertype tipo_servidor
    setenv errorlog ruta_completa_a_registro_errores
    setenv accesslog ruta_completa_a_registro_acceso
    

    donde:

    • tipo_servidor identifica el servidor que está ejecutando, como sws.

    • ruta_completa_a_registro_errores es la ruta al registro de errores de su servidor de web.

    • ruta_completa_a_registro_acceso es la ruta al registro de acceso de su servidor de web.

  10. Defina el control de acceso en la interfaz de administración de AnswerBook2.

    Para controlar quién puede realizar las funciones de administración en el servidor de documentos, utilice los mecanismos de control de acceso apropiados de su servidor http para restringir el acceso al URL siguiente: /ab2/@Ab2Admin