Instalación y administración de servidores AnswerBook2

Configuración del servidor de documentación

Para visualizar la configuración actual del servidor, seleccione Ver configuración actual en la página Aadministración de AnswerBook2. Para cambiar estos valores, seleccione Modificar configuración del servidor en la página Administración de AnswerBook2.

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

La página Ver configuración actual muestra los valores que aparecen en las tablas Tabla 3-1 y Tabla 3-2. Estos valores se encuentran en el archivo ruta_config_servidor/dwhttpd.cfg (situado de forma predeterminada en /usr/lib/ab2/dweb/data/config/dwhttpd.cfg).


Nota -

Si ejecuta un servidor basado en CGI en lugar del servidor predeterminado basado en NSAPI, sólo algunas opciones de configuración del servidor estarán visibles en la interfaz de la página Administración. Para más información, véase "Cuestiones de configuración cuando se ejecuta 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 del sistema local (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 completamente cualificado (por ejemplo: imaserver.eng.sun.com). Si desea que usuarios ajenos a su dominio tengan acceso al servidor, debe asignarle un nombre completamente cualificado.

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 de AnswerBook1 simultáneas que realizará el servidor. Si posee gran cantidad de colecciones de AnswerBook1 en las que se efectúan búsquedas con mucha frecuencia, es conveniente que aumente este número; sin embargo, esto puede ralentizar el tiempo de respuesta del servidor.

Número máximo de solicitudes al servidor 

Predeterminado: 1024. Este valor indica al servidor que efectúe 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 de acceso de administración 

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

 Inicio automático del servidor AnswerBook2 después del rearranque

Valor predeterminado: yes. Esto determina si se iniciará automáticamente el software de servidor AnswerBook2 al rearrancar el sistema.


Nota -

El administrador de documentos no debería cambiar manualmente los valores que se muestran en la tabla Tabla 3-2. El sistema configura estos valores al instalar 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 de acceso hacia donde están almacenados los archivos de configuración para este servidor. 

Usuario del servidor 

Predeterminado: daemon

Es el propietario del proceso del servidor. Si cambia el valor de esta variable puede crear problemas significativos 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 hacia donde están almacenados los archivos de documento para este servidor. 

Directorio de registro 

Predeterminado: /var/log/ab2/logs

Es el nombre de ruta de acceso hacia donde están almacenados los archivos de registro para 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_serv] [-p puerto_serv]

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

Al instalar el software de servidor AnswerBook2, se asignan valores predeterminados a ciertas variables. Para cambiarlos utilice los campos de la página Modificar configuración del servidor. Puede modificar los siguientes valores de configuración del servidor relacionados en la siguiente tabla:

Tabla 3-3 Modificar configuración del servidor

Nombre de servidor 

Al instalar el servidor de documentación, AnswerBook2 establece automáticamente esta variable como el nombre del sistema actual (por ejemplo, cats). Si desea que usuarios ajenos a su dominio puedan acceder a los documentos del servidor, cambie este nombre por otro completamente cualificado (por ejemplo, cats.house.pets.com ).

Número puerto de servidor 

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

Subprocesos máximos 

Es el número máximo de búsquedas AnswerBook1 simultáneas que se ejecutará en el Answebook1. Si posee varias colecciones de AnswerBook1 en las que se efectúan búsquedas con mucha frecuencia, es conveniente que aumente este número: sin embargo, esto puede ralentizar el tiempo de respuesta del servidor. 

Solicitudes de servidor máximas 

Indica al servidor la frecuencia de la realización de actividades de 'mantenimiento' y su reinicio. El número indica la cantidad de solicitudes http al servidor.

Acceso a archivo de registro 

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, quizás 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, acaso 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 de acceso administrativo 

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

Iniciar el servidor AnswerBook2 automáticamente 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 más información sobre la interfaz de línea de comandos, véase Apéndice A. También puede editar el archivo ruta_config_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 servidor de documentación. Entre como 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 por debajo de 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 AnswerBook2:

  1. Utilice la función Modificar valores de configuración de la página 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.

    Debe tener una línea como ésta:


    set ServerPort 80
  3. Edite el archivo /usr/lib/ab2/dweb/data/config/nsapi.cfg y cambie la línea siguiente de daemon a root:


    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;LD_LIBRARY_PATH=$LD_LIBP;EBT_REGISTRY=$ER;export LD_PRELOAD LD_LIBRARY_PATH LANG LC_ALL EBT_REGISTRY; $AB2BIN/
    dwhttpd $AB2CFG > /dev/null'

    Así el proceso dwhttpd de nivel superior se puede ejecutar como root, que puede a su vez utilizar el puerto 80. Observe que el proceso dwhttpd sigue ejecutándose como root.

Cuestiones de configuración cuando se ejecuta el servidor como un proceso CGI

Como el servidor AnswerBook2 sigue los protocolos estándar de Web, puede ejecutarlo como un proceso CGI en un servidor existente, en lugar de como el servidor NSAPI que se ejecuta de forma predeterminada. 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 siguientes valores de configuración en la página Ver configuración del servidor de la página de Administración AnswerBook2 :

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

Las siguientes opciones para el comando ab2admin no funcionarán: