- Portée technique et concept
- Installation — installation, mise à jour et désinstallation
- Configuration — répertoires des utilitaires et paramètres du système d'exploitation
- Actions — les 11 actions avec leurs paramètres
- Mise à niveau et migration
- Notes de publication
- FAQ
Concept & portée technique
L'Automation Utility Action Pack est une boîte à outils dédiée à la gestion et à la maintenance de la base de données de Broadcom Automic Automation directement depuis les workflows Automic. Il encapsule les utilitaires natifs d'Automic sous forme d'actions réutilisables et ajoute des processus combinés pour les sauvegardes et les réorganisations de l'ensemble du système ou de clients sélectionnés. Chaque action s'exécute aussi bien en mode interactif qu'en mode batch.
Pourquoi la maintenance de la base de données est importante
Une grande quantité de données s'accumule au cours de l'exploitation quotidienne d'un système Automation Engine : statistiques, rapports, messages ainsi que les données de l'AE DB Revision Report et de l'interface avec les systèmes de gestion des sorties (output management). Les utilitaires Automic sont les outils qu'utilisent les administrateurs pour limiter la taille de la base de données, la réorganiser en préservant au mieux son intégrité et garder un système performant.
Automic fournit ces utilitaires sous forme de programmes dotés d'une interface graphique et d'un mode batch. L'Automation Utility Action Pack intègre précisément ces programmes dans Automic et les combine en processus de maintenance prêts à l'emploi.
Ce qu'est un Action Pack
Les Action Packs sont des modules d'intégration préconstruits pour des plateformes d'automatisation telles qu'Automic Automation. Ils regroupent des actions préconfigurées et testées, réutilisables dans n'importe quel workflow, ce qui permet de construire plus rapidement des automatisations complexes avec moins de dépannage. L'Automation Utility Action Pack suit le même modèle : chaque tâche de maintenance de la base de données est une action paramétrée qui peut être lancée depuis l'AWI ou intégrée dans un workflow.
Composants principaux et fonctions
L'Automation Utility Action Pack couvre trois domaines fonctionnels :
Utilitaires individuels
- DB Archive (ucybdbar)
- DB Change (ucybdbch)
- DB Client Copy (ucybdbcc)
- DB Load (ucybdbld)
- DB Reorg (ucybdbre)
- DB Unload (ucybdbun)
Processus combinés
- Sauvegarde de l'ensemble du système (DB Backup Full)
- Sauvegarde de clients sélectionnés (DB Backup Part)
- Réorganisation de l'ensemble du système (DB Reorg Full)
- Réorganisation de clients sélectionnés (DB Reorg Part)
Mise en place
- Une action CONFIGURATION qui enregistre les répertoires des utilitaires et les paramètres du système d'exploitation pour toutes les autres actions
Avantages
- Processus standardisés — l'archivage, la réorganisation, les sauvegardes et les copies de clients se déroulent de la même manière sur chaque système Automic.
- Meilleure ergonomie — des masques de saisie avec des valeurs préremplies remplacent les lignes de commande rédigées à la main pour les programmes utilitaires.
- Intégration native à Automic — le pack suit le concept des Action Packs : chaque action peut donc être lancée depuis l'AWI ou comme étape d'un workflow.
Exigences et compatibilité
Automic Automation
- Version minimale : Automic Automation V24
- Installation dans n'importe quel client sauf le client 0
Utilitaires Automic
- Les utilitaires Automic installés sur l'hôte qui exécute les jobs utilitaires, avec un répertoire bin et un répertoire temp (par exemple /opt/automic/Utility/bin)
- Un agent Automic sur cet hôte ; les actions s'exécutent en tant que jobs Windows ou UNIX
ITPA Shared Action Pack
- Facultatif : l'Action Pack dépendant PCK.ITPA_SHARED ; installez-le d'abord s'il n'est pas déjà présent
Installation
L'Automation Utility Action Pack est installé via le mécanisme standard des Action Packs Automic. Il peut être installé dans n'importe quel client du système Automic Automation sauf le client 0. La même procédure est utilisée pour l'installation initiale et pour les mises à jour vers une version plus récente.
Installer ou mettre à jour
Désinstaller
Pour supprimer l'Automation Utility Action Pack d'un client, procédez comme suit :
Référence de configuration
Après l'installation, l'Automation Utility Action Pack doit savoir où les utilitaires Automic sont installés et comment leurs jobs sont lancés sur le système d'exploitation. Ces informations sont définies une seule fois avec l'action CONFIGURATION ; toutes les autres actions lisent les valeurs enregistrées.
Procédure de configuration
Paramètres de configuration
Paramètres de l'action PCK.TRICISE_AUT_UTILITY.PUB.ACTION.CONFIGURATION :
| Paramètre | Variable | Description et exemple |
|---|---|---|
| Utility bin-directory | &AUT_UTILITY_BIN_DIR# | Répertoire bin des utilitaires Automic. Exemple : /opt/automic/Utility/bin |
| Utility temp-directory | &AUT_UTILITY_TEMP_DIR# | Répertoire temp des utilitaires Automic. Exemple : /opt/automic/Utility/temp |
| Unix shell (optional) | &AUT_UTILITY_UNIX_SHELL# | Shell des jobs utilitaires lorsque les utilitaires s'exécutent sous UNIX. Exemple : ksh |
| Win logon as batch | &AUT_UTILITY_WIN_BATCHMODE# | Paramètre Log on as batch des jobs utilitaires lorsque les utilitaires s'exécutent sous Windows. Exemple : N |
Référence des actions
L'Automation Utility Action Pack est livré avec 11 actions : l'action de configuration, six actions pour les différents utilitaires Automic et quatre processus combinés. Chaque action possède un nom d'objet entièrement qualifié selon le modèle PCK.TRICISE_AUT_UTILITY.PUB.ACTION.<NAME> et peut être exécutée de manière interactive depuis l'AWI ou sans surveillance dans le cadre d'un workflow.
Vue d'ensemble
| Action | Nom de l'objet | Fonction |
|---|---|---|
| Configuration | CONFIGURATION | Enregistre les répertoires des utilitaires et les paramètres du système d'exploitation pour toutes les autres actions. |
| DB Archive | DBARCHIVE | Exécute DB Archive (ucybdbar) pour un client. |
| DB Change | DBCHANGE | Exécute DB Change (ucybdbch) sur un cas de transport. |
| DB Client Copy | DBCLIENTCOPY | Exécute DB Client Copy (ucybdbcc) pour copier ou supprimer un client. |
| DB Load | DBLOAD | Exécute DB Load (ucybdbld) pour charger un cas de transport ou un fichier de chargement initial. |
| DB Reorg | DBREORG | Exécute DB Reorg (ucybdbre) pour un client. |
| DB Unload | DBUNLOAD | Exécute DB Unload (ucybdbun) pour un client. |
| DB Backup Full | DBBACKUPFULL | Sauvegarde tous les clients, sauf le client 0, dans un seul cas de transport. |
| DB Backup Part | DBBACKUPPART | Sauvegarde une liste de clients sélectionnés. |
| DB Reorg Full | DBREORGFULL | Archive, réorganise et décharge tous les clients, l'un après l'autre. |
| DB Reorg Part | DBREORGPART | Archive, réorganise et décharge une liste de clients sélectionnés. |
4.1 · Configuration
Crée la configuration que toutes les autres actions utilisent pour exécuter les utilitaires Automic.
Nom de l'objet : PCK.TRICISE_AUT_UTILITY.PUB.ACTION.CONFIGURATION
Paramètres : voir la référence de configuration à la section 3.
4.2 · DB Archive
Exécute l'utilitaire Automic DB Archive (ucybdbar) pour un client et définit les indicateurs d'archivage de ses statistiques, rapports et messages.
Nom de l'objet : PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBARCHIVE
| Paramètre | Variable | Description et exemple |
|---|---|---|
| Client | &AUT_UTILITY_CLIENT# | Client pour lequel les indicateurs d'archivage sont définis. Exemple : 0000 |
4.3 · DB Change
Exécute l'utilitaire Automic DB Change (ucybdbch). Il applique les règles d'un script de modification à un cas de transport et écrit le résultat dans un nouveau fichier, par exemple pour renommer des hôtes ou pour adapter des objets à un autre environnement.
Nom de l'objet : PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBCHANGE
| Paramètre | Variable | Description et exemple |
|---|---|---|
| Script file | &AUT_UTILITY_SCRIPTFILENAME# | Fichier de script contenant les règles de modification. Exemple : /opt/automic/Utility/db/uc_rules.txt |
| Transport file | &AUT_UTILITY_TRANSPORTFILENAME# | Fichier de cas de transport utilisé en entrée. Exemple : /opt/automic/Utility/db/uc_data.txt |
| Output file | &AUT_UTILITY_OUTPUTFILENAME# | Fichier de cas de transport écrit en sortie. Exemple : /opt/automic/Utility/db/uc_changed.txt |
4.4 · DB Client Copy
Exécute l'utilitaire Automic DB Client Copy (ucybdbcc) pour copier ou supprimer un client.
Nom de l'objet : PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBCLIENTCOPY
| Paramètre | Variable | Description et exemple |
|---|---|---|
| Mode | &AUT_UTILITY_MODE# | Mode de copie de client : COPY ou DELETE. Exemple : COPY |
| Source client | &AUT_UTILITY_CLIENT_SRC# | Client source de la copie, ou client à supprimer. Exemple : 0001 |
| Destination client | &AUT_UTILITY_CLIENT_DST# | Client cible de la copie. Exemple : 9999 |
| Copy messages | &AUT_UTILITY_COPY_MESSSAGES# | Inclure les messages dans la copie. Valeurs : true / false. Exemple : false |
| Copy statistics/reports | &AUT_UTILITY_COPY_STATISTICS# | Inclure les statistiques et les rapports dans la copie. Valeurs : true / false. Exemple : false |
| Reset passwords | &AUT_UTILITY_RESET_PASSWORD# | Réinitialiser les mots de passe des utilisateurs dans le client copié. Valeurs : true / false. Exemple : false |
| Copy version objects | &AUT_UTILITY_COPY_VERSIONS# | Inclure les objets de version dans la copie. Valeurs : true / false. Exemple : false |
| Delete work files | &AUT_UTILITY_DELETE_FILES# | Supprimer les fichiers de travail après l'exécution. Valeurs : true / false. Exemple : true |
4.5 · DB Load
Exécute l'utilitaire Automic DB Load (ucybdbld) pour charger un cas de transport ou un fichier de chargement initial dans un client.
Nom de l'objet : PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBLOAD
| Paramètre | Variable | Description et exemple |
|---|---|---|
| Client | &AUT_UTILITY_CLIENT# | Client dans lequel le cas de transport est chargé. Exemple : 0001 |
| File name | &AUT_UTILITY_FILENAME# | Fichier de cas de transport ou de chargement initial. Exemple : /opt/automic/Utility/db/uc_data.txt |
| Mode | &AUT_UTILITY_MODE# | Mode de chargement : IGNORE, REPLACE ou ABEND. Exemple : IGNORE |
4.6 · DB Reorg
Exécute l'utilitaire Automic DB Reorg (ucybdbre) pour un client et définit les indicateurs de réorganisation de ses données.
Nom de l'objet : PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBREORG
| Paramètre | Variable | Description et exemple |
|---|---|---|
| Client | &AUT_UTILITY_CLIENT# | Client pour lequel les indicateurs de réorganisation sont définis. Exemple : 0000 |
4.7 · DB Unload
Exécute l'utilitaire Automic DB Unload (ucybdbun) pour un client et écrit le résultat dans un fichier. Le mode détermine ce qui est déchargé.
Nom de l'objet : PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBUNLOAD
| Paramètre | Variable | Description et exemple |
|---|---|---|
| Client | &AUT_UTILITY_CLIENT# | Client à décharger. Exemple : 0000 |
| File name | &AUT_UTILITY_FILENAME# | Fichier de sortie du cas de transport. Exemple : /opt/automic/Utility/db/uc_data.txt |
| Mode | &AUT_UTILITY_MODE# | Mode de déchargement : DEFAULT, NORMAL, REORG, REPAIR, RESETARCHIVE, RESETREORG, TRANSPORT, TRANSPORTALL. Exemple : TRANSPORT |
4.8 · DB Backup Full
Sauvegarde tous les clients du système Automic, sauf le client 0, dans un seul cas de transport.
Nom de l'objet : PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBBACKUPFULL
Sous-processus :
- DBUNLOAD
| Paramètre | Variable | Description et exemple |
|---|---|---|
| Backup path | &AUT_UTILITY_BACKUPPATH# | Répertoire des cas de transport de sauvegarde. Exemple : /opt/automic/Utility/db |
4.9 · DB Backup Part
Sauvegarde une liste de clients sélectionnés et crée des cas de transport pour ceux-ci.
Nom de l'objet : PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBBACKUPPART
Sous-processus :
- DBUNLOAD
| Paramètre | Variable | Description et exemple |
|---|---|---|
| Clients | &AUT_UTILITY_CLIENTS# | Liste des clients à sauvegarder, séparés par des virgules. Exemple : 0001,0002 |
| Backup path | &AUT_UTILITY_BACKUPPATH# | Répertoire des cas de transport de sauvegarde. Exemple : /opt/automic/Utility/db |
4.10 · DB Reorg Full
Réorganise tous les clients du système Automic. L'archivage, la réorganisation et le déchargement s'exécutent client par client : chaque client est entièrement traité avant que le suivant ne commence.
Nom de l'objet : PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBREORGFULL
Sous-processus :
- DBARCHIVE
- DBREORG
- DBUNLOAD
| Paramètre | Variable | Description et exemple |
|---|---|---|
| Archive | &AUT_UTILITY_ARCHIVE# | Exécuter DB Archive dans le cadre de la réorganisation. Valeurs : true / false. Exemple : false |
| Reorg | &AUT_UTILITY_REORG# | Exécuter DB Reorg, qui supprime les anciennes statistiques, les anciens rapports et les données similaires. Valeurs : true / false. Exemple : true |
4.11 · DB Reorg Part
Réorganise une liste de clients sélectionnés, avec le même enchaînement client par client que DB Reorg Full.
Nom de l'objet : PCK.TRICISE_AUT_UTILITY.PUB.ACTION.DBREORGPART
Sous-processus :
- DBARCHIVE
- DBREORG
- DBUNLOAD
| Paramètre | Variable | Description et exemple |
|---|---|---|
| Clients | &AUT_UTILITY_CLIENTS# | Liste des clients à réorganiser, séparés par des virgules. Exemple : 0001,0002 |
| Archive | &AUT_UTILITY_ARCHIVE# | Exécuter DB Archive dans le cadre de la réorganisation. Valeurs : true / false. Exemple : false |
| Reorg | &AUT_UTILITY_REORG# | Exécuter DB Reorg, qui supprime les anciennes statistiques, les anciens rapports et les données similaires. Valeurs : true / false. Exemple : true |
Mise à niveau et migration
Les mises à niveau de l'Automation Utility Action Pack suivent la même procédure que l'installation initiale : Administration → Packs → Install From File, sélectionnez le nouveau fichier et confirmez avec Install. Le mécanisme des Action Packs Automic remplace automatiquement la version installée.
Avant la mise à niveau
- Assurez-vous qu'aucun processus de sauvegarde ou de réorganisation n'est en cours et suspendez les workflows planifiés qui utilisent l'Action Pack
- S'il est installé, vérifiez que l'Action Pack dépendant PCK.ITPA_SHARED est dans une version compatible avec la nouvelle version
- Effectuez une sauvegarde du client si votre environnement exige un point de restauration
Après la mise à niveau
- La configuration est conservée ; il n'est pas nécessaire d'exécuter à nouveau CONFIGURATION
- Exécutez une action courte sur un client de test pour vérifier rapidement le bon fonctionnement
- Reprenez les workflows suspendus
Notes de publication
Toutes les versions de l'Automation Utility Action Pack et les modifications apportées par chacune d'elles.
v1.7.5 (actuelle) · 2025-07-10
| Version | Type | Modification |
|---|---|---|
| 1.7.5 2025-07-10 | Corrigé | L'include PREPROCESS ne définit plus ARCHIVE_KEY1, car DB Change n'a pas de variable de client |
Versions antérieures
Versions 1.0.0 – 1.7.4
| Version | Type | Modification |
|---|---|---|
| 1.7.4 2024-02-29 | Modifié | Action Pack renommé en PCK.TRICISE_AUT_UTILITY |
| 1.7.3 2023-12-19 | Corrigé | Les options des processus de réorganisation et de sauvegarde peuvent de nouveau être configurées |
| Corrigé | ARCHIVE_KEY1 contient le numéro de client au niveau du job | |
| Corrigé | Instructions Db2 ajoutées aux variables SQLI | |
| 1.7.2 2023-09-08 | Modifié | Ergonomie améliorée grâce aux champs préremplis |
| 1.7.1 2023-08-28 | Modifié | Include de prescript ajouté aux jobs |
| Modifié | Les jobs Windows définissent l'attribut WIN_LOGON_AS_BATCH | |
| 1.7.0 2023-04-03 | Nouveau | Action DB Change |
| 1.6.0 2023-02-15 | Modifié | Action Pack renommé en PCK.CAPTURE_AUT_UTILITY |
| Nouveau | Action DB Revision Report | |
| 1.5.0 2022-11-24 | Nouveau | Action DB Backup Part : cas de transport pour plusieurs clients |
| Nouveau | Action DB Backup Full : un seul cas de transport pour tous les clients sauf le client 0 | |
| 1.4.3 | Corrigé | Fichiers JAR retirés de l'objet Storage des bibliothèques |
| 1.4.2 | Corrigé | DB Reorg Full et DB Reorg Part : les préconditions de boucle se répètent au lieu de ne s'exécuter qu'une fois |
| 1.4.1 | Corrigé | DB Reorg Full et DB Reorg Part : préconditions de boucle manquantes ou erronées pour le contrôle true/false |
| 1.4.0 | Corrigé | Les actions de réorganisation transmettent toujours le client avec -S au lieu de -D |
| Modifié | DB Reorg Full et DB Reorg Part exécutent l'archivage, la réorganisation et le déchargement client par client au lieu d'étape par étape | |
| Modifié | Les actions s'arrêtent en cas de statut ENDED_NOT_OK | |
| Modifié | Includes de commande avec un ordre des paramètres réorganisé | |
| Nouveau | Action CONFIGURATION pour la configuration initiale de l'Action Pack | |
| 1.3.2 | Corrigé | La boucle d'archivage de DB Reorg Full utilise &AUT_UTILITY_CLIENT# au lieu de &CLIENT# |
| Modifié | L'objet de configuration PCK.CUSTOM_AUT_UTILITY.PRV.VARA.CONFIG_DEFAULT.ORI n'est plus écrasé lors des mises à jour | |
| 1.3.1 | Corrigé | La boucle d'archivage de DB Reorg Part utilise &AUT_UTILITY_CLIENT# au lieu de &CLIENT# |
| 1.3.0 | Nouveau | Action DB Reorg Part |
| 1.2.0 | Nouveau | Action DB Reorg Full |
| 1.1.1 | Modifié | Shell des jobs UNIX configurable (par défaut -bash) |
| 1.1.0 | Nouveau | Action DB Client Copy |
| 1.0.0 | Nouveau | Version initiale avec DB Load, DB Unload, DB Archive et DB Reorg |
Questions fréquemment posées
Cliquez sur n'importe quelle question pour développer la réponse.
Qu'est-ce que l'Automation Utility Action Pack et à quoi sert-il ?
L'Automation Utility Action Pack est une boîte à outils Tricise qui exécute les utilitaires de base de données natifs d'Automic sous forme d'actions réutilisables. Il couvre DB Archive, DB Change, DB Client Copy, DB Load, DB Reorg et DB Unload, ainsi que des processus combinés de sauvegarde et de réorganisation pour l'ensemble du système ou pour des clients sélectionnés : la maintenance de la base de données s'exécute ainsi depuis des workflows Automic plutôt qu'au moyen de scripts écrits à la main.
Quels utilitaires Automic sont inclus ?
Six utilitaires, chacun sous forme d'action distincte :
- DB Archive (ucybdbar) — action DBARCHIVE
- DB Change (ucybdbch) — action DBCHANGE
- DB Client Copy (ucybdbcc) — action DBCLIENTCOPY
- DB Load (ucybdbld) — action DBLOAD
- DB Reorg (ucybdbre) — action DBREORG
- DB Unload (ucybdbun) — action DBUNLOAD
Les quatre processus combinés DB Backup Full, DB Backup Part, DB Reorg Full et DB Reorg Part enchaînent ces utilitaires.
Quelles versions d'Automic et quelles plateformes sont prises en charge ?
L'Automation Utility Action Pack nécessite Automic Automation V24 ou une version ultérieure. Les jobs utilitaires s'exécutent sur l'hôte Windows ou UNIX sur lequel les utilitaires Automic sont installés. Sous UNIX, vous pouvez définir le shell ; sous Windows, le paramètre Log on as batch.
Quelle est la différence entre les processus Full et Part ?
Les processus Full portent sur l'ensemble du système : DB Backup Full écrit un seul cas de transport contenant tous les clients sauf le client 0, et DB Reorg Full réorganise chaque client. Les processus Part portent sur une liste de clients séparés par des virgules, par exemple 0001,0002.
Dans quel ordre se déroule une réorganisation ?
DB Reorg Full et DB Reorg Part traitent les clients l'un après l'autre. Pour chaque client, ils exécutent DB Archive (si Archive est défini sur true), DB Reorg (si Reorg est défini sur true) et DB Unload. Si une étape se termine avec ENDED_NOT_OK, le processus s'arrête.
Où les sauvegardes sont-elles stockées ?
DB Backup Full et DB Backup Part écrivent les cas de transport créés par DB Unload dans le répertoire défini par le paramètre Backup path (&AUT_UTILITY_BACKUPPATH#), par exemple /opt/automic/Utility/db.
Puis-je copier ou supprimer un client ?
Oui. DB Client Copy s'exécute en mode COPY ou DELETE. Pour une copie, vous choisissez si les messages, les statistiques et rapports ainsi que les objets de version sont inclus, si les mots de passe sont réinitialisés et si les fichiers de travail sont supprimés après l'exécution.
Ma configuration est-elle conservée lorsque je mets à jour l'Action Pack ?
Oui. La configuration est stockée dans la partie personnalisée du pack (PCK.CUSTOM_AUT_UTILITY) et n'est pas écrasée lors d'une mise à jour. Si vous venez d'une version antérieure à 1.7.4, adaptez vos workflows aux nouveaux noms d'objets PCK.TRICISE_AUT_UTILITY.*.
Quel est le modèle de licence de l'Automation Utility Action Pack ?
L'Automation Utility Action Pack est proposé sous licence en achat unique de 3.200 € (HT) par système Automic — sans abonnement récurrent, sans expiration. La licence comprend le support produit Tricise et les mises à jour de compatibilité pour la ligne de versions actuelle Automic V24+.