Capítulo 3 Administración de servidores AnswerBook2

La administración del software AnswerBook2 implica llevar a cabo las funciones siguientes, cada una de las cuales incluye tareas específicas:

• "Administración del servidor de documentación"

• "Inicio y paro del servidor de documentación"

• "Activación y desactivación de la depuración de fuentes de documentos"

• "Control de acceso administrativo"

• "Manejo de colecciones de documentos"

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

• "Trabajo con otros servidores de documentación"

• "Trabajo con informes de servidor"

• "Funciones de navegación habituales de las páginas Administración"

Administración del servidor de documentación

El software AnswerBook2 proporciona dos interfaces, un navegador de Web (la página Administración de Answerbook2) y una de línea de comandos ( ab2admin) que permiten administrar el servidor de documentación. En ambas están disponibles la mayoría de funciones.

Para acceder a la página principal Administración de AnswerBook2, seleccione Administración de AnswerBook2 en la página Opciones del navegador AnswerBook2 o acceda al URL: http://servidor:puerto/ab2/@Ab2Admin, donde servidor es el nombre del servidor y puerto es el número del puerto en que se está ejecutando éste. Todas las páginas de la página Administración incluyen funciones comunes de navegación de páginas en la parte superior de la pantalla.

Para acceder a la interfaz de línea de comandos, use el comando: /usr/lib/ab2/bin/ab2admin. Para obtener más información sobre la interfaz de línea de comandos, véase Apéndice A.

Sólo los usuarios que son administradores autorizados pueden acceder a las funciones de administración. Para obtener más información, véase "Control de acceso administrativo".

Inicio y paro del servidor de documentación

El servidor puede iniciarse automáticamente (mediante la secuencia /etc/init.d/ab2mgr) cuando se arranca el sistema en que se ejecuta el servidor de documentación; también lo puede iniciar, parar y reiniciar manualmente cuando lo crea necesario. Por ejemplo, debe reiniciarlo después de instalar una nueva colección de documentos.

Para llevar a cabo estas funciones, entre en la máquina del servidor de documentación como usuario root y utilice la interfaz de línea de comandos de ab2admin.

• Para iniciar el servidor de documentación, utilice el comando siguiente:

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

• Para parar el servidor de documentación, utilice el comando siguiente:

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

• Para reiniciar el servidor de documentación, utilice el comando siguiente:

  # /usr/lib/ab2/bin/ab2admin -o restart

  Si al reiniciar el servidor no se obtiene la respuesta esperada, párelo e inícielo.

• Para iniciar el servidor de documentación con la depuración activada, utilice la forma siguiente del comando de inicio:

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

• Para evitar que se reinicie automáticamente el servidor al rearrancar el sistema, utilice este comando:

  # /usr/lib/ab2/bin/ab2admin -o autostart_no

Activación y desactivación de la depuración de fuentes de documentos

El servidor AnswerBook2 tiene una opción de depuración que, cuando está activada, muestra en color rojo las marcas no reconocidas de la fuente del manual con la palabra "DEFECTO" en el visualizador. Esta función ayuda a identificar los problemas si un manual no se visualiza de la forma esperada.

Para activar la depuración, entre en el sistema del servidor de documentación como usuario root y establezca la variable de entorno AB2_DEBUG a 1. Por ejemplo:

% su -
# setenv AB2_DEBUG 1

Para desactivar la depuración, entre en el sistema del servidor de documentación como usuario root y establezca la variable de entorno AB2_DEBUG a 0. Por ejemplo:

% su -
# setenv AB2_DEBUG 0

Después de cambiar el parámetro de depuración, debe reiniciar el servidor de documentación. Para ello, escriba:

# /usr/lib/ab2/bin/ab2admin -o restart

Para controlar la depuración al iniciar el servidor, utilice la forma siguiente del comando de inicio:

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

Control de acceso administrativo

