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

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 de 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 utiliza /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 de 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 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
  5. 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/.

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

  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