Jobs y Métodos

1. Administración Documentum 6.5 Jobs y Métodos

2. Objetivos • Crear y ejecutar Métodos de Documentum • Seleccionar y usar agentes para ejecutar Métodos • Crear y ejecutar Jobs de Documentum

3. Los Métodos son scripts ejecutables o programas que son representados mediante un objeto (dm_method) existente en el repositorio. El objeto “método” tiene una serie de atributos que identifican como se va a ejecutar el script y programa asociado El script o programa puede ser escrito en diversos lenguajes de programación o scripting Los Métodos son ejecutados mediante el método administrativo “DO_METHOD”, usando un Job o desde un workflow. Usando DO_METHOD ejecuta el método según demanda o cuando se desee. Usando un Job, se ejecuta el método cuando se lance el Job, mediante una ejecución automática Documentum proporciona un conjunto de métodos para realizar tareas de Administración del sistema. Los Usuarios o Clientes pueden crear sus propios métodos según sus necesidades. Métodos

4. Ejecutar el Objeto de tipo Método 4 Crear el objeto de tipométodo 1 Escribir un Programa 5 Java, Docbasic, etc. Ejecutar el método objeto tipo método Java Method Server 3 Contenido de un Objeto de tipo Método Determina el agente de ejecución Fichero Externo Determina cómo se almacena el programa Content Server 2 Servidor de Aplicaciones dmbasic Method Server Crear y Ejecutar Métodos

5. Nuevo Programa Content Server / Repositorio Escribir un Programa • Escribir y probar el programa o script en el lenguaje elegido. • Lo desarrolladores de la aplicación son habitualmente quienes realizan esto. • El programa incluye la lógica para: • Conexión contra el repositorio • Realizar las acciones y tareas en el repositorio • Desconexión del repositorio

6. El Programa invocado por el método puede ser guardado de las siguientes formas: Fichero externo en el Content Server Contenido asociado al objeto “método” Desplegado en el Java Method Server Instancia de JBoss instalado automáticamente por el Content Server y dedicado exclusivamente a ejecutar Métodos No se trata de un Servidor de Aplicaciones exterior, donde se desplieguen aplicaciones WDK. Sólo para métodos Java ¿Cómo se almacena el Programa?

7. Content Server Java Method Server dmbasic Method Server Agentes para Ejecutar Métodos • Los Métodos son ejecutados de una de las tres formas siguientes: • Por el proceso DO_METHOD del Content Server • Por el dmbasic Method Server • Por el Java Method Server • En una instancia de JBoss separada • Esta instancia se usa sólo para el Java Method Server

8. Content Server Agentes para Ejecutar Métodos: Content Server • Ejecución por defecto usada por el agente de ejecución de métodos • Si no se especifica directamente que un método sea ejecutado con el Method Server o con el Java Method Server, se instancia desde el Content Server • Los programas corren dentro de un proceso del Content Server • Usado para ejecutar programa generados en cualquier lenguaje

9. Agentes para Ejecutar Métodos: dmbasic Method Server • Proceso separado que: • Es instalado con el Content Server • Reside en el mismo host que el Content Server • Está habilitado por defecto y funciona mientras el Content Server exista • Si el Content Server es reiniciado, el dmbasic Method Server se arranca automáticamente • Es usado para ejecutar programas escritos en dmbasic Method Server

10. Content Server Application Server Agentes para Ejecutar Métodos: Java Method Server • El Java Method Server (instancia de JBoss) es un componente que forma parte de la instalación del Content Server 6.5 • Reside en el mismo host que el Content Server • Es implementado como un servicio (Windows) / proceso (UNIX) • Existe un servlet que ejecuta métodos y es llamado mediante un método administrativo (DO_METHOD) • Usado para ejecutar métodos Java

11. Crear un Objeto de tipo Método • Una vez que el programa ha sido guardado y se ha determinado el agente de ejecución del método, se creará el objeto “Método” que hará referencia al programa. • El objeto método (dm_method) guarda información sobre el programa: • Tipo de programa (por ejemplo, Java, dmbasic, gawk) • La ubicación general donde se almacena el programa (filesystem, repositorio, Java Method Server, etc.) • El agente que será usado para su ejecución • La cuenta bajo la cual se ejecutará el programa • Time out y otra información • Los objetos de tipo Método pueden ser creados usando DA, DAB (Documentum Application Builder) o Composer • Se requiere tener privilegios de SYADMIN

12. Crear un Método mediante DA • Iniciar el Documentum Administrator y conectar con el repositorio • Seleccionar Administration > Job Management > Methods • Seleccionar File > New > Method para iniciar la creación Nombre del Método Localización del Método y argumentos de entrada (entry point) (ejecutar código residente en el file system) Tipo de Programa Uso de Method Server Ejecutar como Superuser

13. Crear un Método mediante DAB (1 de 2) • Dentro de una DocApp, seleccionar Insert > Method Un nuevo objeto de tipo método deberá ahora aparecer, en estado de checked out, en la carpeta de “Methods” en la DocApp • Doble-click sobre el método que se acaba de crear • La ventana con la información del método aparecerá, permitiendo la inserción de los mismos parámetros vistos a través del DA • Introducir los parámetros del método y cerrar la ventana Para ejecutar un método desde una actividad de un workflow, seleccionar este checkbox

14. Crear un Método mediante DAB (2 de 2) • Hacer click sobre el método con el botón derecho del ratón y seleccionar “Check-in” sobre los objetos seleccionados • En la ventana de diálogo del “Check-in”, configurar las opciones de check-in (si así se desea) y hacer click sobre el botón de check-in.

15. Ejecutar un Método • Los métodos pueden ser ejecutados automáticamente vía: • DQL (instrucción execute) • API (instrucción apply) • Jobs • Actividades automáticas de un workflow • Los métodos pueden ser ejecutados manualmente utilizando el DA • Método Administrativo DO_METHOD • Ejecución forzada de un Job

16. Métodos de Administración del Sistema • El Content Server 6.5 incluye un conjunto de métodos administrativos que realizan tareas comunes del sistema. • Se encuentran localizados en Administration > Job Management > Admisnitration Methods • Existen tres tipos: • Métodos de Contenido • Métodos de Base de Datos • Métodos de Traza • Opcionalmente, pueden existir más tipos, como por ejemplo: • Métodos de Full Text

17. Jobs • Crear and Executar Métodos • Jobs • Instancias de tipo “dm_job” • Usado para ejecutar métodos automáticamente en base a una programación definida por el usuario, o bien de manera manual. • Fácil de usar para automatización de tareas que son realizadas regularmente. • Ejecutado por el proceso “dm_agent_exec”en intervalos de tiempo regulares.

18. 2 3 1 Java, Docbasic, etc. method object job object Implementar un Job • Los siguientes pasos describen como se crea y se activa un Job: • Escribir un programa que realice las operaciones requeridas • Crear un objeto de tipo Método que haga referencia al programa • Crear y activar un objeto de tipo Job que apunte al Método creado

19. Nota: Muchos jobs son instalados en estado “inactivo” Un administrador establece el estado de los jobs a activos y así podrán ser ejecutados según su configuración Los Jobs inactivos sólo pueden ser ejecutados manualmente Hacer click derecho en el job y pulsar “properties” para editarlo, incluyendo el activar/desactivar el job. Hacer click derecho sobre el job y pulsar “run” para forzar la ejecución “inmediata” del job. Tipos de Jobs (1 de 2)

20. CA Store Content Data Dictionary Distributed Content Docbase Federation Other Replication Web Publishing Workflow Tipos de Jobs (2 de 2) • En Documentum existen las siguientes categorías de Jobs: • Adicionalmente, pueden crearse tantas categorías como se deseen

21. Propiedades de un Job(1 de 4) • El objeto Job “dm_job” tiene una serie de propiedades que definen la forma de ejecución de los métodos asociados a sí mismo. • Estas propiedades incluyen: • Cuando se ejecutará • Cada cuanto tiempo se ejecutará • Que método se ejecutará • Los argumentos que son necesarios pasar al método

22. object_name (job name) method_trace_level target_server is_inactive run_now Propiedades de un Job(2 de 4)

23. a_next_invocation run_mode run_interval expiration_date max_iterations Propiedades de un Job(3 de 4) run_interval y run_mode trabajan juntos para determinar cada cuando se ejecutará el job

24. pass_standard_arguments method_arguments method_name Propiedades de un Job(4 de 4)

25. En el árbol izquierdo del DA, seleccionar Administration > Job Management > Jobs En los menús, seleccionar File > New > Job Crear un Job (1 de 5)

26. Identificar el job (Info tab) En el campo Job Name, introducir el nombre que tomará el Job Opcionalmente, introducir un nombre de categorización para el job en el campo Job Type En el campo Subject, se puede introducir un texto descriptivo del job Activar el job mediante el checkbox “Active” Definir un nivel de traza para el job (por defecto = 0) Seleccionar botón “Next” Crear un Job (2 de 5)

27. Crear un Job (3 de 5) • Especificar la periodicidad de ejecución del Job y seleccionar Next

28. Crear un Job (4 de 5) • Selecionar el método que se va a ejecutar • Especificar los argumentos que son necesarios pasar al Job • Click Siguiente o Next

29. Crear un Job (5 de 5) • Especificar el Título (Title), Descripción (Subject), palabras clave identificativas (Keywords), etc. (optional) • Click Next

30. Java, Docbasic, etc. method object 3 Run Job Yes ... 2 job object Is there anything to run? 1 dm_agent_ exec Proceso dm_agent_exec • Instalado en el C.S. para cada repositorio • Se inicia con el C.S. al lanzarse el agent_exec_method • El proceso dm_agent_exec procesa las planificaciones de los jobs para ver cuando lanzar un job • Se produce un “fork” del proceso para cada ejecución de job

31. Window Interval • El argumento “window_interval” evita que un job comience antes que el número establecido en “x minutos” antes o después de su tiempo previsto de arranque • Si el job arranca dentro del window_interval, se le permite terminar, incluso si termina también fuera window_interval • El argumento “Window Interval” se puede establecer para un job en la opción “Method Arguments” (method_arguments)

32. Start Window Interval EndWindow Interval Job arranca a las 8 p.m. diariamente 60 minutos 60 minutos 7 p.m. 8 p.m. 9 p.m. Job A Window Interval: Escenario 1 • Job A comienza diariamente a las 8 p.m • El Window Interval para el job se establece a 60 (una hora antes y una hora después del tiempo previsto) • El job corre sólo dentro del Window Interval • Si el Job A comienza dentro del Window Interval pero más tarde (por alguna razón), se le permitirá terminar incluso si esto se extiende por delante del final del Window Interval

33. Start Window Interval Hora Ideal Cuando el Job A debe comenzar End Window Interval Start Window Interval Power Outage 60 minutos Window Interval 7 p.m. 8 p.m. 9 p.m. 7 p.m. 9 p.m. DIA 1 DIA 2 Window Interval: Escenario 2 • Si hay un problema (por ejemplo un parón del suministro eléctrico) que atraviesa el Window Interval para el Job (7 de la tarde a 9 de la tarde), provoca que el Job no correrá ese día • El Job A trata de comenzar cuanto antes dentro del Window Interval - 7 de la tarde al día siguiente, asumiendo que el Content Server se ha recuperado para entonces

34. Start Window Interval Hora Ideal Cuando el Job A debe comenzar End Window Interval 60 minutos 60 minutos 7 p.m. 8 p.m. 9 p.m. Jobs B,C,D running DIA2 DIA 1 Job A intenta arrancar a las 8 p.m Window Interval: Escenario 3 (1 de 2) • Por defecto, dm_agent_exec sólo permite tres jobs funcionando a la vez • Por lo tanto, en circunstancias normales, si Job A intenta comenzar a las 8 de la tarde y otros tres jobs están actualmente corriendo, el Job A no puede comenzar

35. Start Window Interval Ideal time when Job A should run End Window Interval Start Window Interval 60 minutes Window Interval 7 p.m. 8 p.m. 9 p.m. 7 p.m. 9 p.m. 60 minutos Job A Jobs B,C,D running DIA1 DIA2 Job A intenta comenzar cada 5 min. Window Interval: Escenario 3 (2 de 2) • dm_agent_exec hace que el Job A intente comenzar cada cinco minutos hasta que comience o hasta que el final del Intervalo de Ventana sea alcanzado • Si el job no comienza durante el Window Interval, entonces tratará de comenzar cuanto antes dentro del siguiente Window Interval

36. import× Resumen (1 de 2) • Los Métodos son operaciones realizadas sobre objetos • Consisten en un Docbasic script o un programa externo • Definidos por el objeto dm_method • Los Jobs son definidos por el objeto dm_job • Un job puede ser usado para configurar la ejecución de un método en intervalos regulares • Los Programas representados por objetos de tipo job son lanzados mediante una utilidad especial llamada “dm_agent_exec process” • dm_agent_exec sondea propiedades del job y ejecuta los jobs dentro de su “window time” o tiempo previsto

37. Viewing Renditions× Resumen (2 de 2) dm_job dm_method CUÁNDO dmr_content CÓMO QUÉ programa (en el file system del Content Server)

38. Comprueba tu Conocimiento • Verdadero/Falso: ¿El programa controlado por un objeto de dm_method debe ser almacenado en el repositorio? • Verdadero/Falso : Un job inactivo no puede ser ejecutado. • Catalogue los tres tipos de agentes de ejecución. • Verdadero/Falso. Para que un job pueda ser controlado a mano, usted primero debe ponerlo a estado de Activo.