Se considera administrador a un usuario cuando está definido específicamente para efectuar funciones de administración de documentos. El producto AnswerBook2 usa contraseñas para verificar que a un administrador dado se le permite realizar funciones administrativas en el servidor.

Configuración inicial del acceso administrativo

El software AnswerBook2 se suministra con el control de acceso activado para llevar a cabo funciones administrativas, pero sin ningún usuario predefinido como administrador. La primera vez que se intenta acceder a las funciones administrativas de AnswerBook2, el software informa de que el control de acceso está activado pero que no hay ningún usuario definido. En ese momento es posible elegir entre:

• Desactivar el control de acceso.

  Para desactivar el control de acceso, entre en la máquina del servidor de documentación como usuario root y escriba:

  # /usr/lib/ab2/bin/ab2admin -o auth_off

  ---

  Precaución -

  Si desactiva el control de acceso, cualquier usuario que pueda acceder a su servidor de documentación podrá modificarlo.

  ---

• Definir un usuario administrador y su contraseña.

  Para definir un usuario administrador, entre en la máquina del servidor de documentación como usuario root y escriba:

  # /usr/lib/ab2/bin/ab2admin -o add_admin -u id-admin

  donde id-admin es el ID de sesión para administrar este servidor de documentación. El parámetro id-admin no tiene porque coincidir con el ID de entrada al sistema del usuario; tan sólo es un ID para llevar a cabo funciones administrativas relacionadas con documentos en un servidor específico.

  El software solicita que escriba una contraseña para este usuario, que después ha de volver a escribir como verificación.

Adición de acceso para administradores de AnswerBook2

Para agregar un usuario como administrador, seleccione Agregar administrador en la página Administración de AnswerBook2. A continuación:

1. Escriba el ID de sesión del administrador en el camp ID de administrador.

   El ID de administrador no ha de coincidir con el ID de entrada al sistema del usuario; es solamente un ID de sesión para llevar a cabo funciones administrativas relacionadas con documentos en un servidor concreto.

2. Escriba una contraseña para el administrador.

   Esta contraseña se almacena en una base de datos de contraseñas de AnswerBook2. No tiene porque coincidir con la contraseña del sistema del usuario.

Deberá introducir la contraseña dos veces para verificarla.

Para llevar a cabo esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o add_admin -u id-admin [-m nombre_serv] [-p puerto_serv]

Cambio de contraseña para un administrador

Para cambiar la contraseña de un administrador, seleccione Cambiar contraseña en la página Administración de AnswerBook2. Para modificar aquélla:

1. Seleccione el usuario administrador en la lista emergente ID de administrador.

2. Escriba la contraseña existente del administrador en el campo Contraseña antigua.

3. Escriba la nueva contraseña del administrador en el campo Contraseña nueva.

4. Vuelva a escribir la nueva contraseña del administrador en el campo Vuelva a introducir la contraseña nueva.

5. Haga clic en Cambiar contraseña para aplicar este cambio.

Cuando se hace clic en Cambiar contraseña, el software AnswerBook2 comprueba que concuerden los datos introducidos en los campos Contraseña nueva y Vuelva a introducir la contraseña nueva. Si es así, la contraseña nueva se guarda en la base de datos. De lo contrario, el software muestra un mensaje de error.

Para llevar a cabo esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o change_password -u id-admin [-m nombre_serv] [-p puerto_serv]

Revocación de acceso a un administrador

Para eliminar un usuario de la lista de administradores de este servidor, seleccione Suprimir administrador en la página Administración de AnswerBook2. Para eliminar el administrador:

1. Haga clic en la casilla de verificación situada junto al ID de sesión del administrador que desea eliminar de la Lista de administradores.

   Éste es el ID del administrador, y no es necesariamente el ID de sistema o usuario de esa persona.

2. Haga clic en Suprimir administrador.

   ---

   Nota -

   Ello no afecta a la capacidad del usuario para acceder a los documentos de AnswerBook2 como usuario. Sólo revoca la capacidad de éste para efectuar funciones administrativas.

   ---

