In Schritten aufgebaut

Es gibt mehrere integrierte Automatisierungsschritte, die mit Avantra geliefert werden und direkt in einem Automatisierungs-Workflow verwendet werden können. Diese Schritte bieten Abkürzungen für häufig verwendete Automatisierungsaktionen. In diesem Abschnitt werden deren Zweck und Verwendung dokumentiert.

Datei-Bundle verteilen

Sendet ein in Avantra erstelltes Datei-Bundle an einen Agenten zur späteren Verwendung in einem Workflow.

Mit diesem Schritt kann ein ganzes Datei-Bundle gesendet werden oder nur die Dateien, die bestimmten Tags entsprechen.

Im Workflow-Designer wählen Sie das richtige Datei-Bundle aus (entweder als Konstante oder durch Zuweisung einer geeigneten Variablen). Optional ist es auch möglich, die verteilten Dateien automatisch ausführbar zu machen und einen Speicherort anzugeben, an dem die Dateien gespeichert werden sollen.

Achten Sie bei plattformübergreifenden Workflows darauf, dass der Dateipfad auf jedem System korrekt ist.

Dieser Workflow-Schritt liefert auch zwei Ausgabeparameter, location und files, die nach erfolgreicher Ausführung des Schritts den Speicherort enthalten, an dem die Dateien nun verfügbar sind, sowie ein Array von Dateinamen aus dem Bundle in files.

Manuell

Stoppt den Workflow an einem bestimmten Punkt und fordert einen Benutzer zur Interaktion auf. Der Benutzer kann entweder den Schritt bestätigen und der Workflow wird fortgesetzt oder der Workflow kann gestoppt werden.

SAP-System starten

Startet das gesamte SAP-System mit allen SAP-Anwendungsservern, die zum SAP-System gehören.

Bitte beachten Sie, dass die SAP-Datenbank mit dieser Aktion NICHT gestartet wird.

Das detaillierte Startverfahren ist wie folgt:

  1. Avantra überprüft mit dem Befehl R3trans, ob die Datenbank läuft. Wenn die Datenbank nicht läuft, wird das SAP-System nicht gestartet.

  2. Führen Sie cleanipc <instno> remove auf allen SAP-Instanzen aus. Wenn die SAP-Instanz bereits läuft, wird cleanipc nicht ausgeführt.

  3. Führen Sie die Funktion SAPControl StartSystem aus. Nach der Ausführung der Funktion SAPControl StartSystem wartet Avantra, bis alle SAP-Instanzen laufen. Dazu wird die Funktion SAPControl GetSystemInstanceList ausgeführt. Die maximale Wartezeit beträgt 20 Minuten. Wenn nach 20 Minuten nicht alle SAP-Instanzen laufen, wird diese Automatisierungsaktion von Avantra als fehlgeschlagen gemeldet.

Reference Data
Automatisierungsparameter

WaitingTimeMoniOffStop

SAP-System stoppen

Diese Aktion stoppt ein SAP-System und alle dazugehörigen SAP-Instanzen.

Bitte beachten Sie, dass die SAP-Datenbank mit dieser Aktion NICHT gestoppt wird.

Avantra führt die Funktion SAPControl StopSystem aus, um das SAP-System zu stoppen. Nach der Ausführung der Funktion SAPControl StopSystem wartet Avantra, bis alle SAP-Instanzen gestoppt sind. Dazu wird die Funktion SAPControl GetSystemInstanceList ausgeführt. Die maximale Wartezeit beträgt 20 Minuten. Wenn nach 20 Minuten nicht alle SAP-Instanzen gestoppt sind, wird diese Automatisierungsaktion von Avantra als fehlgeschlagen gemeldet.

Reference Data
Automatisierungsparameter

WaitingTimeStartMoniOn

SAP-Datenbank starten

Startet die Datenbank, die zu einem SAP-System gehört.

Bitte beachten Sie, dass nur die Datenbank gestartet wird, die SAP-Instanzen werden NICHT gestartet.

Wie die Datenbank gestartet wird, hängt vom Datenbankanbieter ab. Avantra unterstützt derzeit Start/Stopp für die folgenden Datenbanken und Betriebssysteme:

Linux

Windows

