Datenbank-Housekeeping ist die Aufgabe, von der jeder Automic-Administrator weiß, dass er sie regelmäßig ausführen sollte — und die er stillschweigend immer wieder aufschiebt, bis Ausführungsdaten, alte Reports und Systemmeldungen die AE-Datenbank aufgebläht haben. Über Jahre hinweg bedeutete Automic-Datenbankwartung, zu den lokalen AE-DB-Utilities zu greifen oder direkt auf die Datenbank zuzugreifen — und genau deshalb rutschte sie auf der To-do-Liste immer weiter nach unten. In Automic V26 ist diese Hürde verschwunden: Sie können operative Daten direkt aus der AWI-Administrationsperspektive und über die AE REST API archivieren, reorganisieren, löschen und bereinigen. Dieser Artikel ist Teil unserer Automic V26 Enablement Series und konzentriert sich auf den Weg über die REST API — das Walkthrough-Video weiter unten zeigt dieselben Vorgänge von Anfang bis Ende.
Was hat sich bei der Datenbankpflege von Automic in Version 26 geändert?
In früheren Releases wurden das Archivieren, Reorganisieren und Entladen der AE-Datenbank über die eigenständigen AE-DB-Utilities oder durch direkten Zugriff auf die Datenbank abgewickelt. Automic V26 bringt diese Aktivitäten unter eine kontrollierte, API-gesteuerte Verwaltung: Dieselben Wartungsaufgaben werden jetzt über die AE REST API und die AWI-Administrationsperspektive bereitgestellt, sodass Sie keine lokalen Utility-Binaries oder direkten Datenbank-Anmeldedaten mehr benötigen, um sie auszuführen.
Durchgängig handelt es sich bei den Daten, die Sie verwalten, um das, was Automic als operative Daten bezeichnet: Systemmeldungen, Ausführungsdaten (früher als Statistiken bezeichnet), Reports und Kommentare. Insgesamt deckt die AE REST API fünf Vorgänge ab: operative Daten archivieren, Revisionsreports erstellen, operative Daten reorganisieren, operative Daten löschen und den Papierkorb leeren.
Der praktische Nutzen liegt in der Governance. Wartung über die AE REST API zu leiten bedeutet, dass jede Archivierung, Reorganisation und Löschung ein nachvollziehbarer, wiederholbarer Aufruf ist — und kein ad hoc auf irgendeinem Arbeitsplatzrechner ausgeführter Utility-Lauf. Zudem lässt sich der Zugriff über eine einzige Berechtigung gewähren, statt über einen Zugang auf Datenbankebene. Für regulierte Automic-Umgebungen ist diese Nachvollziehbarkeit ebenso wichtig wie der freigewordene Speicherplatz in der Datenbank.
Berechtigungen und Konfiguration zum Einrichten zuerst
Bevor Sie eine Automic-Datenbankwartung über die REST API ausführen, müssen zwei Dinge gegeben sein: die richtigen Benutzerberechtigungen und die Variablen, die die einzelnen Vorgänge steuern.
- Berechtigungen. Die Berechtigung
DB_MAINTENANCEstartet die Archivierungs-, Reorganisations- und Löschprozesse. Um Archivpakete und Revisionsreports herunterzuladen, benötigen Sie außerdemACCESS_METRICS_ENDPOINT, und um den Papierkorb zu lesen oder zu leeren, benötigen SieRECYCLE_BIN. - Konfigurationsvariablen in Mandant 0. Die Archivierungsparameter befinden sich in
UC_UTILITY_ARCHIVE, die Reorganisationsparameter inUC_UTILITY_REORGund die Löschparameter inUC_UTILITY_DB_UNLOAD. Für Revisionsreports muss die Objektprotokollierung (OBJECT_AUDIT) inUC_CLIENT_SETTINGSaktiviert sein. - Ausgabespeicherort. Das Archiv- bzw. Reportpaket wird automatisch in das Verzeichnis geschrieben, das Sie in der INI-Datei der Automation Engine für On-Premises-Systeme bzw. in der Datei
values.yamlfür AAKE-Umgebungen (containerisiert) festlegen. Von dort aus übertragen Sie es an den gewünschten Zielort.
Sobald die Berechtigungen erteilt und die Variablen einmalig konfiguriert sind, ist jeder weitere Lauf ein einziger API-Aufruf. Der folgende Walkthrough zeigt diese Vorgänge im AWI und über die AE REST API — folgen Sie ihm und verwenden Sie anschließend die Referenzaufrufe in der zweiten Hälfte dieses Leitfadens.
Die Wartungsarbeiten über die AE REST API
Jeder Vorgang wird in Mandant 0 ausgelöst und kann auf einen einzelnen Mandanten (target_client=100) oder auf alle Mandanten (target_client=ALL) abzielen — eine beliebige Teilmenge können Sie nicht auswählen. Die meisten Prozesse geben eine run_id zurück, mit der Sie das resultierende Paket abrufen.
Archivierung operativer Daten
Beim Archivieren werden Systemmeldungen, Ausführungsdaten, Reports und Kommentare in einer herunterladbaren ZIP-Datei zusammengefasst. Sie lösen es mit einem POST aus und laden anschließend das Paket mit der zurückgegebenen Run-ID herunter:
POST /ae/api/v1/0/system/clients/archive?target_client=100
→ { "run_id": 1007001 }
GET /ae/api/v1/0/system/clients/archive/1007001
→ (lädt das Archivpaket herunter)Mit einem REST-Client wie Postman verwenden Sie die Option Send and Download; mit cURL fügen Sie -o hinzu, um die Datei auf die Festplatte zu schreiben. Wird derselbe Endpoint mit der Reset-Methode aufgerufen, wird das Archivierungs-Flag zurückgesetzt.
Revisions Reports erstellen
Revisionsreports liefern Ihnen eine chronologische, auditfähige Aufzeichnung von Änderungen in einem Mandanten — erstellte Objekte, Löschungen, Transporte, Benutzeranmeldungen und mehr — und genau das hält eine regulierte Umgebung compliant. Sie können einen Report nach Zeitraum und nach Änderungstyp eingrenzen:
POST /ae/api/v1/0/system/clients/revisionreport?target_client=ALL
{
"from": "2026-01-01T00:00:00Z",
"to": "2026-03-31T00:00:00Z",
"types": ["CREATE", "DELETE", "OBJ_MOD", "USER", "TRNSPRT"]
}Wird types weggelassen, sind alle Änderungskategorien enthalten. Der Report wird mit seiner run_id heruntergeladen, genau wie ein Archivpaket.
Reorganisierung operativer Daten
Das Reorganisieren operativer Daten markiert ältere Datensätze zur Löschung, ohne sie bereits zu entfernen. Die Aufbewahrungslogik kombiniert zwei Einstellungen: einen Schwellenwert reorganize older than in Tagen und eine Anzahl keep last. Bei reorganize older than = 30 und keep last = 5 behält der Prozess beispielsweise alle Datensätze der letzten 30 Tage sowie die fünf jüngsten älteren Datensätze pro Objekt.
POST /ae/api/v1/0/system/clients/reorg?target_client=ALLOperative Daten löschen
Sobald Datensätze markiert sind, entfernt das Löschen operativer Daten sie dauerhaft aus der AE-Datenbank. Es handelt sich um einen einzigen Auslöser pro Mandant oder für alle Mandanten:
POST /ae/api/v1/0/system/clients/deletedata?target_client=ALLPapierkorb leeren
Gelöschte Objekte werden in den Papierkorb verschoben, anstatt sofort zu verschwinden. Von Client 0 aus können Sie den Inhalt des Papierkorbs eines Mandanten auflisten und ihn dann leeren:
GET /ae/api/v1/0/recyclebin?ziel_client=100
DELETE /ae/api/v1/0/recyclebin?ziel_client=ALLEObjekte, die noch nicht archivierte operative Daten enthalten, werden nicht gelöscht; sie werden in der Antwort unter failedObjects zurückgegeben. Die Faustregel ist einfach: erst archivieren, dann leeren.
Archivierungs- und Reorganisations-Flags zurücksetzen
Wenn Sie einen Zyklus erneut ausführen müssen — beispielsweise um bereits markierte Datensätze zu archivieren —, akzeptieren die Archivierungs- und Reorganisations-Endpoints eine Reset-Methode, die das entsprechende Flag zurücksetzt. So können Sie einen falsch terminierten Lauf korrigieren, ohne die Datenbank anzufassen, und halten den gesamten Wartungszyklus innerhalb der AE REST API.
Aus der Automic-Datenbankwartung einen geplanten Job machen — keine lästige Pflicht
Da jeder Vorgang jetzt ein einfacher REST-Aufruf ist, besteht der nächste logische Schritt darin, sie nicht mehr von Hand auszuführen. Fassen Sie die Sequenz Archivieren → Reorganisieren → Löschen in einem geplanten Automic-Workflow zusammen, damit die AE-Datenbank in einem vorhersehbaren Rhythmus gewartet wird — und beziehen Sie Mandant 0 mit ein, der Server- und Agenten-Logs ansammelt und leicht vergessen wird. Wenn Sie die Endpoints lieber aus einem Skript heraus aufrufen möchten, können Sie sie mit der neuen Automic V26 Python-Integration aus einem nativen Python-Job heraus zusammen mit Ihrer bestehenden Automatisierungslogik aufrufen. Eine zuverlässige Automic-Datenbankwartung gehört zu den unscheinbarsten, aber tragendsten Bestandteilen eines gut betriebenen V26.
Ein sinnvolles Muster ist, regelmäßig zu reorganisieren, vor dem Löschen zu archivieren und den Papierkorb erst dann zu leeren, wenn die Archivierung bestätigt hat, dass nichts unarchiviert geblieben ist. Den größten Nutzen erzielen Sie, indem Sie die Aufbewahrungsschwellen an Ihr Datenvolumen anpassen — aggressiv genug, um die Datenbank schlank zu halten, und konservativ genug, um Ihr Audit-Fenster zu erfüllen.
Dieser Leitfaden ist Teil unserer Automic V26 Enablement Series. Wenn SAP eine zentrale Rolle in Ihrer Landschaft spielt, behandelt der ergänzende Beitrag zu SAP Agent Multiple System Support eine weitere V26-Änderung, die vor einem Upgrade einen Blick wert ist. Die offizielle Spezifikation finden Sie in Broadcoms Automic V26 Release Overview sowie in der 26.0 AE REST API Database Maintenance Documentation.
Häufig gestellte Fragen
Welche Berechtigungen benötige ich für die Datenbankwartung von Automic über die REST-API?
Sie benötigen das DB_MAINTENANCE-Privileg, um mit dem Archivieren, der Reorganisation und dem Löschen zu beginnen. Um Archivpakete und Revisionsberichte herunterzuladen, benötigen Sie außerdem ACCESS_METRICS_ENDPOINT, und um den Papierkorb zu lesen oder zu leeren, benötigen Sie das RECYCLE_BIN-Privileg.
Funktioniert dies sowohl On-Premises als auch in containerisierten AAKE-Umgebungen?
Ja. Die Vorgänge sind identisch; nur der Ausgabeort unterscheidet sich. On-premises legen Sie das Paketverzeichnis in der Automation Engine INI-Datei fest, und in AAKE (Container-)Umgebungen legen Sie es in der values.yaml-Datei fest.
Was gilt bei Automic als Betriebsdaten?
Betriebsdaten sind Systemmeldungen, Ausführungsdaten (früher Statistiken genannt), Berichte und Kommentare. Dies sind die Aufzeichnungen, die sich während des täglichen Betriebs ansammeln und die für die Archivierung, Neuanordnung und Löschung durch die Wartung bestimmt sind.
Kann ich die Wartung für alle Clients gleichzeitig durchführen?
Ja. Von Client 0 aus können Sie einen einzelnen Client mit target_client=100 oder jeden Client mit target_client=ALL ansprechen. Sie können keine willkürliche Teilmenge von Clients in einem einzigen Aufruf auswählen.
Wie lade ich ein Archivpaket oder einen Revisionsbericht herunter?
Verwenden Sie die run_id, die zurückgegeben wird, wenn Sie den Prozess in einer nachfolgenden GET-Anfrage auslösen. Verwenden Sie in Postman die Option "Senden und herunterladen"; fügen Sie mit cURL das Flag -o hinzu, um die Datei auf die Festplatte zu schreiben.
Was ist der Unterschied zwischen Neuanordnen und Löschen?
Reorganisieren markiert operative Daten, die aufgrund Ihrer Aufbewahrungseinstellungen gelöscht werden sollen, belässt sie aber in der Datenbank. Löschen entfernt dann die markierten Einträge endgültig. Wenn Sie zuerst reorganisieren und dann löschen, behalten Sie die Kontrolle darüber, was tatsächlich aus der Datenbank entfernt wird.
Wo ist das Archiv oder das Berichtspaket gespeichert?
Wenn Sie den Prozess auslösen, sammelt ein Hintergrundauftrag die Daten in einer ZIP-Datei und schreibt sie in das im Automation Engine INI-File (On-Premises) oder in der values.yaml-Datei (AAKE) definierte Verzeichnis. Von dort laden Sie diese dann herunter oder übertragen sie.
Planen Sie Ihr Wartungs-Setup für V26
Die Datenbankwartung auf die REST API zu verlagern, ist eine kleine Änderung mit überproportionalem Nutzen für Auditfähigkeit und Datenbankgesundheit — es lohnt sich jedoch, Berechtigungen, Aufbewahrungsschwellen und Zeitplan passend für Ihre spezifische Landschaft einzurichten. Wenn Sie einen zweiten Blick auf Ihr V26-Setup wünschen, vereinbaren Sie eine kostenlose Beratung mit dem Tricise Automic-Team.