Para llevar a cabo esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o del_admin -u id-admin [-m nombre_serv] [-p puerto_serv]

Manejo de colecciones de documentos

Una colección de AnswerBook2 es una agrupación lógica de manuales. Por ejemplo, podría tener una colección con todos los manuales dirigidos a desarrolladores de Solaris^TM, que sería del tipo AnswerBook2 (SGML) o AnswerBook1 (Display PostScript^TM).

Listado de colecciones

Para ver una lista de todas las colecciones instaladas en el servidor, seleccione Ver lista de colecciones disponibles de la página Administración de AnswerBook2. Esta lista incluye colecciones de tipo AnswerBook1 y AnswerBook2.

Para realizar esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o list [-m nombre_serv] [-p puerto_serv]

Adición de colecciones nuevas

Para agregar una colección a la base de datos del servidor, seleccione Agregar colección a la lista desde la página Administración de AnswerBook2. Esta función asume que la colección ya existe como paquete instalado en el sistema servidor o en algún otro sistema al que aquél tiene acceso. Si la colección todavía no está instalada, use pkgadd para agregarla antes y, a continuación, utilice esta función. Si ejecuta el comando pkgadd en el servidor, agregará automáticamente las colecciones nuevas (por ejemplo, las que se encuentran en el CD de documentación de Solaris 2.6) a la lista del servidor.

Para instalar la colección, lleve a cabo los pasos siguientes:

1. Escriba una ruta válida para el archivo de colección en el campo Ruta a colección.

   Por ejemplo, /opt/answerbooks/english/solaris_2.7/SUNWaman/collinfo. La ruta debe llevar a un directorio que contenga un archivo collinfo para una colección AnswerBook2 o un archivo ab_cardcatalog para una colección AnswerBook1.

2. Haga clic en Agregar colección.

Para llevar a cabo esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o add_coll -d ruta_colección

Después de instalar una colección, debe reiniciar el servidor de documentación. Para ello, haga clic en Reiniciar en la página Administración o desde la línea de comandos escriba:

# /usr/lib/ab2/bin/ab2admin -o restart

Adición de colecciones existentes

El servidor de AnswerBook2 puede examinar el sistema actual para localizar colecciones AnswerBook1 y AnswerBook2 instaladas localmente y agregarlas a la base de datos del servidor. Para que éste realice esta función automáticamente, seleccione Localizar colecciones instaladas localmente desde la página Administración de AnswerBook2. Esta función crea y muestra una lista de todas las colecciones de documentos válidas que encuentran en el sistema local.

Para agregar una colección a la base de datos del servidor:

1. Haga clic en la casilla de verificación que está junto a la colección que desea agregar.

   Las colecciones sin una casilla de verificación ya están en la base de datos.

2. Cuando haya seleccionado todas las colecciones que desee, haga clic en Agregar colecciones seleccionadas.

Si la lista no incluye colecciones de documentos que estén instaladas en un punto de montaje local, verifique que el directorio en el que se instalaron las colecciones tiene el acceso de lectura definido para todos.

Para llevar a cabo esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o scan

La función de exploración de línea de comandos agrega todas las colecciones que encuentra; no permite elegir qué colecciones desea agregar.

Después de instalar una colección, debe reiniciar el servidor de documentación. Para ello, haga clic en Reiniciar en la página de estado Administración de AnswerBook2 o desde la línea de comandos escriba:

# /usr/lib/ab2/bin/ab2admin -o restart

Supresión de colecciones de AnswerBook2

Para suprimir una colección de AnswerBook2 o AnswerBook1 desde la base de datos del servidor, seleccione Suprimir colección de la lista de la página Administración de AnswerBook2. Para suprimir la colección:

1. Marque la casilla de verificación que hay junto a los títulos de las colecciones que desea suprimir de la Lista de colecciones. Para anular la selección de un elemento seleccionado, haga clic de nuevo en la casilla de verificación.

2. Una vez seleccionadas todas las colecciones que desea eliminar, haga clic en Suprimir colección.

Para llevar a cabo esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o del_coll -t título_colección

Estas funciones no eliminan del sistema los paquetes de la colección; únicamente eliminan la entrada correspondiente a la colección de la base de datos del servidor. Para eliminar los paquetes del sistema use la utilidad pkgrm.

Después de suprimir una colección, debe reiniciar el servidor de documentación. Para ello, haga clic en Reiniciar en la página de estado de la página Administración AnswerBook2 o desde la línea de comandos escriba:

# /usr/lib/ab2/bin/ab2admin -o restart

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

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

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.

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:

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.

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 :

• Subprocesos máximos

• Solicitudes de servidor máximas

• Ruta de configuración del servidor

• Usuario del servidor

• Archivo de módulos

• Archivo de tipos Mime

• Raíz de los documentos

• Directorio de registro

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:

• -o access_on

• -o access_off

• -o error_off

• -o error_on

• -o modify_server_name

• -o modify_server_port

Trabajo con otros servidores de documentación

Cuando un usuario hace clic en un enlace de un manual, el servidor AnswerBook2 puede seguir dicho enlace a otro servidor. Si el manual existe en el servidor de documentación actual, el enlace irá allí. No obstante, si el manual con el que se está enlazando no está situado en el servidor actual, el servidor AnswerBook2 "saltará" a cualquier servidor de documentación alternativo que esté definido para su acceso. Puede utilizar esta capacidad para distribuir los documentos en varios servidores o crear copias de seguridad de los documentos.

Identificación de servidores de documentación alternativos

Para ver cuáles son los servidores alternativos definidos, seleccione Ver lista de servidores alternativos en la página Administración de AnswerBook2. Se mostrará una lista de los servidores actualmente identificados como servidores "de salto". Si un usuario hace clic en un enlace de un manual y éste no se encuentra en el servidor actual, el producto AnswerBook2 examina los servidores de esta lista para encontrar el destino para este enlace. El servidor AnswerBook2 incorpora http://docs.sun.com como servidor alternativo predefinido, que es el servidor maestro de documentación de Sun y contiene documentación publicada por Sun.

Esta página muestra el nombre del servidor, su número de puerto y un enlace a la lista de colecciones instaladas en el servidor para cada servidor alternativo definido para el servidor actual. Cuando se hace clic en Mostrar lista de colecciones, se solicita un ID de administración válido y una contraseña para el servidor alternativo (si está definido el control de acceso administrativo en el servidor alternativo). Dicho de otra forma, puede agregar un servidor alternativo sin tener acceso administrativo a él, pero sólo podrá ver la lista de colecciones del servidor si tiene acceso administrativo.

También puede utilizar el comando siguiente para realizar esta función:

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

Adición de servidores de documentación alternativos

Para permitir que su servidor actual pueda acceder a manuales situados en otro servidor (con el propósito de seguir enlaces entre manuales), seleccione Agregar servidor alternativo de la página Administración de AnswerBook2.

1. Escriba el nombre del servidor alternativo en el campo Nombre del servidor AnswerBook2.

2. Escriba el número de puerto AnswerBook2 del servidor alternativo en el campo Número de puerto del servidor. Si no está seguro del número de puerto, utilice 8888 (el número de puerto AnswerBook2 predeterminado).

3. Haga clic en Agregar servidor.

Para llevar a cabo esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o add_server -M nombre_serv_agregado -P puerto_serv_agregado 
[-m nombre_serv] [-p puerto_serv]

Supresión de servidores de documentación adicionales

Para eliminar un servidor de la lista de servidores alternativos, seleccione Suprimir servidor alternativo de la página Administración de AnswerBook2.

1. Seleccione el servidor en la Lista de servidores.

2. Haga clic en Suprimir servidor.

Así elimina el servidor de la lista de servidores alternativos para el servidor de documentación local, lo que no evita que el servidor suprimido siga funcionando como servidor de documentación.

