Vorhaltezeit von Backup-Dateien, Logs, Crashed Jobs
Nimmt ein Eingangsagent Dateien entgegen und ordnet diese einem Profil zu, dann wird ein Job für dieses Profil erzeugt und die Eingangsdateien werden im Backup-Verzeichnis gesichert. Auf diese Backups der Eingangsdateien kann dann später, z. B. bei einem Neustart eines Jobs, zugegriffen werden. Hinweis: Siehe auch System-Variable VAR_SYS_BACKUP.
Während ein Job verabeitet wird, werden Logs erzeugt. Zusätzlich gibt es speziell für die Kommunikation über Partner-Kanäle die Comm-Logs (siehe Abschnitt unten).
Default-Werte für datenbankbasierte Logs und Backups
Die Konfiguration für die Backups und auch die datenbankbasierten Log-Dateien (außer die Comm-Logs) erfolgt in der Datei ./etc/startup.xml, wobei einzelne Parameter evtl. nicht greifen, wenn diese direkt im Profil überschrieben werden. Siehe Tabelle unten. Siehe auch Abschnitt Logging.
Hinweis: Auf Testsystemen werden die datenbankbasierten Logs und Backup-Dateien, unabhängig von den Einstellungen, für maximal 5 Tage vorgehalten.
...<Set name="backupDir">./datawizard/backup/</Set>...<Set name="minimumFreeDiskSpace">2048</Set><Set name="shutdownOnLowDiskSpace">false</Set>...<Set name="retainDays">30</Set><Set name="retainDaysLog">60</Set><Set name="retainDaysForStatistic">90</Set><Set name="retainDaysLogForNoBackupSettings">7</Set>...<Set name="generalLogDefault">5</Set>...<Set name="moveBackUpFiles">false</Set><Set name="multipleBackupSubDirs">true</Set>...<Set name="trackCrashedJobs">true</Set><Set name="startCrashedJobs">true</Set><Set name="restoreWaitTime">90</Set><Set name="ignoreOldCrashedJobs">3</Set>|
Parameter |
Beschreibung |
|
backupDir |
Hier wird das Backup-Verzeichnis festgelegt. |
|
minimumFreeDiskSpace |
Es wird der freie Speicher im Backup-Verzeichnis geprüft. Bei Unterschreitung des Wertes wird eine E-Mail versendet. Beträgt der freie Platz nur noch 25 % des Mindestwertes, wird der Job abgebrochen. Default: 2048 MB. Minimum: 1024 MB. |
|
shutdownOnLowDiskSpace |
Ist hier true gesetzt, dann wird ein Shutdown des Integration Servers per Force Stop eingeleitet, falls minimumFreeDiskSpace unterschritten wird. |
|
retainDays |
Mit dem Wert wird die Anzahl der Tage festgelegt, die Backup-Dateien vorgehalten werden. Dieser Wert gilt auch für Dateien im Bereich Unresolved. Der Wert ist gültig, wenn im Profil die Eigenschaft Vorhaltezeit der Daten-Backups auf -1 gesetzt ist. Wird ein anderer Wert gesetzt, dann ändert sich die Vorhaltezeiten für das jeweilige Profil. Siehe Beispiele unten. Wichtiger Hinweis: Eine Änderung wirkt sich nicht rückwirkend aus, weil der Löschzeitpunkt bereits beim Schreiben einer Backup-Datei festgelegt wird. Beispiel: Sie ändern den Wert von 30 auf 60 und starten danach den Integration Server neu. Alle Backup-Dateien für Jobs, die bis zu diesem Neustart durchgeführt wurden, werden nach 30 Tagen entfernt. Alle Backup-Dateien für Jobs, die nach diesem Neustart durchgeführt werden, werden nach 60 Tagen, entfernt. |
|
retainDaysLog |
Mit dem Wert wird die Anzahl der Tage festgelegt, die Detail-Logeinträge vorgehalten werden (in Tabelle dw_log und dw_log_fields, wobei dw_log_fields die Werte für die Zielfelder, bei denen die Eigenschaft "Feldwerte loggen" aktiviert ist, enthält). Der Wert ist gültig, wenn im Profil die Eigenschaft Vorhaltezeit der Daten-Backups auf -1 gesetzt ist. Wird ein anderer Wert gesetzt, dann ändert sich die Vorhaltezeiten für das jeweilige Profil. Siehe Beispiele unten. Hinweis: Dieser Wert wird auch für die Logs des MFT-Servers verwendet. Wichtiger Hinweis: Eine Änderung wirkt sich nicht rückwirkend aus, weil der Löschzeitpunkt bereits beim Schreiben eines Eintrags festgelegt wird. Beispiel: Sie ändern den Wert von 30 auf 60 und starten danach den Integration Server neu. Alle Logs für Jobs, die bis zu diesem Neustart durchgeführt wurden, werden nach 30 Tagen entfernt. Alle Logs für Jobs, die nach diesem Neustart durchgeführt werden, werden nach 60 Tagen, entfernt. |
|
retainDaysForStatistic |
Default-Vorhaltezeit der Logmeldungen (in Tabelle dw_log_sum). Siehe Beispiele unten. Wichtiger Hinweis: Kann nicht im Profil überschrieben werden, kann aber für individuelle Log Pools überschrieben werden. |
|
retainDaysLogForNoBackupSettings |
Hier wird die Anzahl der Tage festgelegt, die Logeinträge vorgehalten werden, sofern im Profil die Vorhaltezeit der Daten-Backups mit dem Wert 0 festgelegt wurde. Siehe Beispiele unten. |
|
generalLogDefault |
Der Wert legt fest, wie lange allgemeine Logeinträge vorgehalten werden sollen. |
|
moveBackUpFiles |
Hiermit wird festgelegt, ob veraltete Backup-Dateien gelöscht oder verschoben werden. Wert true bedeutet Verschieben. Default: false. Das Basis-Zielverzeichnis beim Verschieben ist ./datawizard/moved Achtung: Das Verschieben der Dateien erfolgt mit der Methode rename, die nur dann erfolgreich ist, wenn das Zielverzeichnis sich auf dem gleichen Datenträger (gleiche Festplatten-Partition) befindet wie das ursprüngliche Backup-Verzeichnis. |
|
multipleBackupSubDirs |
Mit dem Wert wird festgelegt, ob die Backup-Dateien eines Profils über mehrere Unterverzeichnisse verteilt werden sollen. Wird hier der Wert " true" eingestellt, werden nach einem Neustart alle bestehenden Backup-Dateien aller Profile auf jeweils mehrere Unterverzeichnisse verteilt . |
|
trackCrashedJobs |
Aktiviert das Handling von Crashed Jobs - empfohlen. Siehe Abschnitt System-Abbruch/-Absturz und "Crashed Jobs". |
|
startCrashedJobs |
Bei false werden Crashed Jobs als fehlerhaft markiert und beim Neustart des Integration Servers nicht neu gestartet. Es werden keine Fehlermails für diese Jobs gesendet. Default: true. |
|
restoreWaitTime |
Warte x Sekunden bevor Jobs in Warteschlangen und Crashed Jobs neu gestartet werden nach einem Neustart des Integration Servers. |
|
ignoreOldCrashedJobs |
Starte Crashed Jobs nicht, die älter als x Tage sind. 0 schaltet diese Option aus. |
Default-Werte für dateibasierte Logs
Dateibasierte Logs werden per Default-Einstellung gelöscht, wenn sie mehr als 7 Tage alt sind. Diese Default-Einstellung kann über folgenden Eintrag in der Konfigurationsdatei ./etc/log.xml geändert werden. Dieser Eintrag sollte in der Datei am besten direkt unterhalb von <Set name="defaultManager">File</Set> platziert sein. Parameter maxDays gibt die Vorhaltezeit an. Um die Änderung wirksam zu machen, ist ein Neustart des Integration Servers erforderlich. Hinweis: In der Admin-Konsole kann im LogService für die jeweiligen LogManager auch die Vorhaltezeit geändert werden. Diese Änderung bleibt aber nur bis zum Neustart des Integration Servers wirksam.
<Call name="addManager"> <Arg>defaultdatawizardlog</Arg> <Arg> <New class="com.ebd.hub.services.log.file.FileLogManager"> <Set name="maxDays">42</Set> <Set name="rootDir">./logs/DataWizard/</Set> </New> </Arg></Call>Comm-Log
Die Vorhaltezeit der Comm-Log-Einträge (in Tabelle comm_log) kann in Partner-Kanälen in Tagen angegeben werden. Bei -1 in der GUI wird der Defaultwert verwendet, der über Parameter retainDays in der Konfigurationsdatei ./etc/commlog.xml festgelegt ist. Bei Wert 0 in der GUI werden die Einträge unendlich lange gehalten. Einträge, deren Vorhaltezeit überschritten ist, werden automatisch gelöscht.
Best Practice
Normalerweise werden Sie über das Control Center Jobs suchen wollen. Der Parameter retainDaysForStatistic muss entsprechend auf den längsten Zeitraum gestellt werden, in dem Sie suchen wollen. Wollen Sie für alle Profile die Detail-Logs ebenso lange aufbewahren, müssen Sie Parameter retainDaysLog auf den gleichen Wert setzen. Benötigen Sie die Detail-Logs nur für einzelne Profile so lange, sollten Sie retainDaysLog auf den normalerweise gewünschten Wert stellen und nur für die individuellen Profile den Wert überschreiben. Die Detail-Logs länger aufzubewahren als die Einträge in Tabelle dw_log_sum ist zwar möglich, ist aber nur in den wenigsten Fällen sinnvoll.
Beispiele
Wir gehen davon aus, dass die Werte für die Parameter retainDays, retainDaysLog, retainDaysForStatistic und retainDaysLogForNoBackupSettings wie oben gesetzt sind.
|
Vorhaltezeit der Daten-Backups im Profil = -1
|
|
Vorhaltezeit der Daten-Backups im Profil = 0
|
|
Vorhaltezeit der Daten-Backups im Profil = 42
|