Instalación y administración de servidores AnswerBook2

Configuración del servidor de documentación

Para ver la configuración actual del servidor, seleccione Ver configuración actual en la página de administración de AnswerBook2. Para cambiar estos valores, seleccione Modificar configuración del servidor en esa página.

Visualización de la configuración del servidor de documentación

La página Ver configuración actual enumera los valores que se muestran en Tabla 3-1y Tabla 3-2. Estos valores están almacenados en el archivo ruta_configuración_servidor/dwhttpd.cfg (que es /usr/lib/ab2/dweb/data/config/dwhttpd.cfg de forma predeterminada).


Nota -

Si ejecuta un servidor basado en CGI en lugar del servidor predeterminado basado en NSAPI, sólo estarán visibles algunas opciones de configuración en la interfaz de la página de administración. Para más información, véase "Cuestiones de configuración al ejecutar el servidor como un proceso CGI".


Tabla 3-1 Valores de configuración del servidor configurables por el usuario

Etiqueta 

Valor predeterminado y descripción 

Nombre del servidor 

Predeterminado: Nombre local del sistema (por ejemplo: imaserver). Es el nombre que utilizan los clientes para acceder a los documentos de este servidor. Para mejorar el tiempo de respuesta, asígnele un nombre completo (por ejemplo: imaserver.eng.sun.com). Si desea que personas externas a su dominio tengan acceso al servidor, debe asignarle un nombre completo.

Puerto del servidor 

Predeterminado: 8888. Es el número de puerto para comunicaciones. Puede seleccionar cualquier número de puerto que no se utilice, pero se recomienda utilizar el predeterminado.

Número máximo de subprocesos 

Predeterminado: 32. Es el número máximo de búsquedas simultáneas de AnswerBook1 que realizará el servidor. Si tiene muchas colecciones AnswerBook1 y los usuarios realizan búsquedas en ellas con frecuencia, posiblemente desee incrementar este número; sin embargo, esto puede aumentar el tiempo de respuesta de su servidor.

Número máximo de solicitudes al servidor 

Predeterminado: 1024. Este valor indica al servidor que realice actividades de "mantenimiento" y vuelva a iniciarse por sí mismo después del número de solicitudes de http especificadas.

Archivo de accesos 

Predeterminado:/var/log/ab2/logs/access-8888.log. Es la ruta de acceso completa al registro de accesos que contiene la información sobre todos los accesos efectuados al servidor local.

Archivo de errores 

Predeterminado: /var/log/ab2/logs/error-8888.log. Es la ruta de acceso completa al registro de errores que contiene información acerca de los posibles errores ocurridos.

Control del acceso administrativo 

Predeterminado: Activado. Indica si controla quién tiene acceso a las funciones de administración de este servidor. Cuando se instala un servidor de documentos, no hay definido ningún nombre de usuario o contraseña predeterminados, aunque el control del acceso administrativo está activado. Para obtener información sobre la configuración inicial del acceso de administración, consulte "Configuración inicial del acceso administrativo".

 Iniciar automáticamente el servidor de AnswerBook2 después del rearranque

Predeterminado: . Determina si el software del servidor de AnswerBook2 se inicia automáticamente al rearrancar el sistema.


Nota -

El administrador de documentos no debería cambiar manualmente los valores que se muestran en Tabla 3-2. El sistema configura estos valores cuando se instala el software de servidor.


Tabla 3-2 Valores de configuración del servidor fijos

Etiqueta 

Valor predeterminado y descripción 

Ruta de configuración del servidor 

Predeterminado: /usr/lib/ab2/dweb/data/config

Es el nombre de ruta donde se almacenan los archivos de configuración de este servidor. 

Usuario del servidor 

Predeterminado: daemon

Es el propietario del proceso del servidor. Si cambia el valor de esta variable puede crear problemas importantes al ejecutar el servidor o al acceder a las colecciones ubicadas en él.  

Archivo de módulos 

Predeterminado: /usr/lib/ab2/dweb/data/config/nsapi.cfg

Es el nombre de ruta de acceso completo al archivo que define todos los módulos del servidor. 

Archivo de tipos Mime 

Predeterminado: /usr/lib/ab2/dweb/data/config/mime.types

Es el nombre de ruta de acceso completo al archivo que define toda la información de MIME. 

Raíz de los documentos 

Predeterminado: /usr/lib/ab2/data/docs

Es el nombre de ruta de acceso donde están almacenados los archivos de documentos de este servidor. 

Directorio de registro 

Predeterminado: /var/log/ab2/logs

Es el nombre de ruta de acceso donde están almacenados los archivos de registro de este servidor. 

Base de datos de colecciones de AnswerBook1 

Predeterminado: /var/log/ab2/catalog/ab1_cardcatalog

Este archivo identifica las colecciones de AnswerBook1 instaladas en el servidor. 

Base de datos de colecciones de AnswerBook2 

Predeterminado: /usr/lib/ab2/dweb/data/config/ab2_collections.template

Este archivo identifica las colecciones de AnswerBook2 instaladas en el servidor. 

Puede también utilizar el siguiente comando para visualizar la configuración actual del servidor:


% /usr/lib/ab2/bin/ab2admin -o view_config [-m nombre_servidor] [-p puerto_servidor]

Cambio de la configuración del servidor de documentación

Al instalar el software de servidor AnswerBook2, a ciertas variables se les asignan valores predeterminados; para cambiar éstos utilice los campos de la página Modificar configuración del servidor. Puede cambiar los valores del servidor que se enumeran en la tabla siguiente:

Tabla 3-3 Modificar configuración del servidor

