ab2admin(1M) (Instalación y administración de servidores AnswerBook2)

Instalación y administración de servidores AnswerBook2

ab2admin(1M)

Nombre

ab2admin- interfaz de línea de comandos para la administración de AnswerBook2

SYNOPSIS

/usr/lib/ab2/bin/ab2admin

-h

comando

-o

comando

argumentos

DESCRIPTION

El comando ab2admin es una interfaz de línea de comandos para administrar las colecciones y documentos de AnswerBook2 de un servidor AnswerBook2 concreto. Este comando puede instalar y desinstalar las colecciones AnswerBook1 y AnswerBook2 de un servidor, explorar las colecciones instaladas localmente y modernizar la base de datos del servidor y obtener una lista de colecciones y manuales.

Las funciones de ab2admin para la gestión del servidor incluyen: parar, iniciar, reiniciar el servidor, activar o desactivar y rotar los archivos de registro de éste. Puede configurarse el servidor para que resuelva los enlaces a manuales situados en otros servidores AnswerBook2.

También se puede utilizar ab2admin para controlar el acceso al servidor, agregando o suprimiendo usuarios en la agrupación de usuarios administrativos. Puede habilitarse o inhabilitarse el control de acceso.

ab2admin puede conectar con cualquier servidor AnswerBook2 (local o remoto). Determinadas funciones (como stop, start y restart) sólo se aplican al servidor AnswerBook2 local. Si éste está protegido con una contraseña, se necesitará un identificador de usuario y una contraseña para iniciar cualquier tarea de administración.

Para ejecutar ab2admin de forma interactiva, escriba ab2admin desde la línea de comandos y, a continuación, introduzca los comandos según se le indique. También se puede ejecutar completamente desde la línea de comandos, mediante la opción -o .

OPTIONS

Se admiten las opciones siguientes:

-h [comando]: Muestra la ayuda o la ayuda específica sobre un comando .
-o subcomando [ argumentos]: A continuación se relacionan los subcomandos admitidos.

Sub-commands

Se admiten los subcomandos siguientes para la opción -o :

access_off [ - m servidor ] [ -p número_puerto_servidor ]: Inhabilita el archivo de registro de acceso del servidor.
access_on [ -m servidor ] [ -p número_puerto_servidor ]: Habilita el archivo de registro de acceso del servidor.
add_admin -u id_usuario [ -m servidor ] [ -p número_puerto_servidor ]: Agrega un usuario en la lista autorizada de administradores del servidor.
add_coll -d ruta [ -m servidor ] [ -p número_puerto_servidor ]: Agrega colecciones AnswerBook1 o AnswerBook2 a la base de datos del servidor AnswerBook2 especificada.
add_server -M servidor_alternativo -P número_puerto_servidor_alternativo [ -m servidor ] [ -p número_puerto_servidor ]: Agrega un servidor alternativo al servidor especificado.
auth_off [ -m servidor ] [ -p número_puerto_servidor ]: Inhabilita la verificación en la administración de servidores.
auth_on [ -m servidor ] [ -p número_puerto_servidor ]: Habilita la verificación en la administración de servidores.
autostart_no [ -m servidor ] [ -p número_puerto_servidor ]: Evita que se inicie automáticamente el servidor AnswerBook2 al iniciar o rearrancar el sistema.
autostart_yes [ -m servidor ] [ -p número_puerto_servidor ]: Hace que se inicie automáticamente el servidor AnswerBook2 cuando se inicia o rearranca el sistema.
browser [ -m servidor ] [ -p número_puerto_servidor ]: Ejecuta un navegador de web para acceder a las páginas Administración de AnswerBook2.
change_password -u id_admin [ -m servidor ] [ -p número_puerto_servidor ]: Cambia la contraseña del administrador autorizado.
del_admin -u id_usuario [ -m servidor ] [ -p número_puerto_servidor ]: Suprime un usuario en la lista de administradores del servidor autorizados.
del_coll -r título_colección [ -m servidor ] [ -p número_puerto_servidor ]: Elimina colecciones AnswerBook1 o AnswerBook2 en la base de datos del servidor especificado.
del_server -M servidor_alternativo -P número_puerto_servidor_alternativo [ -m servidor ] [ -p número_puerto_servidor ]: Suprime el servidor alternativo en la lista de servidores que conoce el servidor especificado.
error_off [ -m servidor ] [ -p número_puerto_servidor ]: Inhabilita el archivo de registro de errores del servidor.
error_on [ -m servidor ] [ -p número_puerto_servidor ]: Habilita el archivo de registro de errores del servidor.
help [ comando]: Muestra toda la información sobre un comando determinado o todos los comandos.
list [ -m servidor ] [ -p número_puerto_servidor ]: Muestra las colecciones AnswerBook1 y AnswerBook2 disponibles en el servidor especificado. La lista incluye los manuales contenidos en las colecciones.
list_server [ -m servidor ] [ -p número_puerto_servidor ]: Relaciona todos los servidores alternativos definidos para el servidor especificado.
menu: Muestra una lista resumida de las opciones de los comandos.
modify_server_name -s nuevo_nombre_servidor [ -m servidor ] [ -p número_puerto_servidor ]: Modifica el nombre del servidor.
modify_server_port -a nuevo_número_puerto_servidor [ -m servidor ] [ -p número_puerto_servidor ]: Modifica el número de puerto del servidor.
restart: Reinicia el servidor AnswerBook2 local. Es necesario el acceso de root.
rotate_access [ -m servidor ] [ -p número_puerto_servidor ]: Guarda y reinicia el archivo de registro de acceso del servidor.
rotate_error [ -m servidor ] [ -p número_puerto_servidor ]: Guarda y reinicia el archivo de registro de errores del servidor.
scan [ -m servidor ] [ -p número_puerto_servidor ]: Explora las colecciones instaladas localmente (AnswerBook1 o AnswerBook2) y las actualiza en la base de datos del servidor especificado.
start: Inicia el servidor AnswerBook2 local. Es necesario el acceso de root.
start -D: Inicia el servidor AnswerBook2 local en modo de depuración. Es necesario el acceso de root.
stop: Para el servidor AnswerBook2 local. Es necesario el acceso de root.
view_access [ -m servidor ] [ -p número_puerto_servidor ]: Visualiza el contenido del archivo de registro de acceso del servidor.
view_config [ -m servidor ] [ -p número_puerto_servidor ]: Visualiza los valores de configuración del servidor.
view_error [ -m servidor ] [ -p número_puerto_servidor ]: Visualiza el contenido del archivo de registro de errores del servidor.

