Seite "Rollback"

Rollbacks stellen Workflows oder Aufgaben in einem Workflow in einem früheren Stadium des Ausführungsprozesses wieder her. Mit der Rollback-Funktion können Sie Fehler beheben und Änderungen rückgängig machen. Als Entwickler und Objektdesigner konfigurieren Sie das Rollback-Verfahren auf der Seite Rollback von Objekten, die Teil eines Workflows sein können. Die Definition eines Rollbacks umfasst die folgenden Schritte:

  1. Backup-Aufgaben definieren.
  2. (nur UNIX- und Windows-Jobs für FileTransfers) Pfad zum Backup definieren.
  3. Rollback-Aufgaben definieren.

Weitere Informationen zum Rollback-Prozess finden Sie unter Rollback von Aufgaben und Workflows.

Diese Seite beinhaltet Folgendes:

Auf die Seite "Rollback" zugreifen

Eine Objektdefinition besteht aus mehreren Seiten. Nachdem ein Objekt hinzugefügt wurde, wird das Objekt mit der objektspezifischen Seite geöffnet. Um auf die Seite Rollback zuzugreifen, klicken Sie im linken Bereich auf Rollback.

Rollback-Einstellungen definieren

  1. Aktivieren Sie auf der Seite Rollback das Kontrollkästchen Rollback aktivieren, um diese Funktion zu aktivieren und die verfügbaren Einstellungen anzuzeigen.

  2. Die Backup-Aufgaben definieren.

    Wählen Sie hier das Objekt aus, welches das Backup ausführt. Es enthält die Aktionen und Schritte, die von dem Objekt, das Sie derzeit definieren, zur Sicherung der Aufgaben ausgeführt werden. Die Backup-Aufgabe muss alle Objekte, Datenbanken usw. enthalten, die vom Backup-Prozess betroffen sind. Wird zum Beispiel über das Objekt ein Datenbank-Update durchgeführt, dann nehmen Sie über das Backup-Objekt eine Datenbanksicherung vor.

    Wenn die Backup-Aufgabe erfolgreich abgeschlossen wurde, wird die Objektvariable &RB_CBACKUP_RUNID# automatisch in der Aufgabe erstellt, die das Backup ausgelöst hat. Diese Variable speichert die RunID der Backup-Aufgabe

  3. Definition der Rollback-Aufgabe.

    Wählen Sie das Objekt aus, das den Rollback-Prozess ausführt, und die Aufgabe auf ihren letzten erfolgreichen Status zurückstellt.

  4. (nur UNIX- und Windows-Jobs und FileTransfers) Pfad zum Backup eingeben. Die Dateien der Aufgabe, die im Sicherungsordner gespeichert sind, werden in den hier angegebenen Pfad exportiert. Wenn Sie dem Pfad keinen Dateinamen hinzufügen, wird der gesamte Inhalt des Ordners gesichert.

    Alternativ: Definieren Sie den Backup-Ordner im Abschnitt [VARIABLES] der INI-Datei des Agenten mithilfe der Agentenvariable UC_EX_PATH_BACKUP. Standardmäßig verwendet das System ..\BACKUP (Windows) oder ./backup" (Unix) als Backup-Ordner.

    Voraussetzungen:

    • Es steht genügend Speicherplatz für ein Backup zur Verfügung
    • Der OS-Benutzer verfügt über die erforderlichen Rechte

    Hinweise:

    • Für Jobs verwendet das System den Agenten, der dem Jobobjekt zugeordnet ist
    • Für FileTransfers verwendet das System den Ziel-Agenten

    Beispiele (Windows):

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

    Beispiel:

    Zu sichernder Ordner: C:\AUTOMIC\source\*.txt

    Backup-Ordner: C:\AUTOMIC\backup

    Hinweis: Unter UNIX werden die Dateien nicht direkt im obigen Verzeichnis abgelegt, sondern in einem TAR-Archiv, das die RunID als Namen verwendet.

    Empfehlungen

    • Der Backup-Ordner wird in regelmäßigen Abständen geleert. Sie können die Verweildauer der Dateien mit den folgenden Einstellungen für die Variable UC_HOSTCHAR* festlegen:
      • BACKUP_RETENTION_LIFETIME: Definiert den Zeitraum, wie lange eine Datei gespeichert wird.
      • BACKUP_RETENTION_CHECK: Definiert, wann die Dateien überprüft werden.
    • Wenn Sie ein dateibasiertes Backup von einem Pfad ausführen, der nicht existiert, wird der Pfad während dem Rollback-Prozess gelöscht, vorausgesetzt, dass er zuvor während des FileTransfers erstellt worden ist. Dabei treten weder im Backup- noch im Rollback-Prozess Fehler auf.

  5. Aktivieren Sie gegebenenfalls Vor dem Wiederherstellen löschen. Dieses Kontrollkästchen ist nur sichtbar, wenn Sie einen Backup-Pfad eingegeben haben.

    Ist die Option gesetzt, so wird vor der Wiederherstellung des Backup-Ordners der Inhalt des Verzeichnisses gelöscht, von dem die Sicherung ursprünglich angelegt wurde. Dadurch wird sichergestellt, dass das Ziel-Verzeichnis leer ist, bevor die Dateien vom Backup-Ordner kopiert werden und so eventuelle Fehler vermieden.

    Unterordner werden nur gelöscht, wenn die Option Unterverzeichnisse einbeziehen aktiviert ist.

  6. Aktivieren Sie gegebenenfalls Unterverzeichnisse einbeziehen.

    Aktivieren Sie diese Option, wenn Sie die Unterordner in den Backup-Pfad miteinbeziehen möchten.

    Standardmäßig werden leere Unterverzeichnisse während dem Backup-Prozess nicht kopiert. Sollen auch leere Ordner gesichert werden, müssen Sie die Objekteigenschaftenvariable &RB_FBACKUP_COPY_EMBTY_DIR auf "1" setzen.

    Wenn Sie hier keinen Dateinamen spezifizieren, wird der gesamte Inhalt des Verzeichnisses gesichert.

    Die folgenden Wildcardzeichen können als Teil des Namens verwendet werden:

    • * (als Platzhalter für beliebig viele Zeichen)
    • ? (als Platzhalter für genau ein Zeichen). Dies bietet Ihnen die Möglichkeit, Dateien mit einem bestimmten Namen und/oder Endung auszuwählen.

    Wichtig! Die Wildcards können im Dateinamen, aber nicht im Pfad verwendet werden.

Die Verwendung von Variablen in Backup- und Rollback-Aufgaben

Um Ihre Rollbacks zu automatisieren, können Sie die folgenden Variablen bei der Definition der Backup- und Rollback-Aufgaben verwenden:

  • &AGENT#

    Name des Agenten der Aufgabe, über welche das Backup/Rollback ausgelöst wird.

  • &LOGIN#

    Name des Login-Objekts, das der Backup- oder Rollback-Aufgabe zugeordnet ist.

  • (nur UNIX- und Windows-Jobs und FileTransfers) &RB_FBACKUPPATH#

    Pfad des dateibasierten Rollbacks

  • (nur UNIX- und Windows-Jobs und FileTransfers) &RB_FDELETEBEFORE#

    Behandlung der Aufgaben vor dem Wiederherstellen

    Mögliche Werte: 

    • 001 - Die betroffenen Dateien werden gelöscht
    • 000 - Keine Dateien werden gelöscht

  • (nur UNIX- und Windows-Jobs und FileTransfers) &RB_FINCLSUBDIRS#

    Behandlung von Unterverzeichnissen

    Mögliche Werte:

    • 001 - Unterverzeichnisse werden berücksichtigt
    • 000 - Unterverzeichnisse werden nicht berücksichtigt

  • (Nur FileTransfers) &$DST_FILE#

    Vordefinierte Variable zur Angabe des Ziels im Pfad zum Backup

Hinweis: Gleichnamige Variablen werden im Backup- oder Rollback-Objekt überschrieben.

Siehe auch: