La administración del software AnswerBook2 implica llevar a cabo las funciones siguientes, cada una de las cuales incluye tareas específicas:
"Activación y desactivación de la depuración de fuentes de documentos"
"Visualización de la configuración del servidor de documentación"
"Funciones de navegación habituales de las páginas Administració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".
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 |
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 |
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.
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 |
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.
Para agregar un usuario como administrador, seleccione Agregar administrador en la página Administración de AnswerBook2. A continuación:
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.
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] |
Para cambiar la contraseña de un administrador, seleccione Cambiar contraseña en la página Administración de AnswerBook2. Para modificar aquélla:
Seleccione el usuario administrador en la lista emergente ID de administrador.
Escriba la contraseña existente del administrador en el campo Contraseña antigua.
Escriba la nueva contraseña del administrador en el campo Contraseña nueva.
Vuelva a escribir la nueva contraseña del administrador en el campo Vuelva a introducir la contraseña nueva.
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] |
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:
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.
Haga clic en Suprimir administrador.
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] |
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 SolarisTM, que sería del tipo AnswerBook2 (SGML) o AnswerBook1 (Display PostScriptTM).
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] |
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:
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.
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 |
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:
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.
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 |
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:
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.
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 |
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.
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".
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. |
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.
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] |
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.
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 |
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:
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.
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 |
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.
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
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.
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] |
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.
Escriba el nombre del servidor alternativo en el campo Nombre del servidor AnswerBook2.
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).
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] |
Para eliminar un servidor de la lista de servidores alternativos, seleccione Suprimir servidor alternativo de la página Administración de AnswerBook2.
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] |
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.
Seleccione un servidor de la Lista de servidores.
Haga clic en Desplazar arriba en la lista o en Desplazar abajo en la lista.
Haga clic en Desplazar.
No hay ninguna opción de línea de comandos para efectuar esta función.
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.
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
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 |
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] |
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 |
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] |
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):
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.
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] |
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.
Tabla 3-4 Funciones de navegación habituales
Etiqueta |
Descripción |
---|---|
Biblioteca personal |
Ir al catálogo de la biblioteca de documentación. Véase "Página de biblioteca" in Consulta de documentación en línea con el sistema AnswerBook2. |
Contenido |
Esta función no está disponible en las páginas Administración. |
Imprimir |
Esta función no está disponible en las páginas Administración. |
Opciones |
Ir a la página Opciones, que contiene enlaces a otras páginas en las que puede definir su Biblioteca personal, establecer su Preferencia de idioma o administrar el servidor de documentación. Véase "Personalización de la información de AnswerBook2" in Consulta de documentación en línea con el sistema AnswerBook2. |
Ayuda de AnswerBook2 |
Ver la información de ayuda. |
En muchas de las páginas Administración, el icono lleva a la página principal Administración de AnswerBook2.