Sybase

Ja

Ja

Oracle

Ja

MaxDB

Ja

DB2

Ja

MSSQL

Ja

HANA System DB

Ja

HANA Tenant

Ja

Einschränkungen:

  • Für SAP HANA-Datenbanken: Diese Aktion startet nur den HANA-Tenant. Die HANA-Systemdatenbank wird mit dieser Aktion nicht gestartet.

  • Der Agent-Benutzer hat möglicherweise keine Berechtigung, die Datenbank zu starten. In diesem Fall müssen Sie den OS-Benutzer für das SAP-System definieren. Falls gesetzt, wird dieser Benutzer verwendet, um die Datenbank zu starten.

  • Auf Windows läuft die Datenbank als Windows-Dienste. Der Agent-Benutzer muss die Berechtigung haben, einen Windows-Dienst zu starten. Sie müssen diese Berechtigung erteilen, bevor Sie diese Aktion ausführen.

SAP-Datenbank stoppen

Stoppt die Datenbank, die zu einem SAP-System gehört.

Bitte beachten Sie, dass nur die SAP-Datenbank gestoppt wird.

Das SAP-System wird mit dieser Aktion nicht gestoppt. Die unterstützten Datenbanken und Betriebssysteme finden Sie in der Aktion Start SAP Database. Das SAP-System muss bereits gestoppt sein, bevor die Datenbank gestoppt wird.

Das Stoppen einer SAP-Datenbank, während SAP-Instanzen laufen, führt zu fatalen Fehlern in Ihrem SAP-System.

SAP-System und Datenbank starten

Startet die SAP-Datenbank UND das SAP-System (alle SAP-Instanzen). Bitte lesen Sie die Kommentare zu SAP-System starten und SAP-Datenbank starten für Details zu den Startaktionen.

SAP-System und Datenbank stoppen

Stoppt das SAP-System (alle SAP-Instanzen) UND die SAP-Datenbank. Bitte lesen Sie die Kommentare zu Stop SAP System und Stop SAP Database für Details zu den Stoppaktionen.

SAP-System und HANA-System-DB starten

Startet die SAP-HANA-System-DB, alle SAP-HANA-Tenants und das SAP-System. Dies ist eine spezielle Aktion nur für SAP-HANA-Systeme. Während nicht-HANA-SAP-Systeme auf einer dedizierten Datenbank laufen, die zum SAP-System gehört, teilen sich HANA-SAP-Systeme eine HANA-Datenbank. Jedes HANA-SAP-System läuft auf einem sogenannten HANA-Tenant, der Teil der HANA-Datenbank ist. Diese Aktion startet die HANA-Plattform (die HANA-System-DB). Basierend auf Ihren HANA-Einstellungen werden die HANA-Tenants im Rahmen dieses Verfahrens gestartet. Sobald die HANA-System-DB läuft, startet diese Automatisierungsaktion die HANA-Tenant-Datenbank (die Datenbank, die zum SAP-System gehört). Basierend auf Ihren HANA-Einstellungen könnte dieser HANA-Tenant bereits während des Starts der HANA-Plattform gestartet worden sein. Das ist kein Problem, falls dies der Fall ist, wird der HANA-Tenant nicht erneut gestartet. Sobald der HANA-Tenant läuft, wird das SAP-System gestartet. Bitte lesen Sie Start SAP System für Details.

SAP-System, Datenbank und HANA-Plattform stoppen

Stoppt das SAP-System, die SAP-HANA-Tenant-Datenbank und die SAP-HANA-System-DB. Diese Aktion stoppt das SAP-System und die SAP-Datenbank, bitte lesen Sie die Aktion Stop SAP System and Database. Danach wird auch die HANA-Plattform (System-DB) gestoppt.

Bitte beachten Sie, dass das Stoppen der HANA-System-DB auch alle laufenden HANA-Tenants stoppt! Avantra warnt NICHT, wenn ein anderer HANA-Tenant (zum Beispiel ein anderer SAP-System-Tenant) läuft. Dieser HANA-Tenant wird ebenfalls gestoppt, was zu fatalen Fehlern bei laufenden Anwendungen auf diesem HANA-Tenant führt.