Nombre del servidor 

Cuando se instala el servidor de documentación, el software AnswerBook2 define automáticamente esta variable al nombre del sistema actual (por ejemplo, gatos). Si desea que los usuarios externos a su dominio puedan acceder a los documentos de este servidor, cambie el nombre por uno completo (por ejemplo, gatos.casa.animales.com).

Número de puerto del servidor 

Para utilizar un puerto distinto de 8888 para el servidor de AnswerBook2, introduzca el número de puerto en este campo. Para utilizar un número de puerto inferior a 1024, necesitará llevar a cabo algunos pasos adicionales. Para más información, véase "Uso de un número de puerto inferior a 1024".

Número máximo de subprocesos 

Es el número máximo de búsquedas simultáneas de AnswerBook1 que realizará el servidor. Si tiene muchas colecciones AnswerBook1 y los usuarios realizan búsquedas en ellas con frecuencia, posiblemente desee incrementar este número; sin embargo, esto puede aumentar el tiempo de respuesta del servidor. 

Número máximo de solicitudes al servidor 

Indica al servidor cada cuándo debe realizar las actividades de "mantenimiento" y reiniciarse. El número indica la cantidad de solicitudes http efectuadas al servidor.

Archivo de registro de accesos 

Haga clic en el elemento apropiado para activar o desactivar el registro de acceso. Si prevé que muchos usuarios accederán a su servidor de documentación, es posible que desee guardar y reiniciar periódicamente este archivo de registro. Para más información acerca del cambio rotatorio del archivo de registro, véase "Rotación de archivos de registro".

Archivo de registro de errores 

Haga clic en el elemento apropiado para activar o desactivar el registro de errores. Si experimenta gran cantidad de errores de servidor, es posible que necesite guardar y reiniciar el archivo de registro de forma periódica. Para obtener más información acerca del cambio rotatorio del archivo de registro, véase "Rotación de archivos de registro".

Control del acceso administrativo  

Haga clic en el elemento apropiado para activar o desactivar el control del acceso administrativo. Cuando éste está activado, únicamente los usuarios con acceso administrativo definido pueden efectuar funciones de administración en el servidor.  

Iniciar automáticamente el servidor de AnswerBook2 después del rearranque del sistema 

Haga clic en el elemento apropiado para activar o desactivar esta función. 

Se puede también acceder a dichas funciones mediante la interfaz de línea de comandos de administración (ab2admin). Para obtener información detallada sobre la interfaz de línea de comandos, véase Apéndice A. También puede editar el archivo ruta_configuración_servidor/dwhttpd.cfg (de forma predeterminada, /usr/lib/ab2/dweb/data/config/dwhttpd.cfg) para modificar estos valores.


Nota -

Si cambia cualquiera de estos valores, debe parar e iniciar el sevidor de documentación. Inicie una sesión de usuario root en la máquina del servidor y escriba los comandos siguientes:


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

Uso de un número de puerto inferior a 1024

Los números de puerto inferiores a 1024 están reservados para su uso por el sistema. Para utilizar uno de estos números (por ejemplo, el número de puerto 80) para el servidor de AnswerBook2:

  1. Utilice la función Modificar valores de configuración en la página de administración de AnswerBook2 o edite el archivo /usr/lib/ab2/dweb/data/config/dwhttpd.cfg y cambie el número de puerto del servidor a 80.

  2. Edite el archivo /usr/lib/ab2/dweb/data/config/nsapi.cfg y cambie el número de puerto del servidor a 80.

    Debería tener una línea con un aspecto similar a:


    set ServerPort 80
  3. Edite el archivo /etc/init.d/ab2mgr y cambie daemon a root en la línea siguiente:


    su daemon -c "LD_PRELOAD=$pre_load;LANG=$LNG;AB2_ORIG_LANG=$ORGLNG;LD_LIBRARY_PATH=$LD_LIBP;EBT_REGISTRY=$ER;export LD_PRELOAD LD_LIBRARY_PATH LANG AB2_ORIG_LANG LC_ALL 
    EBT_REGISTRY; $AB2BIN/dwhttpd $AB2CFG > /dev/null"

    a esto:


    su root -c "LD_PRELOAD=$pre_load;LANG=$LNG;AB2_ORIG_LANG=$ORGLNG;LD_LIBRARY_PATH=$LD_LIBP;EBT_REGISTRY=$ER;export LD_PRELOAD LD_LIBRARY_PATH LANG AB2_ORIG_LANG LC_ALL EBT_REGISTRY; $AB2BIN/dwhttpd $AB2CFG 
    > /dev/null"

    Este cambio permite que el proceso dwhttpd antecesor se ejecute como root; así se puede utilizar el puerto 80. Observe que el proceso dwhttpd sucesor todavía se ejecuta como daemon.

Cuestiones de configuración al ejecutar el servidor como un proceso CGI

El servidor de AnswerBook2 sigue los protocolos de web estándar, de forma que puede ejecutarlo como un proceso de CGI en un servidor existente, en lugar de en el servidor NSAPI predeterminado. Para obtener información sobre cómo configurar su servidor para que se ejecute de esta forma, véase "Ejecución del servidor deAnswerBook2 como un proceso CGI".

Si ejecuta su servidor de documentación como un proceso CGI, no aparecerán los valores de configuración siguientes en la página Ver valores de configuración de la página de administración de AnswerBook2:

La única opción disponible en la página Modificar configuración del servidor será activar o desactivar el control de acceso. No aparecerán el resto de funciones.

Las opciones siguientes del comando ab2admin no funcionarán: