- Alcance técnico y concepto
- Instalación — instalar, actualizar y desinstalar
- Configuración — directorios de las utilidades y ajustes del sistema operativo
- Acciones — las 11 acciones con sus parámetros
- Actualización y migración
- Notas de la versión
- Preguntas frecuentes
Concepto y alcance técnico
El Automation Utility Action Pack es un conjunto de herramientas específico para gestionar y mantener la base de datos de Broadcom Automic Automation desde los propios workflows de Automic. Encapsula las utilidades nativas de Automic como acciones reutilizables y añade procesos combinados para copias de seguridad y reorganizaciones de todo el sistema o de clientes seleccionados. Cada acción funciona tanto de forma interactiva como en modo por lotes.
Por qué es importante el mantenimiento de la base de datos
Durante el funcionamiento diario de un sistema Automation Engine se acumulan muchos datos: estadísticas, informes, mensajes y los datos para el AE DB Revision Report y para la interfaz con los sistemas de gestión de salidas (output management). Las utilidades de Automic son las herramientas que utilizan los administradores para mantener la base de datos reducida, reorganizarla con una pérdida mínima de integridad y mantener la rapidez del sistema.
Automic suministra estas utilidades como programas con una interfaz gráfica y un modo por lotes. El Automation Utility Action Pack integra precisamente estos programas en Automic y los combina en procesos de mantenimiento listos para usar.
Qué es un Action Pack
Los Action Packs son módulos de integración predefinidos para plataformas de automatización como Automic Automation. Reúnen acciones preconfiguradas y probadas que pueden reutilizarse en cualquier workflow, de modo que las automatizaciones complejas se crean más rápido y con menos problemas que resolver. El Automation Utility Action Pack sigue el mismo modelo: cada tarea de mantenimiento de la base de datos es una acción parametrizada que puede iniciarse desde la AWI o integrarse en un workflow.
Componentes y funciones principales
El Automation Utility Action Pack abarca tres áreas funcionales:
Utilidades individuales
- DB Archive (ucybdbar)
- DB Change (ucybdbch)
- DB Client Copy (ucybdbcc)
- DB Load (ucybdbld)
- DB Reorg (ucybdbre)
- DB Unload (ucybdbun)
Procesos combinados
- Copia de seguridad de todo el sistema (DB Backup Full)
- Copia de seguridad de clientes seleccionados (DB Backup Part)
- Reorganización de todo el sistema (DB Reorg Full)
- Reorganización de clientes seleccionados (DB Reorg Part)
Configuración inicial
- Una acción CONFIGURATION que guarda los directorios de las utilidades y los ajustes del sistema operativo para todas las demás acciones
Ventajas
- Procesos estandarizados — el archivado, la reorganización, las copias de seguridad y las copias de clientes se ejecutan del mismo modo en todos los sistemas Automic.
- Mayor facilidad de uso — los formularios de entrada con valores precargados sustituyen a las líneas de comandos escritas a mano para los programas de utilidades.
- Integración nativa en Automic — el paquete sigue el concepto de Action Pack, por lo que cada acción puede iniciarse desde la AWI o como paso de un workflow.
Requisitos y compatibilidad
Automic Automation
- Versión mínima: Automic Automation V24
- Instalación en cualquier cliente excepto el cliente 0
Utilidades de Automic
- Las utilidades de Automic instaladas en el host que ejecuta los jobs de las utilidades, con un directorio bin y un directorio temp (por ejemplo, /opt/automic/Utility/bin)
- Un agente de Automic en ese host; las acciones se ejecutan como jobs de Windows o UNIX
ITPA Shared Action Pack
- Opcional: el Action Pack dependiente PCK.ITPA_SHARED; instálelo primero si todavía no está presente
Instalación
El Automation Utility Action Pack se instala mediante el mecanismo estándar de Action Packs de Automic. Se puede instalar en cualquier cliente del sistema Automic Automation excepto en el cliente 0. El mismo procedimiento se utiliza para la instalación inicial y para las actualizaciones a una versión más reciente.
Instalar o actualizar
Desinstalar
Para eliminar el Automation Utility Action Pack de un cliente, siga estos pasos:
Referencia de configuración
Tras la instalación, el Automation Utility Action Pack necesita saber dónde están instaladas las utilidades de Automic y cómo se inician sus jobs en el sistema operativo. Esto se define una sola vez con la acción CONFIGURATION; todas las demás acciones leen los valores guardados.
Proceso de configuración
Parámetros de configuración
Parámetros de la acción PCK.TRICISE_AUT_UTILITY.PUB.ACTION.CONFIGURATION:
| Parámetro | Variable | Descripción y ejemplo |
|---|---|---|
| Utility bin-directory | &AUT_UTILITY_BIN_DIR# | Directorio bin de las utilidades de Automic. Ejemplo: /opt/automic/Utility/bin |
| Utility temp-directory | &AUT_UTILITY_TEMP_DIR# | Directorio temp de las utilidades de Automic. Ejemplo: /opt/automic/Utility/temp |
| Unix shell (optional) | &AUT_UTILITY_UNIX_SHELL# | Shell para los jobs de las utilidades cuando estas se ejecutan en UNIX. Ejemplo: ksh |
| Win logon as batch | &AUT_UTILITY_WIN_BATCHMODE# | Ajuste de inicio de sesión como proceso por lotes (log on as batch) para los jobs de las utilidades cuando estas se ejecutan en Windows. Ejemplo: N |
Referencia de acciones
El Automation Utility Action Pack incluye 11 acciones: la acción de configuración, seis acciones para las utilidades individuales de Automic y cuatro procesos combinados. Cada acción tiene un nombre de objeto completo que sigue el patrón PCK.TRICISE_AUT_UTILITY.PUB.ACTION.<NAME> y puede ejecutarse de forma interactiva desde la AWI o de forma desatendida como parte de un workflow.
Visión general
| Acción | Nombre del objeto | Qué hace |
|---|---|---|
| Configuration | CONFIGURATION | Guarda los directorios de las utilidades y los ajustes del sistema operativo para todas las demás acciones. |
| DB Archive | DBARCHIVE | Ejecuta DB Archive (ucybdbar) para un cliente. |
| DB Change | DBCHANGE | Ejecuta DB Change (ucybdbch) sobre un caso de transporte. |
| DB Client Copy | DBCLIENTCOPY | Ejecuta DB Client Copy (ucybdbcc) para copiar o eliminar un cliente. |
| DB Load | DBLOAD | Ejecuta DB Load (ucybdbld) para cargar un caso de transporte o un archivo de carga inicial. |
| DB Reorg | DBREORG | Ejecuta DB Reorg (ucybdbre) para un cliente. |
| DB Unload | DBUNLOAD | Ejecuta DB Unload (ucybdbun) para un cliente. |
| DB Backup Full | DBBACKUPFULL | Realiza una copia de seguridad de todos los clientes, excepto el cliente 0, en un único caso de transporte. |
| DB Backup Part | DBBACKUPPART | Realiza una copia de seguridad de una lista de clientes seleccionados. |
| DB Reorg Full | DBREORGFULL | Archiva, reorganiza y descarga todos los clientes, uno tras otro. |
| DB Reorg Part | DBREORGPART | Archiva, reorganiza y descarga una lista de clientes seleccionados. |
4.1 · Configuration
Crea la configuración que utilizan todas las demás acciones para ejecutar las utilidades de Automic.
Nombre del objeto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.CONFIGURATION
Parámetros: consulte la referencia de configuración en la sección 3.
4.2 · DB Archive
Ejecuta la utilidad de Automic DB Archive (ucybdbar) para un cliente y establece los indicadores de archivado de sus estadísticas, informes y mensajes.
Nombre del objeto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBARCHIVE
| Parámetro | Variable | Descripción y ejemplo |
|---|---|---|
| Cliente | &AUT_UTILITY_CLIENT# | Cliente para el que se establecen los indicadores de archivado. Ejemplo: 0000 |
4.3 · DB Change
Ejecuta la utilidad de Automic DB Change (ucybdbch). Aplica las reglas de un script de cambios a un caso de transporte y escribe el resultado en un archivo nuevo, por ejemplo para cambiar el nombre de hosts o adaptar objetos a otro entorno.
Nombre del objeto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBCHANGE
| Parámetro | Variable | Descripción y ejemplo |
|---|---|---|
| Script file | &AUT_UTILITY_SCRIPTFILENAME# | Archivo de script de cambios con las reglas de modificación. Ejemplo: /opt/automic/Utility/db/uc_rules.txt |
| Transport file | &AUT_UTILITY_TRANSPORTFILENAME# | Archivo del caso de transporte que se usa como entrada. Ejemplo: /opt/automic/Utility/db/uc_data.txt |
| Output file | &AUT_UTILITY_OUTPUTFILENAME# | Archivo del caso de transporte que se genera como salida. Ejemplo: /opt/automic/Utility/db/uc_changed.txt |
4.4 · DB Client Copy
Ejecuta la utilidad de Automic DB Client Copy (ucybdbcc) para copiar o eliminar un cliente.
Nombre del objeto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBCLIENTCOPY
| Parámetro | Variable | Descripción y ejemplo |
|---|---|---|
| Mode | &AUT_UTILITY_MODE# | Modo de la copia de clientes: COPY o DELETE. Ejemplo: COPY |
| Source client | &AUT_UTILITY_CLIENT_SRC# | Cliente desde el que se copia o cliente que se elimina. Ejemplo: 0001 |
| Destination client | &AUT_UTILITY_CLIENT_DST# | Cliente al que se copia. Ejemplo: 9999 |
| Copy messages | &AUT_UTILITY_COPY_MESSSAGES# | Incluir los mensajes en la copia. Valores: true / false. Ejemplo: false |
| Copy statistics/reports | &AUT_UTILITY_COPY_STATISTICS# | Incluir las estadísticas y los informes en la copia. Valores: true / false. Ejemplo: false |
| Reset passwords | &AUT_UTILITY_RESET_PASSWORD# | Restablecer las contraseñas de usuario en el cliente copiado. Valores: true / false. Ejemplo: false |
| Copy version objects | &AUT_UTILITY_COPY_VERSIONS# | Incluir los objetos de versión en la copia. Valores: true / false. Ejemplo: false |
| Delete work files | &AUT_UTILITY_DELETE_FILES# | Eliminar los archivos de trabajo después de la ejecución. Valores: true / false. Ejemplo: true |
4.5 · DB Load
Ejecuta la utilidad de Automic DB Load (ucybdbld) para cargar un caso de transporte o un archivo de carga inicial en un cliente.
Nombre del objeto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBLOAD
| Parámetro | Variable | Descripción y ejemplo |
|---|---|---|
| Cliente | &AUT_UTILITY_CLIENT# | Cliente en el que se carga el caso de transporte. Ejemplo: 0001 |
| File name | &AUT_UTILITY_FILENAME# | Caso de transporte o archivo de carga inicial. Ejemplo: /opt/automic/Utility/db/uc_data.txt |
| Mode | &AUT_UTILITY_MODE# | Modo de carga: IGNORE, REPLACE o ABEND. Ejemplo: IGNORE |
4.6 · DB Reorg
Ejecuta la utilidad de Automic DB Reorg (ucybdbre) para un cliente y establece los indicadores de reorganización de sus datos.
Nombre del objeto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBREORG
| Parámetro | Variable | Descripción y ejemplo |
|---|---|---|
| Cliente | &AUT_UTILITY_CLIENT# | Cliente para el que se establecen los indicadores de reorganización. Ejemplo: 0000 |
4.7 · DB Unload
Ejecuta la utilidad de Automic DB Unload (ucybdbun) para un cliente y escribe el resultado en un archivo. El modo determina qué se descarga.
Nombre del objeto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBUNLOAD
| Parámetro | Variable | Descripción y ejemplo |
|---|---|---|
| Cliente | &AUT_UTILITY_CLIENT# | Cliente que se descarga. Ejemplo: 0000 |
| File name | &AUT_UTILITY_FILENAME# | Archivo de salida para el caso de transporte. Ejemplo: /opt/automic/Utility/db/uc_data.txt |
| Mode | &AUT_UTILITY_MODE# | Modo de descarga: DEFAULT, NORMAL, REORG, REPAIR, RESETARCHIVE, RESETREORG, TRANSPORT, TRANSPORTALL. Ejemplo: TRANSPORT |
4.8 · DB Backup Full
Realiza una copia de seguridad de todos los clientes del sistema Automic, excepto el cliente 0, en un único caso de transporte.
Nombre del objeto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBBACKUPFULL
Subprocesos:
- DBUNLOAD
| Parámetro | Variable | Descripción y ejemplo |
|---|---|---|
| Backup path | &AUT_UTILITY_BACKUPPATH# | Directorio para los casos de transporte de la copia de seguridad. Ejemplo: /opt/automic/Utility/db |
4.9 · DB Backup Part
Realiza una copia de seguridad de una lista de clientes seleccionados y crea casos de transporte para ellos.
Nombre del objeto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBBACKUPPART
Subprocesos:
- DBUNLOAD
| Parámetro | Variable | Descripción y ejemplo |
|---|---|---|
| Clients | &AUT_UTILITY_CLIENTS# | Lista separada por comas de los clientes de los que se hace copia de seguridad. Ejemplo: 0001,0002 |
| Backup path | &AUT_UTILITY_BACKUPPATH# | Directorio para los casos de transporte de la copia de seguridad. Ejemplo: /opt/automic/Utility/db |
4.10 · DB Reorg Full
Reorganiza todos los clientes del sistema Automic. El archivado, la reorganización y la descarga se ejecutan cliente por cliente, de modo que cada cliente se procesa por completo antes de empezar con el siguiente.
Nombre del objeto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBREORGFULL
Subprocesos:
- DBARCHIVE
- DBREORG
- DBUNLOAD
| Parámetro | Variable | Descripción y ejemplo |
|---|---|---|
| Archive | &AUT_UTILITY_ARCHIVE# | Ejecutar DB Archive como parte de la reorganización. Valores: true / false. Ejemplo: false |
| Reorg | &AUT_UTILITY_REORG# | Ejecutar DB Reorg, que elimina estadísticas antiguas, informes y datos similares. Valores: true / false. Ejemplo: true |
4.11 · DB Reorg Part
Reorganiza una lista de clientes seleccionados, con la misma secuencia cliente por cliente que DB Reorg Full.
Nombre del objeto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBREORGPART
Subprocesos:
- DBARCHIVE
- DBREORG
- DBUNLOAD
| Parámetro | Variable | Descripción y ejemplo |
|---|---|---|
| Clients | &AUT_UTILITY_CLIENTS# | Lista separada por comas de los clientes que se van a reorganizar. Ejemplo: 0001,0002 |
| Archive | &AUT_UTILITY_ARCHIVE# | Ejecutar DB Archive como parte de la reorganización. Valores: true / false. Ejemplo: false |
| Reorg | &AUT_UTILITY_REORG# | Ejecutar DB Reorg, que elimina estadísticas antiguas, informes y datos similares. Valores: true / false. Ejemplo: true |
Actualización y migración
Las actualizaciones del Automation Utility Action Pack siguen el mismo procedimiento que la instalación inicial: Administration → Packs → Install From File, seleccione el nuevo archivo y confirme con Install. El mecanismo de Action Packs de Automic sustituye automáticamente la versión instalada.
Antes de actualizar
- Asegúrese de que no se esté ejecutando ningún proceso de copia de seguridad o reorganización y ponga en pausa los workflows planificados que utilizan el Action Pack
- Si está instalado, compruebe que la versión del Action Pack dependiente PCK.ITPA_SHARED es compatible con la nueva versión
- Haga una copia de seguridad del cliente si su entorno requiere un punto de restauración
Después de actualizar
- La configuración se mantiene; no es necesario volver a ejecutar CONFIGURATION
- Ejecute una acción breve en un cliente de prueba como prueba de humo (smoke test)
- Reanude los workflows en pausa
Notas de la versión
Todas las versiones del Automation Utility Action Pack y los cambios de cada una.
v1.7.5 (actual) · 2025-07-10
| Versión | Tipo | Cambio |
|---|---|---|
| 1.7.5 2025-07-10 | Corregido | El include PREPROCESS ya no establece ARCHIVE_KEY1, porque DB Change no tiene variable de cliente |
Versiones anteriores
Versiones 1.0.0 – 1.7.4
| Versión | Tipo | Cambio |
|---|---|---|
| 1.7.4 2024-02-29 | Modificado | El Action Pack pasa a llamarse PCK.TRICISE_AUT_UTILITY |
| 1.7.3 2023-12-19 | Corregido | Las opciones de los procesos de reorganización y copia de seguridad se pueden volver a configurar |
| Corregido | ARCHIVE_KEY1 contiene el número de cliente a nivel de job | |
| Corregido | Se añaden sentencias de Db2 a las variables SQLI | |
| 1.7.2 2023-09-08 | Modificado | Mejoras de usabilidad con campos precargados |
| 1.7.1 2023-08-28 | Modificado | Se añade un include de prescript a los jobs |
| Modificado | Los jobs de Windows establecen el atributo WIN_LOGON_AS_BATCH | |
| 1.7.0 2023-04-03 | Nuevo | Acción DB Change |
| 1.6.0 2023-02-15 | Modificado | El Action Pack pasa a llamarse PCK.CAPTURE_AUT_UTILITY |
| Nuevo | Acción DB Revision Report | |
| 1.5.0 2022-11-24 | Nuevo | Acción DB Backup Part: casos de transporte para varios clientes |
| Nuevo | Acción DB Backup Full: un único caso de transporte para todos los clientes excepto el cliente 0 | |
| 1.4.3 | Corregido | Se eliminan los archivos JAR del objeto STORE de las bibliotecas |
| 1.4.2 | Corregido | DB Reorg Full y DB Reorg Part: las precondiciones del bucle se repiten en lugar de ejecutarse una sola vez |
| 1.4.1 | Corregido | DB Reorg Full y DB Reorg Part: precondiciones del bucle ausentes o incorrectas para la comprobación true/false |
| 1.4.0 | Corregido | Las acciones de reorganización pasan siempre el cliente con -S en lugar de -D |
| Modificado | DB Reorg Full y DB Reorg Part ejecutan el archivado, la reorganización y la descarga cliente por cliente en lugar de paso a paso | |
| Modificado | Las acciones se detienen en caso de ENDED_NOT_OK | |
| Modificado | Includes de comandos con un nuevo orden de parámetros | |
| Nuevo | Acción CONFIGURATION para la configuración inicial del Action Pack | |
| 1.3.2 | Corregido | El bucle de archivado de DB Reorg Full utiliza &AUT_UTILITY_CLIENT# en lugar de &CLIENT# |
| Modificado | Las actualizaciones ya no sobrescriben el objeto de configuración PCK.CUSTOM_AUT_UTILITY.PRV.VARA.CONFIG_DEFAULT.ORI | |
| 1.3.1 | Corregido | El bucle de archivado de DB Reorg Part utiliza &AUT_UTILITY_CLIENT# en lugar de &CLIENT# |
| 1.3.0 | Nuevo | Acción DB Reorg Part |
| 1.2.0 | Nuevo | Acción DB Reorg Full |
| 1.1.1 | Modificado | Shell configurable para los jobs de UNIX (valor predeterminado -bash) |
| 1.1.0 | Nuevo | Acción DB Client Copy |
| 1.0.0 | Nuevo | Versión inicial con DB Load, DB Unload, DB Archive y DB Reorg |
Preguntas frecuentes
Haga clic en cualquier pregunta para ver la respuesta.
¿Qué es el Automation Utility Action Pack y qué hace?
El Automation Utility Action Pack es un conjunto de herramientas de Tricise que ejecuta las utilidades nativas de base de datos de Automic como acciones reutilizables. Abarca DB Archive, DB Change, DB Client Copy, DB Load, DB Reorg y DB Unload, además de procesos combinados de copia de seguridad y reorganización para todo el sistema o para clientes seleccionados, de modo que el mantenimiento de la base de datos se ejecuta desde workflows de Automic en lugar de scripts escritos a mano.
¿Qué utilidades de Automic se incluyen?
Seis utilidades, cada una como acción propia:
- DB Archive (ucybdbar) — acción DBARCHIVE
- DB Change (ucybdbch) — acción DBCHANGE
- DB Client Copy (ucybdbcc) — acción DBCLIENTCOPY
- DB Load (ucybdbld) — acción DBLOAD
- DB Reorg (ucybdbre) — acción DBREORG
- DB Unload (ucybdbun) — acción DBUNLOAD
Los cuatro procesos combinados DB Backup Full, DB Backup Part, DB Reorg Full y DB Reorg Part encadenan estas utilidades.
¿Qué versiones de Automic y qué plataformas se admiten?
El Automation Utility Action Pack requiere Automic Automation V24 o superior. Los jobs de las utilidades se ejecutan en el host Windows o UNIX en el que están instaladas las utilidades de Automic. En UNIX se puede definir el shell; en Windows, el ajuste de inicio de sesión como proceso por lotes (log on as batch).
¿Qué diferencia hay entre los procesos Full y Part?
Los procesos Full actúan sobre todo el sistema: DB Backup Full escribe un único caso de transporte con todos los clientes excepto el cliente 0, y DB Reorg Full reorganiza todos los clientes. Los procesos Part actúan sobre una lista de clientes separada por comas, por ejemplo 0001,0002.
¿En qué orden se ejecuta una reorganización?
DB Reorg Full y DB Reorg Part procesan un cliente tras otro. Para cada cliente ejecutan DB Archive (si Archive está establecido en true), DB Reorg (si Reorg está establecido en true) y DB Unload. Si un paso termina con ENDED_NOT_OK, el proceso se detiene.
¿Dónde se guardan las copias de seguridad?
DB Backup Full y DB Backup Part escriben los casos de transporte creados por DB Unload en el directorio definido en el parámetro Backup path (&AUT_UTILITY_BACKUPPATH#), por ejemplo /opt/automic/Utility/db.
¿Puedo copiar o eliminar un cliente?
Sí. DB Client Copy se ejecuta en modo COPY o DELETE. En una copia, usted decide si se incluyen los mensajes, las estadísticas e informes y los objetos de versión, si se restablecen las contraseñas y si los archivos de trabajo se eliminan después de la ejecución.
¿Se conserva mi configuración cuando actualizo el Action Pack?
Sí. La configuración se guarda en la parte personalizada del paquete (PCK.CUSTOM_AUT_UTILITY) y una actualización no la sobrescribe. Si viene de una versión anterior a la 1.7.4, cambie sus workflows a los nuevos nombres de objeto PCK.TRICISE_AUT_UTILITY.*.
¿Cómo se licencia el Automation Utility Action Pack?
El Automation Utility Action Pack se licencia como compra única de 3.200 € (IVA no incluido) por sistema Automic, sin suscripción recurrente ni caducidad. La licencia incluye el soporte de producto de Tricise y las actualizaciones de compatibilidad para la línea de versiones actual Automic V24+.