Suplemento de instalación y configuración

Apéndice C. Configuración de documentación de DB2 en un servidor Web

Este apartado describe el modo en que pueden servirse los archivos de documentación en línea de DB2 Universal Database desde una máquina central.

Sin un servidor Web, debe almacenar los archivos en cada una de las máquinas en las que desea leer la documentación de DB2, o ponerlos a disposición de una unidad de red.


Consideraciones para utilizar un servidor Web

Puede decidir si configurar un servidor Web centralizado para la documentación de DB2, instalar la documentación en cada una de las máquinas o utilizar una combinación de ambos métodos:

Ventajas de un servidor Web

Desventajas de un servidor Web

Cómo trabajar con archivos de documentación de DB2 Universal Database en un entorno de cliente/servidor

Para configurar la documentación de DB2 Universal Database en un servidor central, debe efectuar los pasos siguientes:

  1. Instale un servidor de DB2, un servidor de DB2 o un producto DB2 Connect y seleccione la opción de instalar la documentación.
  2. Como opción, puede personalizar los archivos de HTML que haya instalado. La página de información de DB2 se denomina index.htm y está ubicada en el subdirectorio doc\html del producto. En función del conjunto de productos que haya instalado, es posible que parte de los enlaces de este archivo apunten a manuales inexistentes. Puede eliminar estos enlaces si no desea instalar los manuales en el servidor central. También puede añadir sus propios enlaces a los recursos locales, por ejemplo su propio manual de operaciones o escritorio de ayuda. La página de información de DB2 contiene asimismo un campo de Búsqueda en el que puede entrar frases o términos de búsqueda.
    Nota:Tenga en cuenta que es posible que los releases de servicio de DB2 incluyan una versión actualizada de la página de Información de DB2, por tanto asegúrese de conservar una copia de seguridad de los cambios que haya efectuado.
  3. Como opción, es posible que desee mover o copiar los archivos de HTML de DB2 Universal Database:

    Para copiar los archivos en la misma máquina, puede utilizar un mandato que preserve la estructura de directorios, por ejemplo, xcopy o cp -r. Es importante preservar la estructura de directorios original, ya que los archivos de manual utilizan enlaces relativos para volver a la lista de manuales y la lista de manuales utiliza enlaces relativos a cada manual.

    Para copiar los archivos a una máquina diferente, puede utilizar una herramienta de archivo, como por ejemplo, pkzip o tar. Una vez más, utilice las opciones que preserven la estructura de directorios en la ubicación nueva.

    Si acaba de transferir unos pocos manuales, puede utilizar ftp para transferir el archivo index.htm y todos los archivos en algunos de los subdirectorios de manual. Los archivos deben transferirse en binario de modo que se preserven los archivos *.gif y los caracteres nacionales, como por ejemplo las letras acentuadas.

  4. Como opción en los sistemas operativos Windows y OS/2, es posible que desee personalizar el Centro de información.

    El Centro de información de DB2 utiliza un conjunto de archivos de correlación para localizar la información en línea que se visualiza. Por omisión, busca la información de HTML en línea del árbol de subdirectorios doc\html del directorio en el que esté instalado DB2. Si mueve los archivos de HTML, por ejemplo a un servidor Web o a una unidad de la red, el Centro de información sólo puede encontrarlos si se actualizan los archivos *.ndx. En el directorio sqllib\help de DB2, busque los archivos que tengan la extensión *.ndx. Cada uno de ellos representa una página del cuaderno del Centro de información.

    Para actualizar el Centro de información para buscar la información en línea en la unidad x:, edite cada archivo *.ndx de modo sucesivo. Asegúrese de utilizar un editor que maneja Unicode. Cambie todas las ocurrencias de la serie file:///%DB2PATH%/doc/html para reflejar la ubicación nueva de los archivos de HTML. Por ejemplo, para un servidor Web, puede cambiar la serie por http://servername/path/to/db2/docs. Para una unidad de red, puede cambiar la serie por file:///x:/path/to/db2/docs. Es importante preservar la estructura de directorios en el lugar en el que estén ubicados los archivos, ya que el Centro de información espera que, por ejemplo, los archivos de SQL Reference estén en un directorio denominado db2s0 y así sucesivamente.


Escenarios habituales del servidor Web

