- Ambito tecnico e concetto
- Installazione — installazione, aggiornamento e disinstallazione
- Configurazione — directory delle utility e impostazioni del sistema operativo
- Azioni — tutte le 11 azioni con i relativi parametri
- Aggiornamento e migrazione
- Note di rilascio
- Domande frequenti
Concetto e ambito tecnico
L'Automation Utility Action Pack è un toolkit dedicato alla gestione e alla manutenzione del database di Broadcom Automic Automation direttamente dai workflow di Automic. Incapsula le utility native di Automic in azioni riutilizzabili e aggiunge processi combinati per backup e riorganizzazioni dell'intero sistema o di client selezionati. Ogni azione può essere eseguita sia in modalità interattiva sia in modalità batch.
Perché la manutenzione del database è importante
Durante il funzionamento quotidiano di un sistema Automation Engine si accumulano molti dati: statistiche, report, messaggi e i dati per l'AE DB Revision Report e per l'interfaccia verso i sistemi di output management. Le utility di Automic sono gli strumenti con cui gli amministratori mantengono il database snello, lo riorganizzano con una perdita minima di integrità e garantiscono la velocità del sistema.
Automic fornisce queste utility come programmi con un'interfaccia grafica e una modalità batch. L'Automation Utility Action Pack integra proprio questi programmi in Automic e li combina in processi di manutenzione pronti all'uso.
Cos'è un Action Pack
Gli Action Pack sono moduli di integrazione predefiniti per piattaforme di automazione come Automic Automation. Raccolgono azioni preconfigurate e testate, riutilizzabili in qualsiasi workflow, così le automazioni complesse si realizzano più rapidamente e con meno attività di troubleshooting. L'Automation Utility Action Pack segue lo stesso modello: ogni attività di manutenzione del database è un'azione parametrizzata che può essere avviata dall'AWI o inserita in un workflow.
Componenti principali e funzioni
L'Automation Utility Action Pack copre tre aree funzionali:
Singole utility
- DB Archive (ucybdbar)
- DB Change (ucybdbch)
- DB Client Copy (ucybdbcc)
- DB Load (ucybdbld)
- DB Reorg (ucybdbre)
- DB Unload (ucybdbun)
Processi combinati
- Backup dell'intero sistema (DB Backup Full)
- Backup di client selezionati (DB Backup Part)
- Riorganizzazione dell'intero sistema (DB Reorg Full)
- Riorganizzazione di client selezionati (DB Reorg Part)
Configurazione
- Un'azione CONFIGURATION che memorizza le directory delle utility e le impostazioni del sistema operativo per tutte le altre azioni
Vantaggi
- Processi standardizzati — archiviazione, riorganizzazione, backup e copie dei client vengono eseguiti allo stesso modo su ogni sistema Automic.
- Maggiore facilità d'uso — i prompt con valori precompilati sostituiscono le righe di comando scritte a mano per i programmi di utility.
- Integrazione nativa in Automic — il pack segue il concetto degli Action Pack, quindi ogni azione può essere avviata dall'AWI o come passaggio di un workflow.
Requisiti e compatibilità
Automic Automation
- Versione minima: Automic Automation V24
- Installazione in qualsiasi client tranne il client 0
Utility di Automic
- Le utility di Automic installate sull'host che esegue i job delle utility, con una directory bin e una directory temp (ad esempio /opt/automic/Utility/bin)
- Un agente Automic su tale host; le azioni vengono eseguite come job Windows o UNIX
ITPA Shared Action Pack
- Facoltativo: l'Action Pack dipendente PCK.ITPA_SHARED; installalo prima, se non è già presente
Installazione
L'Automation Utility Action Pack viene installato tramite il meccanismo standard degli Action Pack di Automic. Può essere installato in qualsiasi client del sistema Automic Automation eccetto il client 0. La stessa procedura viene utilizzata sia per l'installazione iniziale sia per gli aggiornamenti a una versione più recente.
Installa o aggiorna
Disinstalla
Per rimuovere l'Automation Utility Action Pack da un client, procedi come segue:
Riferimento alla configurazione
Dopo l'installazione, l'Automation Utility Action Pack deve sapere dove sono installate le utility di Automic e come vengono avviati i relativi job sul sistema operativo. Queste impostazioni si definiscono una sola volta con l'azione CONFIGURATION; tutte le altre azioni leggono i valori memorizzati.
Procedura di configurazione
Parametri di configurazione
Parametri dell'azione PCK.TRICISE_AUT_UTILITY.PUB.ACTION.CONFIGURATION:
| Parametro | Variabile | Descrizione ed esempio |
|---|---|---|
| Utility bin-directory | &AUT_UTILITY_BIN_DIR# | Directory bin delle utility di Automic. Esempio: /opt/automic/Utility/bin |
| Utility temp-directory | &AUT_UTILITY_TEMP_DIR# | Directory temp delle utility di Automic. Esempio: /opt/automic/Utility/temp |
| Unix shell (optional) | &AUT_UTILITY_UNIX_SHELL# | Shell per i job delle utility quando le utility vengono eseguite su UNIX. Esempio: ksh |
| Win logon as batch | &AUT_UTILITY_WIN_BATCHMODE# | Impostazione log-on-as-batch per i job delle utility quando le utility vengono eseguite su Windows. Esempio: N |
Riferimento azioni
L'Automation Utility Action Pack include 11 azioni: l'azione di configurazione, sei azioni per le singole utility di Automic e quattro processi combinati. Ogni azione ha un nome oggetto completo secondo lo schema PCK.TRICISE_AUT_UTILITY.PUB.ACTION.<NAME> e può essere eseguita in modo interattivo dall'AWI oppure senza presidio all'interno di un workflow.
Panoramica
| Azione | Nome dell'oggetto | Funzione |
|---|---|---|
| Configuration | CONFIGURATION | Memorizza le directory delle utility e le impostazioni del sistema operativo per tutte le altre azioni. |
| DB Archive | DBARCHIVE | Esegue DB Archive (ucybdbar) per un client. |
| DB Change | DBCHANGE | Esegue DB Change (ucybdbch) su un caso di trasporto. |
| DB Client Copy | DBCLIENTCOPY | Esegue DB Client Copy (ucybdbcc) per copiare o eliminare un client. |
| DB Load | DBLOAD | Esegue DB Load (ucybdbld) per caricare un caso di trasporto o un file di caricamento iniziale. |
| DB Reorg | DBREORG | Esegue DB Reorg (ucybdbre) per un client. |
| DB Unload | DBUNLOAD | Esegue DB Unload (ucybdbun) per un client. |
| DB Backup Full | DBBACKUPFULL | Esegue il backup di tutti i client tranne il client 0 in un unico caso di trasporto. |
| DB Backup Part | DBBACKUPPART | Esegue il backup di un elenco di client selezionati. |
| DB Reorg Full | DBREORGFULL | Archivia, riorganizza e scarica tutti i client, uno dopo l'altro. |
| DB Reorg Part | DBREORGPART | Archivia, riorganizza e scarica un elenco di client selezionati. |
4.1 · Configuration
Crea la configurazione che tutte le altre azioni utilizzano per eseguire le utility di Automic.
Nome dell'oggetto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.CONFIGURATION
Parametri: vedi il riferimento alla configurazione nella sezione 3.
4.2 · DB Archive
Esegue l'utility di Automic DB Archive (ucybdbar) per un client e imposta i flag di archiviazione per statistiche, report e messaggi del client.
Nome dell'oggetto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBARCHIVE
| Parametro | Variabile | Descrizione ed esempio |
|---|---|---|
| Client | &AUT_UTILITY_CLIENT# | Client per il quale vengono impostati i flag di archiviazione. Esempio: 0000 |
4.3 · DB Change
Esegue l'utility di Automic DB Change (ucybdbch). Applica le regole di uno script di modifica a un caso di trasporto e scrive il risultato in un nuovo file, ad esempio per rinominare host o adattare oggetti a un altro ambiente.
Nome dell'oggetto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBCHANGE
| Parametro | Variabile | Descrizione ed esempio |
|---|---|---|
| Script file | &AUT_UTILITY_SCRIPTFILENAME# | File dello script di modifica con le regole di modifica. Esempio: /opt/automic/Utility/db/uc_rules.txt |
| Transport file | &AUT_UTILITY_TRANSPORTFILENAME# | File del caso di trasporto usato come input. Esempio: /opt/automic/Utility/db/uc_data.txt |
| Output file | &AUT_UTILITY_OUTPUTFILENAME# | File del caso di trasporto scritto come output. Esempio: /opt/automic/Utility/db/uc_changed.txt |
4.4 · DB Client Copy
Esegue l'utility di Automic DB Client Copy (ucybdbcc) per copiare o eliminare un client.
Nome dell'oggetto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBCLIENTCOPY
| Parametro | Variabile | Descrizione ed esempio |
|---|---|---|
| Mode | &AUT_UTILITY_MODE# | Modalità della copia client: COPY o DELETE. Esempio: COPY |
| Source client | &AUT_UTILITY_CLIENT_SRC# | Client da cui copiare oppure client da eliminare. Esempio: 0001 |
| Destination client | &AUT_UTILITY_CLIENT_DST# | Client di destinazione della copia. Esempio: 9999 |
| Copy messages | &AUT_UTILITY_COPY_MESSSAGES# | Includere i messaggi nella copia. Valori: true / false. Esempio: false |
| Copy statistics/reports | &AUT_UTILITY_COPY_STATISTICS# | Includere statistiche e report nella copia. Valori: true / false. Esempio: false |
| Reset passwords | &AUT_UTILITY_RESET_PASSWORD# | Reimpostare le password degli utenti nel client copiato. Valori: true / false. Esempio: false |
| Copy version objects | &AUT_UTILITY_COPY_VERSIONS# | Includere gli oggetti di versione nella copia. Valori: true / false. Esempio: false |
| Delete work files | &AUT_UTILITY_DELETE_FILES# | Eliminare i file di lavoro dopo l'esecuzione. Valori: true / false. Esempio: true |
4.5 · DB Load
Esegue l'utility di Automic DB Load (ucybdbld) per caricare in un client un caso di trasporto o un file di caricamento iniziale.
Nome dell'oggetto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBLOAD
| Parametro | Variabile | Descrizione ed esempio |
|---|---|---|
| Client | &AUT_UTILITY_CLIENT# | Client in cui viene caricato il caso di trasporto. Esempio: 0001 |
| File name | &AUT_UTILITY_FILENAME# | Caso di trasporto o file di caricamento iniziale. Esempio: /opt/automic/Utility/db/uc_data.txt |
| Mode | &AUT_UTILITY_MODE# | Modalità di caricamento: IGNORE, REPLACE o ABEND. Esempio: IGNORE |
4.6 · DB Reorg
Esegue l'utility di Automic DB Reorg (ucybdbre) per un client e imposta i flag di riorganizzazione per i relativi dati.
Nome dell'oggetto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBREORG
| Parametro | Variabile | Descrizione ed esempio |
|---|---|---|
| Client | &AUT_UTILITY_CLIENT# | Client per il quale vengono impostati i flag di riorganizzazione. Esempio: 0000 |
4.7 · DB Unload
Esegue l'utility di Automic DB Unload (ucybdbun) per un client e scrive il risultato in un file. La modalità determina cosa viene scaricato.
Nome dell'oggetto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBUNLOAD
| Parametro | Variabile | Descrizione ed esempio |
|---|---|---|
| Client | &AUT_UTILITY_CLIENT# | Client da scaricare. Esempio: 0000 |
| File name | &AUT_UTILITY_FILENAME# | File di output per il caso di trasporto. Esempio: /opt/automic/Utility/db/uc_data.txt |
| Mode | &AUT_UTILITY_MODE# | Modalità di scaricamento: DEFAULT, NORMAL, REORG, REPAIR, RESETARCHIVE, RESETREORG, TRANSPORT, TRANSPORTALL. Esempio: TRANSPORT |
4.8 · DB Backup Full
Esegue il backup di tutti i client del sistema Automic tranne il client 0 in un unico caso di trasporto.
Nome dell'oggetto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBBACKUPFULL
Sottoprocessi:
- DBUNLOAD
| Parametro | Variabile | Descrizione ed esempio |
|---|---|---|
| Backup path | &AUT_UTILITY_BACKUPPATH# | Directory per i casi di trasporto del backup. Esempio: /opt/automic/Utility/db |
4.9 · DB Backup Part
Esegue il backup di un elenco di client selezionati e crea i relativi casi di trasporto.
Nome dell'oggetto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBBACKUPPART
Sottoprocessi:
- DBUNLOAD
| Parametro | Variabile | Descrizione ed esempio |
|---|---|---|
| Clients | &AUT_UTILITY_CLIENTS# | Elenco separato da virgole dei client di cui eseguire il backup. Esempio: 0001,0002 |
| Backup path | &AUT_UTILITY_BACKUPPATH# | Directory per i casi di trasporto del backup. Esempio: /opt/automic/Utility/db |
4.10 · DB Reorg Full
Riorganizza tutti i client del sistema Automic. Archiviazione, reorg e scaricamento vengono eseguiti client per client, quindi ogni client viene elaborato completamente prima che inizi il successivo.
Nome dell'oggetto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBREORGFULL
Sottoprocessi:
- DBARCHIVE
- DBREORG
- DBUNLOAD
| Parametro | Variabile | Descrizione ed esempio |
|---|---|---|
| Archive | &AUT_UTILITY_ARCHIVE# | Eseguire DB Archive nell'ambito della riorganizzazione. Valori: true / false. Esempio: false |
| Reorg | &AUT_UTILITY_REORG# | Eseguire DB Reorg, che rimuove statistiche e report obsoleti e dati simili. Valori: true / false. Esempio: true |
4.11 · DB Reorg Part
Riorganizza un elenco di client selezionati, con la stessa sequenza client per client di DB Reorg Full.
Nome dell'oggetto: PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBREORGPART
Sottoprocessi:
- DBARCHIVE
- DBREORG
- DBUNLOAD
| Parametro | Variabile | Descrizione ed esempio |
|---|---|---|
| Clients | &AUT_UTILITY_CLIENTS# | Elenco separato da virgole dei client da riorganizzare. Esempio: 0001,0002 |
| Archive | &AUT_UTILITY_ARCHIVE# | Eseguire DB Archive nell'ambito della riorganizzazione. Valori: true / false. Esempio: false |
| Reorg | &AUT_UTILITY_REORG# | Eseguire DB Reorg, che rimuove statistiche e report obsoleti e dati simili. Valori: true / false. Esempio: true |
Aggiornamento e migrazione
Gli aggiornamenti dell'Automation Utility Action Pack seguono la stessa procedura dell'installazione iniziale: Administration → Packs → Install From File, seleziona il nuovo file e conferma con Install. Il meccanismo degli Action Pack di Automic sostituisce automaticamente la versione installata.
Prima dell'aggiornamento
- Assicurati che non sia in esecuzione alcun processo di backup o di riorganizzazione e sospendi i workflow pianificati che utilizzano l'Action Pack
- Se è installato, verifica che l'Action Pack dipendente PCK.ITPA_SHARED sia in una versione compatibile con la nuova release
- Esegui un backup del client se il tuo ambiente richiede un punto di ripristino
Dopo l'aggiornamento
- La configurazione resta invariata; non è necessario eseguire di nuovo CONFIGURATION
- Esegui una breve azione su un client di test come smoke test
- Riprendi i workflow sospesi
Note di rilascio
Tutte le versioni dell'Automation Utility Action Pack e le modifiche introdotte in ciascuna.
v1.7.5 (attuale) · 2025-07-10
| Versione | Tipo | Modifica |
|---|---|---|
| 1.7.5 2025-07-10 | Corretto | L'include PREPROCESS non imposta più ARCHIVE_KEY1, perché DB Change non ha una variabile per il client |
Versioni precedenti
Versioni 1.0.0 – 1.7.4
| Versione | Tipo | Modifica |
|---|---|---|
| 1.7.4 2024-02-29 | Modificato | Action Pack rinominato in PCK.TRICISE_AUT_UTILITY |
| 1.7.3 2023-12-19 | Corretto | Le opzioni dei processi di riorganizzazione e di backup possono essere di nuovo configurate |
| Corretto | ARCHIVE_KEY1 contiene il numero del client a livello di job | |
| Corretto | Istruzioni Db2 aggiunte alle variabili SQLI | |
| 1.7.2 2023-09-08 | Modificato | Miglioramenti della facilità d'uso con campi precompilati |
| 1.7.1 2023-08-28 | Modificato | Include di prescript aggiunto ai job |
| Modificato | I job Windows impostano l'attributo WIN_LOGON_AS_BATCH | |
| 1.7.0 2023-04-03 | Nuovo | Azione DB Change |
| 1.6.0 2023-02-15 | Modificato | Action Pack rinominato in PCK.CAPTURE_AUT_UTILITY |
| Nuovo | Azione DB Revision Report | |
| 1.5.0 2022-11-24 | Nuovo | Azione DB Backup Part: casi di trasporto per più client |
| Nuovo | Azione DB Backup Full: un unico caso di trasporto per tutti i client tranne il client 0 | |
| 1.4.3 | Corretto | File JAR rimossi dall'oggetto Store delle librerie |
| 1.4.2 | Corretto | DB Reorg Full e DB Reorg Part: le precondizioni del ciclo vengono ripetute anziché essere eseguite una sola volta |
| 1.4.1 | Corretto | DB Reorg Full e DB Reorg Part: precondizioni del ciclo mancanti o errate per il controllo true/false |
| 1.4.0 | Corretto | Le azioni di reorg passano sempre il client con -S anziché con -D |
| Modificato | DB Reorg Full e DB Reorg Part eseguono archiviazione, reorg e scaricamento client per client anziché passaggio per passaggio | |
| Modificato | Le azioni si arrestano in caso di ENDED_NOT_OK | |
| Modificato | Include dei comandi con un ordine dei parametri riorganizzato | |
| Nuovo | Azione CONFIGURATION per la configurazione iniziale dell'Action Pack | |
| 1.3.2 | Corretto | Il ciclo di archiviazione di DB Reorg Full usa &AUT_UTILITY_CLIENT# anziché &CLIENT# |
| Modificato | L'oggetto di configurazione PCK.CUSTOM_AUT_UTILITY.PRV.VARA.CONFIG_DEFAULT.ORI non viene più sovrascritto dagli aggiornamenti | |
| 1.3.1 | Corretto | Il ciclo di archiviazione di DB Reorg Part usa &AUT_UTILITY_CLIENT# anziché &CLIENT# |
| 1.3.0 | Nuovo | Azione DB Reorg Part |
| 1.2.0 | Nuovo | Azione DB Reorg Full |
| 1.1.1 | Modificato | Shell per i job UNIX configurabile (predefinita -bash) |
| 1.1.0 | Nuovo | Azione DB Client Copy |
| 1.0.0 | Nuovo | Versione iniziale con DB Load, DB Unload, DB Archive e DB Reorg |
Domande frequenti
Clicca su una domanda qualsiasi per espandere la risposta.
Che cos'è l'Automation Utility Action Pack e a cosa serve?
L'Automation Utility Action Pack è un toolkit Tricise che esegue le utility di database native di Automic come azioni riutilizzabili. Comprende DB Archive, DB Change, DB Client Copy, DB Load, DB Reorg e DB Unload, oltre a processi combinati di backup e riorganizzazione per l'intero sistema o per client selezionati, così la manutenzione del database viene eseguita dai workflow di Automic anziché da script scritti a mano.
Quali utility di Automic sono incluse?
Sei utility, ciascuna come azione a sé:
- DB Archive (ucybdbar) — azione DBARCHIVE
- DB Change (ucybdbch) — azione DBCHANGE
- DB Client Copy (ucybdbcc) — azione DBCLIENTCOPY
- DB Load (ucybdbld) — azione DBLOAD
- DB Reorg (ucybdbre) — azione DBREORG
- DB Unload (ucybdbun) — azione DBUNLOAD
I quattro processi combinati DB Backup Full, DB Backup Part, DB Reorg Full e DB Reorg Part concatenano queste utility.
Quali versioni e piattaforme Automic sono supportate?
L'Automation Utility Action Pack richiede Automic Automation V24 o superiore. I job delle utility vengono eseguiti sull'host Windows o UNIX su cui sono installate le utility di Automic. Per UNIX puoi impostare la shell, per Windows l'impostazione log-on-as-batch.
Qual è la differenza tra i processi Full e Part?
I processi Full agiscono sull'intero sistema: DB Backup Full scrive un unico caso di trasporto con tutti i client tranne il client 0, mentre DB Reorg Full riorganizza ogni client. I processi Part agiscono su un elenco di client separati da virgole, ad esempio 0001,0002.
In quale ordine viene eseguita una riorganizzazione?
DB Reorg Full e DB Reorg Part elaborano un client dopo l'altro. Per ogni client eseguono DB Archive (se Archive è impostato su true), DB Reorg (se Reorg è impostato su true) e DB Unload. Se un passaggio termina con ENDED_NOT_OK, il processo si arresta.
Dove vengono salvati i backup?
DB Backup Full e DB Backup Part scrivono i casi di trasporto creati da DB Unload nella directory indicata nel parametro Backup path (&AUT_UTILITY_BACKUPPATH#), ad esempio /opt/automic/Utility/db.
Posso copiare o eliminare un client?
Sì. DB Client Copy funziona in modalità COPY o DELETE. Per una copia puoi scegliere se includere i messaggi, le statistiche e i report nonché gli oggetti di versione, se reimpostare le password e se eliminare i file di lavoro dopo l'esecuzione.
La mia configurazione viene mantenuta quando aggiorno l'Action Pack?
Sì. La configurazione è memorizzata nella parte del pack specifica del cliente (PCK.CUSTOM_AUT_UTILITY) e non viene sovrascritta da un aggiornamento. Se provieni da una versione precedente alla 1.7.4, adatta i tuoi workflow ai nuovi nomi degli oggetti PCK.TRICISE_AUT_UTILITY.*.
Come viene concesso in licenza l'Automation Utility Action Pack?
L'Automation Utility Action Pack viene concesso in licenza con un acquisto una tantum di 3.200 € (IVA esclusa) per sistema Automic: nessun abbonamento ricorrente, nessuna scadenza. La licenza include il supporto di prodotto Tricise e gli aggiornamenti di compatibilità per l'attuale linea di release Automic V24+.