Verwenden Sie diesen Befehl daher mit Vorsicht.

SAP-System, Datenbank und Server starten

Diese Aktion ist nur anwendbar, wenn Ihre SAP-Systeme auf Cloud-Servern laufen, die von Avantra gestartet und gestoppt werden können (bitte lesen Sie "xxx", wie man Server startet und stoppt). Da ein SAP-System möglicherweise auf mehreren Servern läuft, erkennt diese Aktion zunächst alle Server, die das SAP-System hosten. Dann werden diese Cloud-Server gestartet. Sobald die Cloud-Server laufen, wird das SAP-System gestartet. Lesen Sie die Aktion Start SAP System and Database.

SAP-System, Datenbank und Server stoppen

Diese Aktion ist nur anwendbar, wenn Ihre SAP-Systeme auf Cloud-Servern laufen. Bitte lesen Sie Start SAP System, Database and servers für Details.

SAP HANA starten

Startet eine SAP-HANA-System-DB (HANA startet möglicherweise Tenants basierend auf Ihren HANA-Einstellungen).

Bitte beachten Sie, dass das Starten von HANA-Tenants einen Benutzer mit dem DATABASE ADMIN- oder DATABASE START-Privileg in der System-DB erfordert. Sie müssen den Namen und das Passwort dieses Benutzers im Menü:Database[Database connection details] angeben.

SAP HANA stoppen

Stoppt die SAP-HANA-System-DB (alle Tenants werden ebenfalls gestoppt).

Bitte beachten Sie, dass das Stoppen von HANA-Tenants einen Benutzer mit dem DATABASE ADMIN- oder DATABASE STOP-Privileg in der System-DB erfordert. Sie müssen den Namen und das Passwort dieses Benutzers im Menü:Database[Database connection details] angeben.

SAP-Instanz starten

Startet eine einzelne SAP-Instanz. Die Funktion SAPControl Start wird verwendet, um die SAP-Instanz zu starten.

SAP-Instanz stoppen

Stoppt eine einzelne SAP-Instanz. Die Funktion SAPControl Stop wird verwendet, um die SAP-Instanz zu stoppen.

Cloud-Server starten

Startet einen einzelnen Cloud-Server. Die Cloud-Authentifizierung muss für diesen Cloud-Server korrekt definiert sein.

Cloud-Server stoppen

Stoppt einen Cloud-Server. Die Cloud-Authentifizierung muss für diesen Cloud-Server korrekt definiert sein.

Datenbank starten

Startet eine eigenständige Datenbank.

Avantra unterstützt derzeit Start/Stopp für die folgenden eigenständigen Datenbanken und Betriebssysteme:

Linux

Windows

Sybase

Oracle

MaxDB

DB2

MSSQL

HANA System DB

Ja

HANA Tenant

Ja

Datenbank stoppen

Stoppt eine eigenständige Datenbank.

Siehe Start Database für die unterstützten Datenbanken.

Auf Prüfstatus warten

Diese Aktion ermöglicht es Ihnen, zu warten, bis eine bestimmte Prüfung von einem bestimmten System einen definierten Status erreicht. Zusätzlich zu statischen und dynamischen Prüfungen unterstützt die Aktion Warten auf Prüfstatus auch den benutzerdefinierten Prüftyp, einschließlich Composite Checks (diese werden seit Avantra Version 20.11.6 unterstützt).

Auf Systemstatus warten

Diese Automatisierungsaktion ermöglicht es Ihnen, zu warten, bis das ausgewählte System seinen Status erreicht.

Prozessanzahl abrufen

Ermittelt die Gesamtzahl der Prozesse einer SAP-Instanz. Diese Aktion führt die SAPControl-Funktion GetProcessList aus.

Prozessliste abrufen

Ermittelt die detaillierte Prozessliste einer SAP-Instanz. Diese Aktion führt die SAPControl-Funktion GetProcessList aus.

SAP-Instanzliste abrufen

Ermittelt die detaillierte SAP-Instanzliste des SAP-Systems. Diese Aktion führt die SAPControl-Funktion GetSystemInstanceList aus.

Agent-Version abrufen

Ermittelt die Version des Avantra-Agenten.

Benachrichtigungsnachricht senden