Para efectuar esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o del_server -M nombre_serv_suprimido -P puerto_serv_suprimido 
[-m nombre_servidor] [-p puerto_servidor]

Modificación del orden de los servidores alternativos

Cuando agrega un servidor alternativo a la lista de servidores que puede utilizar su servidor, aquél se agrega a la parte inferior del orden de servidores, que determina la secuencia de acceso a servidores alternativos para seguir enlaces de documentos por parte de su servidor. Si un usuario solicita un documento determinado de la biblioteca, que no está disponible en el servidor predeterminado, el servidor recorre la lista de servidores alternativos según la secuencia definida hasta encontrar el documento.

Para modificar el orden de los servidores disponibles para el sistema, seleccione Modificar orden de servidores de la página Administración de AnswerBook2.

1. Seleccione un servidor de la Lista de servidores.

2. Haga clic en Desplazar arriba en la lista o en Desplazar abajo en la lista.

3. Haga clic en Desplazar.

No hay ninguna opción de línea de comandos para efectuar esta función.

Trabajo con informes de servidor

El software de servidor AnswerBook2 mantiene registros que muestran los errores del servidor y los accesos a éste. Asimismo, incluye un informe de resumen de la frecuencia de acceso de las colecciones de documentos y la cantidad de errores que se producen.

Informe de resumen de acceso a manuales

Para ver un resumen de acceso a los manuales del servidor, seleccione Ver resumen de acceso a los manuales de la página Administración de AnswerBook2. El informe de acceso a manuales muestra la frecuencia con que se ha accedido a cada uno de ellos. Para cada uno, se muestra:

• Título del manual: el título del manual, tal como aparece en la página Biblioteca

• Nombre corto del manual: el nombre corto del manual, tal como está identificado en su archivo de configuración

• Nombre de colección: el nombre corto de la colección a la que pertenece el manual, tal como está identificada en el archivo collinfo

• Accesos: número de veces que se ha accedido al manual

• Errores: número de errores asociados con el manual

Archivos de registro de acceso

Para activar o desactivar el registro de acceso, seleccione Modificar configuración del servidor de la página Administración de AnswerBook2.

• Para hacer que la información sobre quién está accediendo a la información del servidor de documentación se escriba en el archivo de registro de acceso, haga clic en el botón situado junto a activado y luego haga clic en Aplicar. La ubicación predeterminada de este archivo es /var/log/ab2/logs/errors-8888.log.

• Para dejar de guardar la información en el archivo de registro de acceso, pulse el botón situado junto a desactivado y luego haga clic en Aplicar.

También puede utilizar los siguientes comandos para llevar a cabo estas funciones:

% /usr/lib/ab2/bin/ab2admin -o access_on [-m nombre_serv] [-p puerto_serv]
 

% /usr/lib/ab2/bin/ab2admin -o access_off [-m nombre_serv] [-p puerto_serv]
 

Después de cambiar la función de registro, debe parar e iniciar el servidor de documentación. Entre como el 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

Visualización del registro de acceso

Para visualizar el archivo de registro de acceso, seleccione Ver archivos de registro de la página Administración de AnswerBook2 y luego haga clic en Ver archivo de registro de acceso, que es un archivo de texto que muestra todos los accesos realizados en el servidor de documentación. Cada línea del registro de acceso tiene un aspecto similar a éste:

129.146.83.55 - - [04/Nov/1996:15:07:05 -0800] 
"GET /icons/ab2_curr_home.gif HTTP/1.0" 200 1938

Donde:

• El primer conjunto de cifras es la dirección IP (Internet Protocol) del cliente. Por ejemplo, 129.146.83.55.

• La información entre corchetes es la fecha y hora del acceso. Por ejemplo, [04/Nov/1996:15:07:05 -0800] .