Aunque puede utilizar el servidor Web básico que acompaña a NetQuestion, por motivos de seguridad le recomendamos encarecidamente que utilice un servidor Web "real", por ejemplo, Apache o Lotus Domino Go!, para ofrecer documentación de DB2 a los clientes remotos.

Las secciones siguientes describen algunas de las formas en que puede poner la documentación de DB2 en un servidor central, con los detalles para servidores Web y plataformas concretas. Si utiliza un servidor Web o una plataforma diferente, debe hallar que tiene características coincidentes que le permiten conseguir resultados análogos.

Escenario 1: Servidor Web de Lotus Domino Go! en OS/2

En este escenario, se está utilizando la máquina OS/2 como servidor DB2 y se ha decidido utilizar el servidor Web de Lotus Domino Go! para poner la documentación en línea de DB2 a disposición del resto de la intranet.

Instalar la documentación de DB2 Universal Database
La documentación de DB2 se instala junto con el servidor de DB2 Enterprise Edition, en la unidad E:. Los archivos de HTML están ubicados en el subdirectorio e:\sqllib\doc\html. La documentación del servidor incluye manuales como, por ejemplo, Consulta de SQL, Consulta de mandatos, Guía de iniciación de SQL, Administration Guide y el manual Guía rápida de iniciación para el servidor en concreto. Puesto que el servidor de Enterprise incluye la función de DB2 Connect y su documentación, también debe hacerse con el manual DB2 Connect User's Guide y con el manual DB2 Connect Enterprise Edition Quick Beginnings for OS/2 and Windows NT. Suponga que su empresa no efectúa ningún desarrollo de aplicación, por lo que no ha de instalarse el DB2 Personal Developer's Edition, lo que incluye los manuales de programación como por ejemplo Administrative API Reference.

Instalar el servidor Web
Se ha de instalar el servidor Web de Lotus Domino Go desde su CD-ROM de instalación. En este escenario, se asume que el servidor Web está instalado en c:\www y que el nombre de sistema principal de TCP/IP es udbserv.