Diese Aktion ermöglicht es dem Workflow, das Avantra-Benachrichtigungssystem zu verwenden, um eine Nachricht oder Benachrichtigung über einen der Available Output Channels durch eine WORKFLOW STEP EVENT-Benachrichtigungsaktion zu senden.

Die richtige Benachrichtigungsaktion kann ausgewählt und dem Parameter actionID zugewiesen werden, und Daten aus dem Workflow können im einfachen Tabellenformat an den Parameter customData übergeben werden, um in der Benachrichtigungsaktion verwendet zu werden.

Warten

Diese Aktion ermöglicht es, für eine bestimmte Zeit zu warten. Zum Beispiel kann es nützlich sein, sicherzustellen, dass die vorherige Aktion Zeit hat, um abgeschlossen zu werden.

Betriebssystembefehl ausführen

Führt Betriebssystembefehle aus. Die Befehle werden mit dem Agent-Benutzer ausgeführt. Stellen Sie sicher, dass der Agent-Benutzer die erforderlichen Berechtigungen hat, um die Befehle auszuführen.

Ein Ansible Playbook ausführen

Führt ein Ansible Playbook als Schritt in einem Avantra-Workflow aus.

Der Ansible-Schritt ist nur verfügbar, wenn Ansible Core auf dem System installiert ist, auf dem der Avantra-Server installiert ist. Diese Installation muss manuell durchgeführt werden. Bitte beachten Sie auch, dass Ansible Playbooks nur auf Ansible Core ausgeführt werden können, das auf dem Avantra-Server läuft.

Jedes Ansible Playbook ist eine Liste von Aufgaben, die auf Hosts ausgeführt werden, die in einem Ansible-Inventar definiert sind. Jedes Modul innerhalb eines Ansible Playbooks führt eine spezifische Aufgabe aus und enthält Einstellungen dafür, wann und wo eine Aufgabe ausgeführt wird und welcher Benutzer sie ausführen kann. Diese Module müssen auf dem Ansible Core installiert sein.

Ein Ansible Playbook benötigt ein Inventar, das definiert, auf welchen Hosts das Playbook ausgeführt werden soll. In einem Avantra-Workflow-Schritt können Sie ein solches Inventar in den entsprechenden Inventareinstellungen definieren. Verwenden Sie die Variableneinstellung, um zusätzliche Variablen an das Ansible Playbook zu übergeben. Zusätzliche Ansible-Einstellungen wie Check, Debug und Diff sind optional und können verwendet werden, um das Ansible-Skript vor der eigentlichen Ausführung zu überprüfen.

SSH

Führt ein Skript über eine SSH-Sitzung aus. Sie müssen SSH-Anmeldedaten definieren, die für die Einrichtung einer SSH-Sitzung verwendet werden. Sie können entweder globale Anmeldedaten verwenden, die in den Integrationen definiert sind, oder Sie können Ad-hoc-Anmeldedaten definieren, die nur für diese Aktion verwendet und sichtbar sind. Da das SSH-Skript mit den definierten SSH-Anmeldedaten ausgeführt wird, ist es nicht mehr auf die Berechtigungen des Agent-Benutzers beschränkt. Es wird mit den Berechtigungen des SSH-Benutzers ausgeführt. Verwenden Sie diese Aktion, wenn Sie Skriptbefehle mit einem anderen Benutzer als dem Agent-Benutzer ausführen möchten.

Ab Avantra 20.11.5 hängt diese Automatisierungsaktion von der globalen Avantra-Servereinstellung Security.EnableOSCodeExec ab und kann nur verwendet werden, wenn sie auf true gesetzt ist.

Benutzernachricht senden

Sendet eine Nachricht an alle Benutzer, die im SAP-System angemeldet sind (SAPGUI).

Ereignis auslösen

Löst ein SAP-Ereignis aus. Die RFC-Funktion RSSM_EVENT_RAISE wird aufgerufen. Diese Automatisierungsaktion kann beispielsweise verwendet werden, um einen SAP-Job zu starten.

RUN_JS-Skript ausführen

Dieser Schritt ist veraltet. Bitte verwenden Sie die Step Library.

Führt ein RUN_JS-Skript aus (RFC-fähig).