• La información entre comillas indica el acceso que se ha producido. Normalmente, suele identificar un URL o un nombre de archivo, así como el protocolo utilizado para responder a la solicitud de acceso. Por ejemplo, "GET /icons/ab2_curr_home.gif HTTP/1.0" indica que el acceso consistió en obtener el archivo /icons/ab2_curr_home.gif mediante el protocolo HTTP 1.0.

• El penúltimo número indica si el acceso fue satisfactorio (200) o no (cualquier otro valor).

• El último número indica el tamaño (en Kilobytes) de la información devuelta al solicitante. Por ejemplo, 1938 es el tamaño del archivo .gif recuperado.

Para llevar a cabo esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o view_access [-m nombre_serv] [-p puerto_serv]

Archivos de registro de errores

Para activar o desactivar el registro de errores, seleccione Modificar configuración del servidor de la página Administración de AnswerBook2.

• Para hacer que la información sobre todos los errores que se produzcan en el servidor de documentación se escriba en el archivo de registro de errores, haga clic en el botón situado junto a activado y luego haga clic en Aplicar. La ubicación predeterminada de este archivo es /var/log/ab2/logs/errors-8888.log.

• Para dejar de guardar la información en el archivo de registro de errores, pulse el botón situado junto a desactivado y luego pulse Aplicar.

También puede utilizar los siguientes comandos para llevar a cabo estas funciones:

% /usr/lib/ab2/bin/ab2admin -o error_on [-m nombre_serv] [-p puerto_serv]
 

% /usr/lib/ab2/bin/ab2admin -o error_off [-m nombre_serv] [-p puerto_serv]

Después de cambiar la función de registro, 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

Visualización del registro de errores

Para visualizar el archivo de registro de errores, seleccione Ver archivos de registro de la página Administración de AnswerBook2 y luego haga clic en Ver archivo de registro de errores. El archivo de registro de errores muestra todos los errores producidos en el servidor de documentación. Puede utilizar esta información para determinar la causa de problemas del servidor o comportamientos no habituales. Estos errores suelen identificar el servidor y puerto con los que está asociado el error, así como un texto que describe éste.

Para llevar a cabo esta función, también puede usar el comando siguiente:

% /usr/lib/ab2/bin/ab2admin -o view_error [-m nombre_serv] [-p puerto_serv]

Rotación de archivos de registro

Se puede guardar el actual registro de accesos o errores en un archivo y comenzar a registrar la información en un archivo vacío.

• Para rotar el archivo de errores, seleccione Rotar archivo de registro de errores de la página Administración de AnswerBook2.

• Para rotar el archivo de accesos, seleccione Rotar archivo de registro de acceso de la página Administración de AnswerBook2.

Cuando aparezca la página Rotar archivo de registro de acceso (errores):

1. Escriba el nombre del archivo en el que debe guardarse en el campo Guardar archivo de registro.

   El valor predeterminado es fecha_actual.nombre_archivo_registro_actual, donde fecha_actual tiene el formato AñoAñoAñoAño_MesMes_DíaDía_HoraHora y nombre_archivo_registro_actual tiene como valor predeterminado access-8888.log o error-8888.log (por ejemplo, 1997_2_26_14.access-8888.log.).

   Observe que el campo Ubicación del archivo de registro muestra dónde se guarda el archivo. No puede cambiar esta información en esta página.

2. Haga clic en Aplicar.

Después de cambiar la función de registro, 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

Para llevar a cabo estas funciones también puede utilizar los siguientes comandos:

% /usr/lib/ab2/bin/ab2admin -o rotate_error [-m nombre_serv] [-p puerto_serv]
 

% /usr/lib/ab2/bin/ab2admin -o rotate_access [-m nombre_serv] [-p puerto_serv]

Funciones de navegación habituales de las páginas Administración

En la parte superior de todas las páginas del producto AnswerBook2 se encuentra un conjunto de funciones de navegación habituales. La tabla siguiente describe qué sucede al seleccionar estas funciones desde las páginas Administración.

En muchas de las páginas Administración, el icono lleva a la página principal Administración de AnswerBook2.