Poner la documentación de DB2 UDB a disposición del servidor Web
Para servir archivos desde el directorio de DB2, se ha de añadir una línea como la siguiente al archivo c:\www\httpd.cnf:
Pass /db2docs/* e:\sqllib\doc\html\*

Asegúrese de que va delante de la línea:

Pass /* document_root\*

Después, se ha de reiniciar el servidor Web.

O bien, para copiar los archivos en el directorio del servidor Web, se ha de utilizar el mandato xcopy con la opción /s para copiar e:\sqllib\doc\html\*.* en el directorio c:\www\html\db2docs. Los usuarios pueden acceder en este momento a la documentación de DB2 dirigiéndose al URL http://udbserv/db2docs/index.htm.

Personalizar (Opcional)
Más adelante, es posible que se reciba una llamada telefónica de un usuario que haya intentado seleccionar API Reference y que se haya recibido un error de "archivo no encontrado" debido a que dicho manual no estaba presente en el servidor Web. Otro usuario ha intentado seleccionar el manual Guía rápida de iniciación para UNIX y ha obtenido un error parecido. Puede editarse el archivo e:\sqllib\doc\html\index.htm, eliminando los enlaces a los manuales de programación y cambiando los enlaces a los manuales de Guía rápida de iniciación de Windows y UNIX para que apunten a un servidor Web de intranet diferente que tenga instalados dichos manuales.

Puesto que la empresa tiene su propio escritorio de ayuda para problemas de base de datos, ha de añadirse el número de teléfono del escritorio de ayuda y un enlace mailto: al archivo index.htm. Tenga en cuenta que es posible que los releases de servicio de corrección incluyan una versión actualizada de index.htm, por lo que ha de comprobar si conserva una copia de seguridad de los cambios que haya efectuado.

Escenario 2: Servidor Web de Netscape Enterprise en Windows NT

El usuario es un administrador del sistema que está ejecutando el servidor de Netscape Enterprise en Windows NT. Está comenzando a implantar DB2 Universal Database y todavía no ha decidido si combinará el servidor de bases de datos y el servidor Web en una única máquina, o utilizar servidores independientes.

Instalar la documentación de DB2 Universal Database
En este sistema, DB2 está instalado en la unidad E:, por lo que todos los archivos de HTML están almacenados en e:\sqllib\doc\html.

Instalar el servidor Web
Para probar el rendimiento de un servidor de bases de datos y una Web combinados, puede instalarse el servidor Web de Netscape Enterprise en el mismo sistema, denominado udbserv en la intranet de la empresa. El servidor Web se ha instalado en la unidad H:.

Hacer disponible la documentación de DB2
Inicialmente, el servidor Web sólo contiene la documentación de DB2, por lo que se desea que la página inicial por omisión de http://udbserv/ visualice el archivo e:\sqllib\doc\html\index.htm, que es la página de Información de DB2. Para hacer disponible la documentación de DB2:
  1. Se ha de ejecutar el programa Administer Netscape Servers en la carpeta Netscape y elegir udbserv como servidor.
  2. En Content Mgmt, cambie el Primary Document Directory por e:\sqllib\doc\html.
  3. Se ha de utilizar Document Preferences para añadir index.htm como uno de los nombres de documento por omisión de modo que el navegador visualice index.htm en vez de una lista de archivos en el directorio.

Más adelante, se decide almacenar otros archivos de HTML en el servidor Web y configurar el servidor de modo que los manuales de DB2 estén ubicados en http://udbserv/db2docs/:

  1. Ha de volverse a cambiar el Primary Document Directory a un directorio general, por ejemplo, h:\netscape\server\docs.
  2. En Content Mgmt, se ha de seleccionar Additional Document Directories y correlacionar el subdirectorio db2docs con e:\sqllib\doc\html.
  3. En la nueva página por omisión para el servidor Web, se ha de añadir un enlace al directorio db2docs:
    <a href="db2docs/index.htm">DB2 Information</a>
    

Transferir archivos (Opcional)
Con el tiempo, la carga del servidor de bases de datos y de la web combinados llega a ser demasiado grandes y se decide transferir el servidor Web a una máquina diferente. Se utiliza una herramienta de archivo, como por ejemplo, pkzip o una versión de Windows de tar para empaquetar el árbol de directorios en e:\sqllib\doc\html. Restaure todos los archivos en cualquier parte de la máquina de servidor Web, después configure el servidor Web como antes para servir los archivos de HTML.

En un sistema diferente, se decide desinstalar el servidor de DB2 y hacer que los archivos de HTML sigan estando a disposición del servidor Web. Antes de desinstalar el servidor, ha de utilizarse el mandato xcopy para copiar el árbol de directorios e:\sqllib\doc\html en h:\netscape\server\docs\db2docs, después ha de eliminarse la correlación del servidor Web para el directorio de documentos adicional denominado db2docs.

Escenario 3: Microsoft Internet Information Server en Windows NT

En este escenario, se está utilizando Windows NT 4.0 como servidor DB2 y se ha decidido utilizar Internet Information Server (IIS) para poner la documentación en línea de DB2 a disposición del resto del grupo de trabajo. IIS está disponible con Windows NT 4.0 Server, pero también se ejecuta en Windows NT 4.0 Workstation.

También puede configurar Peer Web Services (PWS), que está disponible con Windows NT 4.0 Workstation, pero puede instalarse en Windows NT 4.0 Server utilizando las instrucciones siguientes.

Instalar la documentación de DB2 Universal Database
Instale la documentación de DB2 en el mismo directorio que en los escenarios anteriores: e:\sqllib\doc\html.

Instalar el servidor Web
Si IIS no está instalado al mismo tiempo que el sistema Windows NT, instálelo desde el CD-ROM de instalación de Windows NT. Abra el diálogo Servicios en el Panel de control para iniciar este servicio de modo automático.

Poner la documentación de DB2 a disposición del servidor Web
Ejecute Internet Service Manager en la carpeta de Microsoft Internet Information Server del menú Inicio, dirigiéndose a la sección WWW y después a la subsección Directorios. Edite la entrada de directorio inicial para cambiar la vía de acceso de c:\inetpub\wwwroot a e:\sqllib\doc\html y el documento por omisión a index.htm. Más adelante, si necesita servir otros documentos así como los manuales de DB2, cambie el documento inicial de nuevo a c:\inetpub\wwwroot y añada un nuevo directorio virtual denominado db2docs.

Personalizar (Opcional)
Si desea utilizar el recurso de búsqueda incorporado de IIS, debe sustituir el archivo e:\sqllib\doc\html\index.htm por el archivo inetpub\samples\isapi\srch.htm, y copie los archivos de HTML de DB2 tal y como se explica a continuación.

Copiar archivos (Opcional)
Para utilizar el recurso de búsqueda incorporado de IIS, copie los archivos de HTML de DB2 en el árbol de directorios c:\inetpub\wwwroot. Cree un directorio denominado db2docs y utilice el mandato xcopy /s para preservar la estructura de directorios durante la copia. Elimine el directorio virtual db2docs para que se utilicen los archivos que hay bajo el directorio db2docs real.

Cómo servir la documentación en varios idiomas

Para servir las versiones convertidas de la documentación en línea de DB2 en la Web, es posible que prefiera arrancar con un servidor de UNIX, en el que puede utilizar enlaces simbólicos en vez de efectuar varias copias de archivos y directorios.

Cuando instale DB2 en un servidor UNIX, puede seleccionar uno o más idiomas para la biblioteca de productos en línea. Los manuales de HTML en inglés (en_US) siempre se instalan con los manuales en cualquier otro idioma, ya que algunos manuales sólo están disponibles en inglés.

La instalación por medio del programa de utilidad db2setup crea un subdirectorio doc/html que contiene un enlace a cada archivo de HTML individual o manual traducido, o el manual en inglés si no se dispone de una versión traducida.

El subdirectorio doc/html puede encontrarse en las vías de acceso siguientes de los sistemas UNIX:

Esta acción proporciona una ubicación bien conocida para la documentación de DB2, sin tener en cuenta el idioma elegido.

Si efectúa la instalación por medio de smit o de otra herramienta de instalación del sistema operativo nativo en vez del programa de utilidad db2setup, debe seguir las instrucciones del manual DB2 para UNIX Guía rápida de iniciación para ejecutar el mandato db2insthtml. Debe ejecutar este mandato para cada idioma en el que ha instalado la documentación de DB2.

Por ejemplo, si ha utilizado smit en AIX para instalar la documentación en inglés, alemán y francés, debería ejecutar estos mandatos a continuación.

   cd /usr/lpp/db2_07_01/doc
   db2insthtml en_US
   db2insthtml de_DE
   db2insthtml fr_FR
 

Especificar el escenario fr_FR en último lugar significa que los enlaces de /usr/lpp/db2_07_01/doc/html apuntarán a las versiones en francés de los archivos que han sido traducidos al francés y a los archivos en inglés para los que no lo han sido. Al ejecutar el mandato db2insthtml para varios idiomas, ejecútelo siempre para en_US en primer lugar.

Ejemplo 1: Inglés y japonés
Si desea configurar un servidor Web para los usuarios que sólo hablan japonés, o una mezcla de japonés e inglés. Puesto que sólo hay dos idiomas implicados, puede seleccionar tanto el inglés como el japonés para la Biblioteca de productos y configurar un directorio virtual en el servidor que apunte al subdirectorio doc/html, que tiene enlaces a todos los manuales en japonés y a los manuales en inglés en los casos en que no se disponga de una versión traducida. El archivo index.htm de este directorio proporciona una lista de todos los manuales de producto y es el lugar en el que comenzar a buscar información.

Ejemplo 2: Inglés, japonés y sueco
Ahora, desea configurar un servidor Web para los usuarios que hablan una mezcla de japonés, inglés y sueco. Los manuales en japonés están en el subdirectorio doc/ja_JP/html, los manuales en inglés están en el subdirectorio doc/en_US/html y los manuales en sueco están en el subdirectorio doc/sv_SE/html. Los directorios en japonés y en sueco tienen enlaces simbólicos para que los manuales que no se hayan traducido se visualicen en inglés.

Cómo ofrecer documentación para varias plataformas

Si los usuarios tienen una combinación de estaciones de trabajo OS/2, Windows NT y UNIX, es posible que desee reunir los manuales para diversas plataformas en un único servidor Web. Una vez más, instalar DB2 en un servidor basado en UNIX es el punto de arranque más sencillo, ya que viene con más manuales que para los productos del servidor de DB2 para OS/2 o DB2 para Windows NT

Cada plataforma o producto de DB2 viene con su propio manual Guía rápida de iniciación. Para reunir todos estos manuales, debe obtenerlos de los diferentes productos. Puede encontrar estos manuales en los subdirectorios doc\html de los CD-ROM de producto, por lo que puede obtenerlos sin llegar a instalar los servidores.


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]