USAGE

quit: Sale de la modalidad interactiva.
q: Sale de la modalidad interactiva.
bye: Sale de la modalidad interactiva.
exit: Sale de la modalidad interactiva.
? [comando]: Obtener ayuda en la modalidad interactiva.
h [comando]: Obtener ayuda en la modalidad interactiva.

EXAMPLES

Ejemplo 1 Visualización de las colecciones de AnswerBook2 disponibles en un servidor

Para relacionar las colecciones disponibles en un servidor con nombre foo.com que utiliza el número de puerto 8888:

ejemplo% ab2admin -o list -m foo.com -p 8888

Ejemplo 2 Uso de la modalidad interactiva para relacionar las colecciones

Para utilizar ab2admin en la modalidad interactiva para la misma operación anterior:

ejemplo% ab2admin 
>> list -m foo.com -p 8888

Ejemplo 3 Instalación de una colección AnswerBook2

Para instalar una colección AnswerBook2 mediante la utilidad pkgadd:

ejemplo# pkgadd -d directorio_paquete/ SUNWabsdk

Se copiará la estructura de directorios de la colección en /opt/answerbooks/ del sistema (de forma predeterminada)

Ejemplo 4 Instalación de una colección AnswerBook2 no actualizada en la base de datos del servidor

Para instalar una colección AnswerBook2 que se ha introducido en el sistema (a través de pkgadd) pero no se ha actualizado en la base de datos del servidor:

ejemplo# ab2admin -o add_coll -d
/opt/answerbooks/english/solaris_2.6/SUNWabsdk

(Nota: -d ruta debe incluir el archivo collinfo (para una colección AnswerBook2) o el archivo ab_cardcatalog (para una colección AnswerBook1).

Ejemplo 5 Inspección de la definición de una colección AnswerBook1

Para inspeccionar la definición de una colección AnswerBook1:

ejemplo% cat /opt/SUNWans/ab_cardcatalog
:id=SUNWab_10_4: \ 
:version=: \ 
:title=Solaris XGL 3.1 AnswerBook: \ 
:tocpath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/toc: \ 
:pspath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/ps: \ 
:indexpath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/inde

Ejemplo 6 Inspección de la definición de una colección AnswerBook2

Para inspeccionar la definición de una colección AnswerBook2:

ejemplo% cat/opt/answerbooks/english/solaris_2.6/SUNabsd/collinfo dwCollections {
 coll.45.4 dwCollection 
} 
dwSetParam coll.45.4 {
 location /opt/answerbooks/english/solaris_2.6/SUNWabsdk
 title "Solaris 2.6 Software Developer AnswerBook Vol 1"
 type EbtCollection 
}

FILES

/var/log/ab2/catalog/local.socat: Archivo de catálogo
/var/log/ab2/catalog/remote.socat: Archivo de catálogo
/var/log/ab2/catalog/delegate.socat: Archivo de catálogo
/var/log/ab2/catalog/libcat.socat: Archivo de catálogo
/var/log/ab2/logs/access_8888.log: Archivo de registro de acceso predeterminado
/var/log/ab2/logs/errors_8888.log: Archivo de registro de errores predeterminado
/usr/lib/ab2/dweb/data/config/ab2_collections.template: Base de datos de colecciones de AnswerBook2
/var/log/ab2/catalog/ab1_cardcatalog: Base de datos de colecciones de AnswerBook1
/usr/lib/ab2/dweb/data/config/admin_passwd: Archivo que contiene nombre de usuario:contraseña

ATTRIBUTES

Véase attributes(5) para obtener una descripción de los atributos siguientes:

TIPO DE ATRIBUTO	VALOR DE ATRIBUTO
Disponibilidad	`SUNWab2u`