En este capítulo, se analiza la administración de DIVAnet.
DIVAnetAdmin es una herramienta de línea de comandos simple que tiene opciones para administrar DIVAnet. Esta utilidad se puede ejecutar solamente en el servidor donde se ejecutan los servicios ClientAdapter y DbSync.
Para iniciar la utilidad, abra la ventana del comando y, a continuación, navegue desde el directorio raíz de DIVAnet hasta el subdirectorio Program\divanet\bin. Ejecute el siguiente comando para iniciar la utilidad:
DIVAnetAdmin.bat ClientAdapterWebUrl DbSyncWebUrl
Nota:
Si no proporciona los argumentos de la URL, la utilidad supondrá que los servicios ClientAdapter y DbSync se están ejecutando de forma local y solicitará los puertos de los servicios ClientAdapter y DbSync.La Tabla 6-1 muestra las opciones de DIVAnetAdmin, que se seleccionan mediante un sistema de menú.
Tabla 6-1 Opciones de DIVAnetAdmin
| Categoría | Opción | Descripción |
|---|---|---|
|
Sincronización de base de datos de activos |
List Synced Sites (Mostrar sitios de sincronización) |
Genera la lista de los sitios en los que se sincroniza la información de los activos. También mostrará el estado de sincronización de cada sitio. Si un sitio está en un estado de sincronización inicial, el porcentaje completado también se mostrará. |
|
Sincronización de base de datos de activos |
Resync a Site (Resincronizar un sitio) |
Resincroniza todos los registros de objetos desde un sitio particular a la base de datos de DIVAnet. Precaución: esta opción suprimirá todos los registros de activos de la base de datos de DIVAnet (para el sitio seleccionado) antes de resincronizarlos. |
|
Sincronización de base de datos de activos |
Resync an Object (Resincronizar un objeto) |
Actualiza los registros de objeto para un objeto específico en un sitio específico. No sincroniza las supresiones. |
|
Conexiones de la API |
List API Connection (Mostrar conexiones de API) |
Muestra todas las conexiones de la API del cliente DIVAnet, incluidas las de modo directo. |
|
Conexiones de la API |
End API Connection (Finalizar conexiones de API) |
Proporciona una opción para finalizar una conexión de API particular, identificada por ID. |
|
Recarga de perfiles de flujo de trabajo |
Reload Workflow Profiles (Volver a cargar perfiles de flujo de trabajo) |
Esta opción causará la recarga de todos los perfiles de flujo de trabajo. También recargará las reglas de acceso definidas. Si se definen reglas de acceso, esta opción requiere acceso a la operación ChangeConfig. |
|
Parámetros de sitio |
Show Site Parameters (Mostrar parámetros de sitio) |
Esta opción muestra los parámetros de sitio de DIVA, incluido el número de solicitudes en cola para el sitio, el número de solicitudes (enviadas por DIVAnet) que se ejecutan en cada sitio, la fecha de la última comunicación con el sitio y los parámetros de limitación. |
|
Parámetros de sitio |
Set Site Parameters (Definir parámetros de sitio) |
Esta opción permite al usuario configurar los parámetros de limitación de DIVA:
Si se definen reglas de acceso, esta opción requiere acceso a la operación ChangeConfig. |
|
Estadísticas de tiempo de ejecución |
Show Runtime Stats: ClientAdapter (Mostrar estadísticas de tiempo de ejecución: ClientAdapter) |
Esta opción muestra estadísticas de tiempo de ejecución útiles para el servicio ClientAdapter. |
|
Estadísticas de tiempo de ejecución |
Show Runtime Stats: DbSync (Mostrar estadísticas de tiempo de ejecución: DbSync) |
Esta opción muestra estadísticas de tiempo de ejecución útiles para el servicio DbSync. |
|
Nivel de log |
Set Log Level: ClientAdapter (Definir nivel de log: ClientAdapter) |
Esta opción muestra el nivel de log de los servicios de ClientAdapter y proporciona una opción para cambiar de forma dinámica el nivel de log (los valores válidos son ERROR, WARN, INFO, DEBUG, TRACE). |
|
Nivel de log |
Set Log Level: DbSync (Definir nivel de log: DbSync) |
Esta opción muestra el nivel de log de los servicios de DbSync y proporciona una opción para cambiar de forma dinámica el nivel de log (los valores válidos son ERROR, WARN, INFO, DEBUG, TRACE). |
DIVAnet crea los siguientes tipos de archivos log:
Logs de rastreo: se encuentran en el directorio raíz de DIVAnet, en la subcarpeta Program\log\divanet. Cada uno de los servicios de DIVAnet (ManagerAdapter, DbSync y ClientAdapter) crea su propia subcarpeta dentro de la carpeta Program\log\divanet y genera los archivos log en ese subdirectorio.
Logs de servicio de envoltorio: estos logs generan mensajes relacionados con el inicio y el apagado del servicio de la ventana. Este es el lugar para buscar si el servicio si no se inicia correctamente. Estos logs están dentro del directorio raíz de DIVAnet, en la subcarpeta Program\log\divanet. Se nombrarán de manera similar al archivo Wrapper.conf, pero con una extensión de nombre de archivo .log (por ejemplo, ManagerAdapterWrapper.log).
Logs de la GUI: los errores que se producen en DIVAnetUI aparecerán en la computadora cliente, no en el lado del servidor. Los logs aparecen en la subcarpeta Program\log\divanet\gui.
DIVAnet empaquetará los logs anteriores a una hora en archivos zip y conservará dos días de logs para revisión.
En estas secciones, se analizan la colocación en cola y el procesamiento de solicitudes.
DIVAnet puede aceptar más solicitudes que las que los sistemas DIVArchive descendentes pueden procesar con las colas de solicitudes. DIVAnet aplica un número máximo de solicitudes que se pueden poner en la cola o ejecutar de manera interna (el valor por defecto es 5000), mediante el parámetro <GlobalDivanetRequestLimit>. DIVAnet comenzará a rechazar solicitudes si se alcanza este límite. El servicio ClientAdapter de DIVAnet mantiene una cola para cada sitio. Puede configurar DIVAnet de modo que alimente solicitudes en los sitios lentamente o que envíe todas las solicitudes a los sitios de una vez (en este caso, probablemente DIVArchive los coloque en cola).
Si se coloca una solicitud en cola en el sistema DIVArchive y se reinicia el sistema DIVA, se finalizarán todas las solicitudes en ejecución. DIVAnet se comporta de manera diferente: DIVAnet almacena cada una de las solicitudes en una base de datos. Si se reinicia el servicio ClientAdapter, DIVAnet lee las solicitudes pendientes y en ejecución y las reinicia. Sin embargo, no todas las solicitudes se reiniciarán de esta manera. Por ejemplo, las solicitudes de supresión nunca se volverán a ejecutar después de que se reinicie el servicio. Si no desea que se recuperen solicitudes en el inicio, el parámetro <AbortAllOnStartup> de ClientAdapter se podrá configurar para finalizar todas las solicitudes de la cola en el inicio.
Por defecto, DIVAnet enviará cien solicitudes a un sitio antes de detenerse y esperar a que se complete una de estas solicitudes. El parámetro que controla el límite es <SubmittedThrottleThreshold>, que se puede configurar en ClientAdapter de a un sitio por vez. También se puede cambiar en el momento de ejecución mediante la utilidad DIVAnetAdmin. Además, DIVAnet puede limitar las solicitudes según el número total de solicitudes que se ejecutan en un sitio de DIVArchive (mediante el parámetro <TotalThrottleThreshold>). Puede configurar el parámetro en -1 para indicar que no se debe aplicar ninguna limitación. También puede configurar el valor en 0, lo que indica que no se deben enviar solicitudes en la cola a DIVArchive. Esto puede ser útil en determinadas situaciones.
Si se pone en cola una solicitud de DIVAnet para un sitio determinado durante más de unos pocos segundos, DIVAnetUI mostrará la posición de la solicitud en la cola. Si se pone en cola otra solicitud con una prioridad más alta que la primera, es probable que tenga una posición más alta en la cola. Si una solicitud falla y se reintenta, la solicitud se colocará nuevamente en cola (aunque obtendrá un aumento de prioridad por estar en el sistema durante un tiempo largo).
Es posible reintentar algunas solicitudes automáticamente dentro de DIVAnet. Es posible reintentar las solicitudes de copiado, restauración, restauración parcial de archivos y supresión. Las solicitudes de restauración y de restauración parcial de archivos se pueden reintentar un número de veces que se puede configurar, y las solicitudes de copiado y supresión se reintentan durante un intervalo de tiempo configurable. Los reintentos se pueden especificar de un perfil de flujo de trabajo por vez y se pueden modificar en el momento de la ejecución sin reiniciar ClientAdapter (consulte Configuración de perfiles de flujo de trabajo para obtener más información).
Si un sitio está inactivo y se las solicitudes para ese sitio se colocan en cola, DIVAnet esperará <SiteDownRequeueWaitMins> minutos para que el sitio esté operativo. Si transcurre este período y se han configurado reintentos, DIVAnet intentará reintentar la solicitud, posiblemente en otro sitio. Si no se configuran los reintentos, la solicitud finalizará.