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 que contenga todos los manuales dirigidos a desarrolladores de Solaris^TM. Esta colección puede ser de tipo AnswerBook2 (SGML) o AnswerBook1 (Display PostScript^TM).

Listado de colecciones

Para ver un listado de todas las colecciones instaladas en su servidor, seleccione Ver lista de colecciones disponibles en la página de administración de AnswerBook2. Esta lista incluye colecciones de tipo AnswerBook1 y AnswerBook2.

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

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

Adición de colecciones nuevas

Para agregar una colección a la base de datos de un servidor, seleccione Agregar colección a la lista desde la página de 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 el servidor tiene acceso. Si la colección todavía no está instalada, use pkgadd para agregarla antes y después use esta función. Para colecciones nuevas (por ejemplo, las que están en el CD de documentación de Solaris 2.6), si se ejecuta el comando pkgadd desde el servidor, éste agrega las colecciones a la lista del servidor automáticamente.

Para instalar la colección, siga estos pasos:

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

   Por ejemplo, /opt/answerbooks/english/solaris_2.7/SUNWaman/collinfo. La ruta debe señalar 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_a_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 de estado de la 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 hacer que el servidor lleve a cabo esta función, seleccione Examinar colecciones instaladas localmente en la página de administración de AnswerBook2. Esta función crea y muestra un listado de todas las colecciones de documentos válidas que encuentre 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 situada al lado de la colección que desea agregar.

   Las colecciones que no tienen 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 las colecciones de documentos que están instaladas en un punto de montaje local, verifique que el directorio donde se instalaron las colecciones tiene el acceso de lectura definido para todo el mundo.

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 examen de la línea de comandos agrega todas las colecciones que encuentre; no permite elegir qué colecciones se agregará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 de estado de la 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 AnswerBook2 o AnswerBook1 de la base de datos del servidor, seleccione Suprimir colección de la lista en la página de administración de AnswerBook2. Para suprimir la colección:

1. Seleccione la casilla de verificación situada al lado de los títulos de las colecciones que desea suprimir de la Lista de colecciones. Para deseleccionar un elemento seleccionado, haga clic de nuevo en la casilla de verificación.

2. Después de haber seleccionado 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 suprimen la entrada correspondiente a la colección de la base de datos del servidor. Para borrar los paquetes del sistema use la utilidad pkgrm.

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

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