Page Rollback

Les restaurations (Rollback) restaurent les workflows ou les tâches d'un workflow, en revenant à un état antérieur du processus d'exécution. La fonction de restauration vous permet de résoudre des erreurs et d'annuler des modifications. Si vous êtes développeur et concepteur d'objets, configurez la procédure de restauration dans la page Rollback des objets susceptibles de faire partie d'un workflow. Définir une restauration se fait en deux étapes :

  1. Définir les tâches de sauvegarde
  2. (Jobs UNIX et Windows pour transferts de fichiers uniquement) Définir le chemin de restauration.
  3. Définir les tâches de restauration

Pour plus d'informations sur le processus de restauration, voir Rollbacks.

Cette rubrique contient les sujets suivants :

Définir les paramètres de restauration

  1. Dans la page Rollback, cochez la case Activer le rollback pour activer cette fonction et afficher les paramètres disponibles.

  2. Définir la tâche de sauvegarde.

    Sélectionnez l'objet chargé d'exécuter la restauration. Il contient les actions et étapes qui seront effectuées pour sauvegarder les tâches exécutées par l'objet que vous êtes en train de définir. La tâche de sauvegarde doit inclure tout objet, base de données, etc. affecté par la sauvegarde. Si, par exemple, vous utilisez un objet de mise à jour de la base de données, vous devez inclure une base de données dans l'objet de sauvegarde.

    Si la tâche de sauvegarde se termine avec succès, la variable d'objet &RB_CBACKUP_RUNID# est automatiquement générée dans la tâche qui déclenche le processus de sauvegarde. Cette variable contient le RunID de la tâche de sauvegarde.

  3. Définir la tâche de restauration.

    Sélectionnez l'objet chargé d'exécuter la restauration et de restaurer le dernier statut sans échec de la tâche.

  4. (Jobs UNIX et Windows, et transferts de fichiers uniquement) Saisissez le Chemin de la sauvegarde Les fichiers de la tâche enregistrés dans le dossier de sauvegarde sont copiés à l'emplacement spécifié ici. Si vous n'ajoutez pas de nom de fichier dans le chemin, c'est le contenu intégral du dossier qui est sauvegardé.

    Alternative : Définissez le répertoire de sauvegarde dans la section [VARIABLES] du fichier INI de l'agent en utilisant la variable d'agent UC_EX_PATH_BACKUP. Par défaut, le système utilise ..\BACKUP (Windows) ou ./backup" (Unix) comme dossier de sauvegarde.

    Prérequis :

    • Avoir suffisamment d'espace disque pour la sauvegarde
    • L'utilisateur du système d'exploitation possède les autorisations requises

    Remarques :

    • Pour les jobs, le système utilise l'agent affecté à l'objet Job
    • Pour les transferts de fichiers, le système utilise l'agent de destination

    Exemple (Windows) :

    • C:\temp\text.txt
    • C:\temp\*.txt
    • C:\temp\ ou C:\temp\*
    • C:\temp\text??.*

    Exemple :

    Dossier à sauvegarder : C:\AUTOMIC\source\*.txt

    Dossier de sauvegarde : C:\AUTOMIC\backup

    Remarque : Pour UNIX, les fichiers ne sont pas directement enregistrés dans le répertoire cité ci-dessus, mais dans une archive TAR qui porte le nom du RunID.

    Recommandations

    • Le répertoire de sauvegarde est vidé à intervalles réguliers. Vous pouvez définir la période de rétention des fichiers via les paramètres suivants pour la variable UC_HOSTCHAR* :
      • BACKUP_RETENTION_LIFETIME: Définit la durée de conservation d'un fichier.
      • BACKUP_RETENTION_CHECK: Définit l'heure de vérification des fichiers.
    • Lorsque vous exécutez une sauvegarde basée sur un fichier à partir d'un chemin de fichier inexistant, ce chemin est supprimé pendant la restauration, à condition d'avoir été préalablement créé lors du processus de transfert de fichier. Dans ce cas, aucune erreur ne se produit, ni dans la sauvegarde, ni dans la restauration.

  5. Vous pouvez également cocher Supprimer avant de restaurer. Cette case ne s'affiche que si vous avez préalablement saisi un chemin de sauvegarde.

    Si vous activez cette option, le contenu du répertoire d'origine utilisé pour créer la sauvegarde sera supprimé avant la restauration du dossier de sauvegarde. Cela permet de s'assurer que le répertoire de destination est vide avant que les fichiers soient copiés à partir du répertoire de sauvegarde et d'éviter des erreurs éventuelles.

    Les sous-répertoires ne sont supprimés que si l'option Inclure les sous-répertoires est également activée.

  6. Vous pouvez également cocher Inclure les sous-répertoires.

    Activez cette option pour inclure les sous-répertoires dans le chemin de sauvegarde.

    Par défaut, les sous-répertoires vides ne sont pas copiés pendant la sauvegarde. Si vous souhaitez que les dossiers vides soient également inclus dans la sauvegarde, vous devez définir la variable de propriétés de l'objet &RB_FBACKUP_COPY_EMBTY_DIR à "1".

    Si vous ne spécifiez ici aucun nom de fichier, c'est le contenu intégral du dossier qui est sauvegardé.

    Les caractères génériques suivants sont autorisés :

    • * (remplace un nombre de caractères au choix)
    • ? (remplace un seul caractère) Cela vous permet de sélectionner des fichiers avec un certain nom et/ou suffixe.

    Important ! Les caractères génériques sont également admis dans les noms de fichiers, mais pas dans le chemin.

Utiliser des variables dans les tâches de sauvegarde et de restauration

Pour faciliter l'automatisation de vos restaurations, vous pouvez utiliser les variables suivantes lors de la définition des tâches de sauvegarde et de restauration :

Remarque : Les variables de même nom seront écrasées dans l'objet de sauvegarde ou de restauration.

Voir aussi :

Rollbacks