Freigeben über


Überblick über die Orchestrierungskonsole

Die Orchestrator-Konsole ist eine einzige Webseite, die aus mehreren Bereichen und Arbeitsflächen besteht. Dieser Artikel beschreibt diese Fenster und Arbeitsbereiche und enthält Verfahren für den Zugriff auf die Konsole und die Verwaltung von Runbooks. Es stellt Details zur Verwendung der neuesten Webkonsole bereit, die auf HTML5 basiert und SilverLight (veraltet) verwendet. Stellen Sie sicher, dass Sie auf die neueste Webkonsole migrieren, indem Sie die in diesem Artikel beschriebenen Schritte durchführen.

Hinweis

Entpacken Sie das v10.19.350.0 Release-Paket von DLC.

Der Navigationsbereich auf der linken Seite zeigt den Runbook- und Ordner-Baum, wie er im Runbook Designer gezeigt wird. Anders als in der Konsole früherer Versionen können Sie nicht die Ordner auswählen, aber Sie können die Runbooks auswählen und deren Aufträge anzeigen und ausführen.

Der Navigationsbereich ist immer auf allen Bildschirmen sichtbar, um eine schnelle Navigation zu anderen Runbooks und Ordnern zu ermöglichen, während Sie auf demselben Bildschirm bleiben.

Auf der rechten Seite des Navigationsfensters sehen Sie den ausgewählten Bildschirm. Der Dashboard-Bildschirm wird standardmäßig angezeigt.

Hinweis

Momentan wird das automatische Auffrischen für keinen der Bildschirme unterstützt. Laden Sie die Seite manuell neu.

Dashboard

Das Dashboard zeigt oben Aktive Aufträge, gefolgt von einer Tabelle mit allen abgeschlossenen Aufträgen (Historie). Der Bereich Erledigte Aufträge (Historie) ist standardmäßig eingeklappt, so dass Sie sich auf die aktiven Aufträge konzentrieren können.

Screenshot mit dem Verlauf des Dashboards.

Jede Zeile in beiden Panels entspricht einem einzelnen Auftrag. Ein Auftrag kann eine oder mehrere Runbook-Instanzen haben. Jede Zeile zeigt:

  • Job-ID: Link zum Runbook
  • Zeitstempel: Die Anzahl der erfolgreichen und fehlgeschlagenen Instanzen wird in einer der Spalten für alle Zeilen angezeigt.
  • Aktionsschaltflächen: Auftrag anhalten oder Auftragsdetails anzeigen.

Sie können die einzelnen Auftragszeilen markieren und erweitern und die Instanzen des Auftrags anzeigen.

Runbooks

Wenn Sie ein Runbook im Navigationsbaum auswählen oder einen Runbook-Link wählen, navigiert die App zum Runbook-Bildschirm. Im oberen Bereich werden die Runbook-Metadaten (Bearbeitungsstatus, Zeitstempel usw.) aufgelistet. Mit der Schaltfläche Ausführen können Sie das Runbook zur Ausführung auf der gewünschten Untergruppe von Runbook-Servern in eine Warteschlange stellen. Die Schaltfläche Ausführen ist für Runbooks deaktiviert, die sich nicht im Status Veröffentlicht befinden.

Screenshot der Runbook-Ansicht.

Unterhalb dieses Bereichs befindet sich eine Registerkartenansicht:

  • Ansicht: Für das Runbook-Grafikbild.
  • Jobs: Für die Liste der aktiven und abgeschlossenen Aufträge des Runbooks (siehe unten).
  • Instanzen: Für die Liste der aktiven und abgeschlossenen Instanzen des Runbooks über alle seine Jobs (siehe unten).

Sie können die Zeilen in der Ansicht „Jobs“ genauso auswählen wie die Zeilen auf dem Dashboard-Bildschirm. Laufende Aufträge können mit den Schaltflächen rechts neben der laufenden Zeile angehalten werden.

Screenshot mit Runbook-Aufträgen.

Screenshot mit Runbook-Instanzen.

Sie können die Zeilen in der Ansicht „Jobs“ genauso auswählen wie die Zeilen auf dem Dashboard-Bildschirm. Laufende Aufträge können mit den Schaltflächen rechts neben der laufenden Zeile angehalten werden.

Während dieses Bild aktiv ist, können Sie im Navigationsbaum ein anderes Runbook auswählen. Dadurch wird die ausgewählte Registerkarte nicht geändert. Sie können sich die Jobs unterschiedlicher Runbooks ansehen, indem Sie die Registerkarte Jobs auswählen und im Navigationsbaum zu den gewünschten Runbooks navigieren.

Aufträge

Wenn Sie einen Auftrag auswählen (mit der Taste (i)), navigiert die App zu diesem Bildschirm. Das obere Feld zeigt die Metadaten des Auftrags (Zeitstempel, Parameter).

Dem Panel folgt eine Tabelle mit den Instanzen dieses Auftrags.

Screenshot mit Auftragsdetails.

Die meisten Aufträge haben eine einzige Instanz. Wenn das Runbook eine Überwachen/Ereignisauslöser-Aktivität hat, beginnt jeder Trigger eine eigene Auftragsinstanz. Der folgende Screenshot zeigt einen Job mit mehr als einer Instanz.

Screenshot mit Instanzen von Aufträgen.

Hinweis

Ein Job kann zu jedem Zeitpunkt höchstens eine laufende Instanz haben. Da ein Runbook jedoch viele gleichzeitig laufende Jobs haben kann, kann ein Runbook mehr als eine laufende Instanz haben.

Der Status des Auftrags wird visuell mit den Symbolen angezeigt:

Symbol Status
Drei Punkte Auftrag wird in die Warteschlange gestellt.
Sanduhr Auftrag wird ausgeführt
Kreis mit Schrägstrich Auftrag wurde storniert
Häkchen Auftrag erfolgreich abgeschlossen
Rotes Ausrufezeichen Auftrag abgeschlossen, aber fehlgeschlagen
Warnung Auftrag mit Warnung(en) abgeschlossen

Instanzen

Wenn Sie eine Instanz auswählen (mit der Taste (i)), navigiert die App zu diesem Bildschirm. Im oberen Bereich werden die Metadaten der Instanz angezeigt (Job-ID, Zeitstempel, Parameter, Server, der diese Instanz ausführt).

Der Screenshot zeigt die Instanz.

Auf dem oberen Bedienfeld befinden sich außerdem drei Navigationstasten:

  • Vorherige: Zeigt die Instanz an, die vor dieser ausgeführt wurde.
  • Nächste: Zeigen Sie die Instanz an, die nach dieser gelaufen ist.
  • Letzte: Zeigt die aktuellste Instanz an.

Screenshot mit Details zur Runbook-Instanz.

Screenshot mit Runbook-Details.

Hinweis

Die Auftragskennung ist dieselbe, und da die zweite Instanz noch läuft, ist auch der Auftrag noch in Betrieb.

Unter dem Panel sehen Sie das Runbook-Diagramm. Sie können jede Runbook-Aktivität auswählen, um die Aktivitätsausgaben anzuzeigen. Ein Symbol für jede Aktivität zeigt den Status der jeweiligen Aktivität an. Wenn Sie eine Aktivität auswählen, werden in einem Fenster auf der rechten Seite die Ausgaben der Aktivität aufgelistet.

Da eine Aktivität mehr als einmal innerhalb einer Instanz ausgeführt werden kann (wegen der Schleifenbildung), hat jede Ausführung der Aktivität eine eindeutige Sequenznummer. Im Overlay können Sie die Sequenz # über das Dropdown-Menü oben auswählen.

Screenshot mit Details der Instanz.

Hinweis

Um eine schnelle Ladezeit zu gewährleisten, werden nur die ersten 10 Aktivitätsausgaben für die Aktivität geladen. Die Schaltfläche Mehr laden zeigt an, wie oft diese Aktivität ausgeführt wurde, und Sie können sie auswählen, um weitere Ausgaben zu laden.

Die Instanz und Aktivitätsstatus folgen dem gleichen Format wie Jobstatus.

Runbooks ausführen

Navigieren Sie zum Runbook-Bildschirm des gewünschten Runbooks und wählen Sie Ausführen. Auf der rechten Seite öffnet sich ein Overlay-Formular, in dem Sie aufgefordert werden, Ihre Angaben zu machen:

  • Werte für alle Eingabeparameter festlegen (erforderlich).
  • Legen Sie die Runbook-Server fest, auf denen dieser Auftrag geplant werden kann.

Screenshot des parametrisierten Laufs.

Nur einer dieser Server wird diesen Auftrag ausführen. Um ein Runbook auf vielen Servern auszuführen, müssen Sie diese vielen Jobs ausführen und die Server explizit einzeln festlegen.

Hinweis

Geben Sie die Parameter in das Formular ein, sonst wird das Formular nicht berücksichtigt.

Wenn das Formular gesendet wird, erscheint oben rechts ein Popup-Fenster, das anzeigt, ob der Auftrag erfolgreich in die Warteschlange gestellt wurde oder nicht.

Screenshot der Benachrichtigung über die Warteschlange.

Laufende Aufträge stoppen

Die Schaltfläche Stop wird auf dem Dashboard und dem Auftragsbildschirm angezeigt. Ein verschwindendes Popup-Fenster oben rechts zeigt an, ob der Job gestoppt ist oder nicht.

Screenshot der Benachrichtigung über die Beendigung eines Auftrags.

Häufig gestellte Fragen

Die Konsole wird nicht geladen; Fehler „Uh oh! Es wird „Fehler beim Verbinden mit WebApi [Status 0]“ angezeigt.

  1. Überprüfen Sie die Entwicklerkonsole des Browsers (Registerkarte „Konsole“), suchen Sie nach CORS-Fehlern (durch CORS-Richtlinie blockiert).

    Screenshot der Fehlerkonsole.

  2. Wenn keine CORS-Fehler vorliegen, überprüfen Sie die Ereignisanzeige-Protokolle (Anwendung) auf dem Web-API-Computer.

Um CORS-Fehler zu beheben, müssen Sie sicherstellen, dass die web.config-Datei der API eine geeignete CORS-Konfiguration aufweist. Die Fehlermeldung des Browsers zeigt den Ursprungswert an, den er in der Web-API web.config erwartet. Obwohl bei Domänennamen die Groß- und Kleinschreibung nicht beachtet wird, verwendet IIS CORS einen Vergleichstest, der die Groß- und Kleinschreibung berücksichtigt. Stellen Sie sicher, dass der Wert origin in der IIS CORS-Konfiguration in Kleinbuchstaben angegeben ist.

Tipp

Eine typische Web API IIS CORS Konfiguration:

<add allowCredentials="true" maxAge="7200" origin="http://{domain}[:{port}]">
  <allowMethods>
    <add method="GET"/>
    <add method="PUT"/>
    <add method="POST"/>
    <add method="PATCH"/>
    <add method="DELETE"/>
  </allowMethods>
  <allowHeaders allowAllRequestedHeaders="true"/>
</add>

Details zur Konfiguration von CORS in web.config finden Sie in diesem Artikel über CORS-Modulkonfiguration.

Wie kann ich die Web-API-URL aktualisieren?

Die Konsole lädt {install_dir}\assets\configuration.json, um die API-URL zu finden. Sie können das mit einem einfachen Texteditor bearbeiten. Achten Sie darauf, dass am Ende der URL kein / (Schrägstrich) steht.

Migrieren zu HTML5-Webkomponenten

Die HTML5-Webkomponenten wurden im Dezember 2021 durch eine Blogpost-Ankündigung veröffentlicht. Die Version enthielt eine .NET Core 5 REST API und eine neu gestaltete HTML5-Konsole (ohne Silverlight).

Wir empfehlen Ihnen, auf die .NET Core 6 Web Components (v10.19.350.0) zu migrieren, die gemäß der System Center 2019-Supportrichtlinie unterstützt werden.

Nachfolgend finden Sie die Verbesserungen, die an den Webkomponenten vorgenommen wurden:

  1. Aktualisieren Sie auf die neueste LTSC .NET Core 6. .NET 5 hat das Ende der Unterstützung erreicht.
  2. Job start Formularparameter in .NET 5 Web Console waren obligatorisch.
  3. Horizontaler Bildlauf im Navigationsbaum hinzugefügt, Rendering von tief verschachtelten Inhalten festgelegt.
  4. Die API-Endpunkte wurden gehärtet und Probleme mit nicht beachteten Benutzerrechten festgelegt.
  5. Die auf der Konsole angezeigten Zeitstempel stimmen jetzt mit der Zeitzone des Systems überein.
  6. Runbooks auf Root-Ebene (d.h. ohne übergeordneten Ordner) sind jetzt sichtbar.
  7. Die Swagger-Spezifikation (auch bekannt als OpenAPI) zur Beschreibung der API wird zusammen mit der App veröffentlicht.
  8. Paketiert in einem Microsoft Installer (.msi) zusammen mit einer Installer UI zur Vereinfachung der Installation/Deinstallation.

Voraussetzungen für die Installation

Das enthaltene Setup.exe prüft und fragt nach den folgenden fehlenden Voraussetzungen:

  1. .NET 6 Hosting-Paket
  2. IIS-Module: CORS und URL Rewrite.

Tipp

Sie können die Version 10.19.350.0 parallel zu den Funktionen von .NET 5 und SilverLight Web installieren.

Führen Sie den folgenden PowerShell-Befehl aus, um das Release-Paket v10.19.350.0 aus DLC zu extrahieren und Setup.exe zu starten:

Setup.exe /components:webapi,webconsole

Lesen Sie die API und Console installer Dokumentation und folgen Sie den von Setup.exe gezeigten Schritten.

Das Installationsprogramm wird automatisch neue IIS-Sites mit frischen web.config erstellen. Möglicherweise haben Sie Änderungen an der web.config vorgenommen (z. B. Hinzufügen von Domänen zu CORS-zugelassenen Ursprüngen, Datenbankeinstellungen, andere IIS-Site-Elemente). Vergleichen Sie das alte und das neue web.config und aktualisieren Sie das neue web.config wie erforderlich.

Die API-Spezifikation (Swagger/OpenAPI) ist im .json-Format enthalten und kann mit einem Swagger-Vorschauprogramm Ihrer Wahl wie Swagger Editor visualisiert werden.

Folgen Sie den FAQ, um gängige Probleme zu beheben. Sobald Sie mit der Version 10.19.350.0 vertraut sind, können Sie die .NET 5-Apps und die entsprechenden IIS-Sites entfernen.

Häufig gestellte Fragen

Nachdem ich mit dem Browser zur HTML5-Konsole navigiert habe, sehe ich Uh oh! Probleme beim Verbinden mit der API Meldung.

Überprüfen Sie die Konsolenprotokolle des Browsers (drücken Sie Umschalt+Strg+I bei Microsoft Edge) und sehen Sie nach, ob es einen CORS-Fehler gibt. Ein CORS-Fehler bedeutet, dass die URL der Webkonsole nicht in die Liste der zulässigen Ursprünge der API aufgenommen wurde.

Wenn die Anfragen mit dem Fehlercode 401 fehlgeschlagen sind, bedeutet dies, dass ein Authentifizierungsfehler vorliegt.

  • Stellen Sie sicher, dass die Identität, mit der der Browser ausgeführt wird, Leserechte auf Orchestrator-Assets hat. Diese Berechtigungen können über den Runbook Designer vergeben werden. Sie können die Identität des Browser-Prozesses ändern, indem Sie den Browser mit der Option Ausführen als öffnen.
  • Stellen Sie sicher, dass die Windows-Authentifizierung in den IIS-Funktionen aktiviert ist und dass die Methode für die IIS-Site aktiviert ist.

Ich beobachte einige 500-Fehler-Antworten

Sie können jeden REST-Client verwenden, um Anfragen an die API zu stellen. Wenn die API keine Verbindung zur Datenbank herstellen kann oder die erforderliche .NET-Laufzeitumgebung nicht installiert ist, werden Fehler mit Code 500 ausgegeben. Die Fehlerdetails sind in den ETW-Ereignisprotokollen sichtbar (verwenden Sie die Ereignisanzeige), die möglicherweise die Grundursache aufzeigen.

Überprüfen Sie, ob die API funktioniert, indem Sie den folgenden PowerShell-Befehl ausführen:

Für PowerShell 5.1-Version

Invoke-RestMethod http://localhost:<api_port>/api/login -UseDefaultcredentials

Für PowerShell 7.x-Version

Invoke-RestMethod http://localhost:<api_port>/api/login -UseDefaultcredentials -AllowUnencryptedAuthentication

Das Installationsprogramm hat keine HTTPS (TLS) Endpunkte erstellt, die ich benötige.

Das Einrichten von TLS geht über den Rahmen unserer Installationsprogramme hinaus. Konsultieren Sie dazu die IIS-Dokumentation. Sobald dies festgelegt ist, stellen Sie sicher, dass die https-Domäne der Webkonsole ebenfalls in die Liste der zulässigen CORS-Ursprungsdaten aufgenommen wird.

Die Orchestrator-Konsole ist eine Single Page App, die Sie bei der Überwachung und Ausführung Ihrer Orchestrator-Bereitstellung unterstützt. Dieser Artikel beschreibt die unterstützten Funktionen der Orchestrator 2022-Konsole.

Screenshot des Dashboard.

Die Orchestrator-Konsole ist eine Single Page App, die Sie bei der Überwachung und Ausführung Ihrer Orchestrator-Bereitstellung unterstützt. In diesem Artikel werden die unterstützten Features in der Orchestrator 2025-Konsole beschrieben.

Screenshot des Dashboard.

Der Navigationsbereich auf der linken Seite zeigt den Runbook- und Ordner-Baum, wie er im Runbook Designer dargestellt ist. Anders als in der Konsole früherer Versionen können Sie nicht die Ordner auswählen, sondern Sie können die Runbooks auswählen und deren Aufträge anzeigen und ausführen.

Der Navigationsbereich ist immer auf allen Bildschirmen sichtbar, um eine schnelle Navigation zu anderen Runbooks und Ordnern zu ermöglichen, während Sie auf demselben Bildschirm bleiben.

Auf der rechten Seite des Navigationsfensters sehen Sie den ausgewählten Bildschirm. Der Dashboard-Bildschirm wird standardmäßig angezeigt.

Hinweis

Momentan wird das automatische Auffrischen für keinen der Bildschirme unterstützt. Laden Sie die Seite manuell neu.

Dashboard

Das Dashboard zeigt oben Aktive Aufträge, gefolgt von einer Tabelle mit allen abgeschlossenen Aufträgen (Historie). Der Bereich Erledigte Aufträge (Historie) ist standardmäßig eingeklappt, so dass Sie sich auf die aktiven Aufträge konzentrieren können.

Screenshot mit dem Verlauf des Dashboards.

Jede Zeile in beiden Panels entspricht einem einzelnen Auftrag. Ein Auftrag kann eine oder mehrere Runbook-Instanzen haben. Jede Zeile zeigt:

  • Job-ID: Link zum Runbook
  • Zeitstempel: Die Anzahl der erfolgreichen und fehlgeschlagenen Instanzen wird in einer der Spalten für alle Zeilen angezeigt.
  • Aktionsschaltflächen: Auftrag anhalten oder Auftragsdetails anzeigen

Sie können die einzelnen Auftragszeilen markieren und erweitern und die Instanzen des Auftrags anzeigen.

Runbooks

Wenn Sie ein Runbook im Navigationsbaum auswählen oder einen Runbook-Link wählen, navigiert die App zum Runbook-Bildschirm. Im oberen Bereich werden die Runbook-Metadaten (Bearbeitungsstatus, Zeitstempel usw.) aufgelistet. Mit der Schaltfläche Ausführen auf dem Bildschirm können Sie das Runbook zur Ausführung auf der gewünschten Untergruppe von Runbook-Servern in eine Warteschlange stellen. Die Schaltfläche Ausführen ist für Runbooks deaktiviert, die sich nicht im Status Veröffentlicht befinden.

Screenshot der Runbook-Ansicht.

Unterhalb dieses Bereichs befindet sich eine Registerkartenansicht:

  • Ansicht: Für das Runbook-Grafikbild.
  • Jobs: Für die Liste der aktiven und abgeschlossenen Aufträge des Runbooks (siehe unten).
  • Instanzen: Für die Liste der aktiven und abgeschlossenen Instanzen des Runbooks über alle seine Jobs (siehe unten).

Sie können die Zeilen in der Ansicht „Jobs“ genauso auswählen wie die Zeilen auf dem Dashboard-Bildschirm. Laufende Aufträge können mit den Schaltflächen rechts neben der laufenden Zeile angehalten werden.

Screenshot mit Runbook-Aufträgen.

Screenshot mit Runbook-Instanzen.

Während dieses Bild aktiv ist, können Sie im Navigationsbaum ein anderes Runbook auswählen. Dadurch wird die ausgewählte Registerkarte nicht geändert. Sie können die Jobs unterschiedlicher Runbooks schnell einsehen, indem Sie die Registerkarte Jobs auswählen und im Navigationsbaum zu den gewünschten Runbooks navigieren.

Aufträge

Wenn Sie einen Auftrag auswählen (mit der Taste (i)), navigiert die App zu diesem Bildschirm. Das obere Feld zeigt die Metadaten des Auftrags (Zeitstempel, Parameter).

Dem Panel folgt eine Tabelle mit den Instanzen dieses Auftrags.

Screenshot mit Auftragsdetails.

Die meisten Aufträge haben eine einzige Instanz. Wenn das Runbook eine Überwachen/Ereignisauslöser-Aktivität hat, beginnt jeder Trigger eine eigene Auftragsinstanz. Die folgende Abbildung zeigt einen Auftrag mit mehr als einer Instanz.

Screenshot mit Instanzen von Aufträgen.

Hinweis

Ein Job kann zu jedem Zeitpunkt höchstens eine laufende Instanz haben. Da ein Runbook jedoch viele gleichzeitig laufende Jobs haben kann, kann ein Runbook mehr als eine laufende Instanz haben.

Der Status des Auftrags wird visuell mit den Symbolen angezeigt:

  • Drei Punkte: Auftrag ist in der Warteschlange
  • Sanduhr: Der Auftrag läuft
  • Kreis mit Schrägstrich: Auftrag wurde storniert
  • Tick: Auftrag erfolgreich abgeschlossen
  • Rotes Ausrufezeichen: Auftrag abgeschlossen, aber fehlgeschlagen
  • Warnung: Auftrag mit Warnung(en) abgeschlossen

Instanzen

Wenn Sie eine Instanz auswählen (mit der Taste (i)), navigiert die App zu diesem Bildschirm. Im oberen Bereich werden die Metadaten der Instanz angezeigt (Job-ID, Zeitstempel, Parameter, Server, der diese Instanz ausführt).

Der Screenshot zeigt die Instanz.

Auf dem oberen Bedienfeld befinden sich außerdem drei Navigationstasten:

  • Vorherige: Ansicht Instanz, die vor dieser lief.
  • Vorherige: Ansicht Instanz, die vor dieser lief.
  • Letzte: Die aktuellste Instanz anzeigen

Screenshot mit Details zur Runbook-Instanz.

Screenshot mit Runbook-Details.

Hinweis

Die Auftragskennung ist dieselbe, und da die zweite Instanz noch läuft, ist auch der Auftrag noch in Betrieb.

Unter dem Panel sehen Sie das Runbook-Diagramm. Sie können jede Runbook-Aktivität auswählen, um die Aktivitätsausgaben anzuzeigen. Ein Symbol für jede Aktivität zeigt den Status der jeweiligen Aktivität an. Wenn Sie eine Aktivität auswählen, wird auf der rechten Seite ein Overlay angezeigt, in dem die Outputs der Aktivität aufgelistet sind.

Da eine Aktivität mehr als einmal innerhalb einer Instanz ausgeführt werden kann (wegen der Schleifenbildung), hat jede Ausführung der Aktivität eine eindeutige Sequenznummer. Im Overlay können Sie die Sequenz # über das Dropdown-Menü oben auswählen.

Screenshot mit Details der Instanz.

Hinweis

Um eine schnelle Ladezeit zu gewährleisten, werden nur die ersten 10 Aktivitätsausgaben für die Aktivität geladen. Die Schaltfläche Mehr laden zeigt an, wie oft diese Aktivität ausgeführt wurde, und Sie können sie auswählen, um weitere Ausgaben zu laden.

Die Instanz und Aktivitätsstatus folgen dem gleichen Format wie Jobstatus.

Runbooks ausführen

Navigieren Sie zum Runbook-Bildschirm des gewünschten Runbooks und wählen Sie Ausführen. Auf der rechten Seite öffnet sich ein Overlay-Formular, in dem Sie aufgefordert werden, Ihre Angaben zu machen:

  • Werte für alle Eingabeparameter festlegen (erforderlich)
  • Legen Sie die Runbook-Server fest, auf denen dieser Auftrag geplant werden kann.

Screenshot des parametrisierten Laufs.

Nur einer dieser Server wird diesen Auftrag tatsächlich ausführen. Um ein Runbook auf vielen Servern auszuführen, müssen Sie so viele Jobs ausführen und die Server explizit einzeln festlegen.

Hinweis

Geben Sie die Parameter in das Formular ein, sonst wird das Formular nicht berücksichtigt.

Wenn das Formular gesendet wird, erscheint oben rechts ein Popup-Fenster, das anzeigt, ob der Auftrag erfolgreich in die Warteschlange gestellt wurde oder nicht.

Screenshot der Benachrichtigung über die Warteschlange.

Laufende Aufträge stoppen

Die Schaltfläche Stop wird auf dem Dashboard und dem Auftragsbildschirm angezeigt. Oben rechts auf der Seite finden Sie ein verschwindendes Pop-up-Fenster, das Ihnen anzeigt, ob ein Auftrag noch läuft oder bereits beendet ist.

Screenshot der Benachrichtigung über die Beendigung eines Auftrags.

Häufig gestellte Fragen

Die Konsole wird nicht geladen; Fehler „Uh oh! Fehler bei der Verbindung zu WebApi [Status 0]“ erscheint

  1. Überprüfen Sie die Entwicklerkonsole des Browsers (Registerkarte „Konsole“), suchen Sie nach CORS-Fehlern (durch CORS-Richtlinie blockiert).

    Screenshot der Fehlerkonsole.

  2. Wenn keine CORS-Fehler vorliegen, überprüfen Sie die Ereignisanzeige-Protokolle (Anwendung) auf dem Web-API-Computer.

Um CORS-Fehler zu beheben, müssen Sie sicherstellen, dass die web.config-Datei der API eine geeignete CORS-Konfiguration aufweist. Die Fehlermeldung des Browsers zeigt den Ursprungswert an, den er in der Web-API web.config erwartet. Obwohl bei Domänennamen die Groß- und Kleinschreibung nicht beachtet wird, verwendet IIS CORS einen Vergleichstest, der die Groß- und Kleinschreibung berücksichtigt. Stellen Sie sicher, dass der Wert origin in der IIS CORS-Konfiguration in Kleinbuchstaben angegeben ist.

Tipp

Eine typische Web API IIS CORS Konfiguration:

<add allowCredentials="true" maxAge="7200" origin="http://{domain}[:{port}]">
  <allowMethods>
    <add method="GET"/>
    <add method="PUT"/>
    <add method="POST"/>
    <add method="PATCH"/>
    <add method="DELETE"/>
  </allowMethods>
  <allowHeaders allowAllRequestedHeaders="true"/>
</add>

Details zur Konfiguration von CORS in web.config finden Sie in diesem Artikel über CORS-Modulkonfiguration.

Wie kann ich die Web-API-URL aktualisieren?

Die Konsole lädt {install_dir}\assets\configuration.json, um die API-URL zu finden. Sie können das mit einem einfachen Texteditor bearbeiten. Achten Sie darauf, dass am Ende der URL kein / steht.

Die Orchestrierungskonsole ist eine einzige Webseite, die sich aus mehreren Bereichen und Arbeitsflächen zusammensetzt. Dieser Artikel beschreibt diese Fenster und Arbeitsbereiche und enthält Verfahren für den Zugriff auf die Konsole und die Verwaltung von Runbooks.

Der Navigationsbereich ist der linke Bereich der Orchestrierungskonsole, in dem Sie den gewünschten Arbeitsbereich auswählen können. Je nach gewähltem Arbeitsbereich können Sie bestimmte Daten anzeigen und bestimmte Optionen nutzen. Die folgenden Arbeitsbereiche sind im Navigationsbereich verfügbar.

Runbooks-Arbeitsbereich

Im Arbeitsbereich Runbooks können Sie Runbooks beginnen und beenden. Sie können auch Informationen wie die für jedes Runbook erstellten Jobs und Instanzen sowie deren Definition anzeigen.

Zusammenfassung

Die Registerkarte Zusammenfassung wird für jeden im Arbeitsbereich Runbooks ausgewählten Ordner oder Runbook angezeigt. Auf dieser Registerkarte werden zusammenfassende Informationen zu den Jobs und Instanzen des ausgewählten Runbooks oder zu allen Runbooks im ausgewählten Ordner angezeigt. Die angezeigten Statistiken werden alle 10 Minuten aktualisiert. Daher kann es sein, dass die in dieser Zeit durchgeführten Aktivitäten erst nach der Aktualisierung in den Zahlen berücksichtigt werden.

Jede Spalte in der Zusammenfassung zeigt die Anzahl der Aufträge und Instanzen an, die innerhalb der letzten Stunde, des letzten Tages und der letzten Woche mit einem bestimmten Status (Erfolgreich, Warnung oder Fehlgeschlagen) beendet wurden. Bei Instanzen wird auch die Anzahl der momentan in Bearbeitung befindlichen Instanzen angezeigt. Bei Aufträgen wird auch angezeigt, wie viele Aufträge erstellt wurden und momentan in der Warteschlange stehen.

Runbooks

Die Registerkarte Runbooks wird angezeigt, wenn Sie einen Ordner im Arbeitsbereich Runbooks auswählen. Er listet die Runbooks auf, die im ausgewählten Ordner enthalten sind, und gibt den Status aller laufenden Aufträge und Instanzen aus jedem einzelnen an. Um eines dieser Runbooks auszuwählen und dessen Aktionen zu kontrollieren, wählen Sie eine Option im Bereich Aktionen. Wenn Sie eine große Anzahl von Runbooks haben, können Sie die Liste durch Angabe eines Filters verfeinern.

Aufträge

Die Registerkarte Jobs wird angezeigt, wenn Sie einen Ordner oder ein Runbook im Arbeitsbereich Runbooks auswählen. Auf dieser Registerkarte werden die für ein bestimmtes Runbook erstellten Aufträge und der Abschlussstatus aufgeführt. Für einen Ordner werden die für alle Runbooks in diesem Ordner erstellten Aufträge und ihr Abschlussstatus aufgelistet. Ein Job ist eine Anforderung an einen Runbook-Server, ein Runbook auszuführen, und wird jedes Mal erstellt, wenn ein Runbook eine Anforderung zur Ausführung erhält. Wenn ein Runbook mit einem Monitor beginnt, wird ein Job erstellt, der kontinuierlich läuft, bis das Runbook gestoppt wird. In diesem Fall zeigt der Status des Auftrags eine Sanduhr an, die anzeigt, dass er momentan ausgeführt wird.

Instanzen

Die Registerkarte Instanzen wird angezeigt, wenn Sie einen Ordner oder ein Runbook im Arbeitsbereich Runbooks auswählen. Für ein Runbook werden auf dieser Registerkarte die Instanzen aufgelistet, die für das Runbook angelegt wurden, sowie deren Abschlussstatus. Für einen Ordner werden die Instanzen aufgelistet, die für alle Runbooks im Ordner erstellt wurden, sowie deren Fertigstellungsstatus. Eine Instanz ist eine laufende Kopie eines Runbooks und wird jedes Mal erstellt, wenn dieses Runbook ausgeführt wird. Wenn ein Runbook mit einem Monitor beginnt, erzeugt es eine Instanz, die so lange läuft, bis die Monitorbedingung erfüllt ist. In diesem Fall zeigt der Status der Instanz eine Sanduhr an. Wenn die Überwachungsbedingung erfüllt ist, fährt die Instanz mit den nachfolgenden Aktivitäten fort und zeigt dann einen Abschlussstatus an. Das Runbook erzeugt dann eine neue Instanz, die ebenfalls läuft, bis die Überwachungsbedingung erfüllt ist.

Arbeitsbereich Runbook Server

Im Arbeitsbereich Runbook Server können Sie den Status der aktuellen und abgeschlossenen Aufträge und Instanzen für jeden Runbook Server einsehen.

Aufträge

Auf der Registerkarte Aufträge werden die auf dem Runbook-Server ausgeführten Aufträge und ihr Abschlussstatus aufgelistet. Ein Job ist eine Anforderung an einen Runbook-Server, ein Runbook auszuführen, und wird jedes Mal erstellt, wenn ein Runbook eine Anforderung zur Ausführung erhält. Wenn ein Runbook mit einem Monitor beginnt, wird ein Job erstellt, der kontinuierlich läuft, bis das Runbook gestoppt wird. In diesem Fall zeigt der Status des Auftrags eine Sanduhr an, was bedeutet, dass er momentan ausgeführt wird.

Instanzen

Die Registerkarte Instanzen listet die Instanzen auf, die auf dem Runbook-Server erstellt wurden, sowie deren Fertigstellungsstatus. Eine Instanz ist eine laufende Kopie eines Runbooks und wird jedes Mal erstellt, wenn dieses Runbook ausgeführt wird. Wenn ein Runbook mit einem Monitor beginnt, erzeugt es eine Instanz, die so lange läuft, bis die Monitorbedingung erfüllt ist. In diesem Fall zeigt der Status der Instanz eine Sanduhr an. Wenn die Überwachungsbedingung erfüllt ist, fährt die Instanz mit den nachfolgenden Aktivitäten fort und zeigt dann einen Abschlussstatus an. Das Runbook erzeugt dann eine neue Instanz, die ebenfalls läuft, bis die Überwachungsbedingung erfüllt ist.

Arbeitsbereich Ereignisse

Im Arbeitsbereich Ereignisse können Sie Ereignisse im Protokoll einsehen. Standardmäßig enthalten die Protokollereignisse alle Ereignisse für den Management-Server und alle Runbook-Server. Wenn Sie die Ereignisse einschränken möchten, wählen Sie Filtern aus, und geben Sie Kriterien zum Einschränken der angezeigten Ereignisse an. Wenn sich ein Ereignis auf einen Runbook-Server bezieht, enthält es den Namen des Servers im Feld Quelle. In diesem Fall können Sie das Ereignis auswählen und dann Runbook Server anzeigen im Bereich Aktionen wählen. Wenn Sie Runbook-Server anzeigen wählen, wird die Registerkarte Jobs im Arbeitsbereich Runbook-Server für diesen Runbook-Server geöffnet.

Starten Sie die Orchestration-Konsole in einem Browser

  1. Öffnen Sie Ihren Browser.

  2. Geben Sie http://computer name/:port number in der Adressleiste an, wo Computername der Name des Servers ist, auf dem der Webdienst installiert ist, und Port die bei der Konfiguration des Webdienstes ausgewählte Portnummer ist. Standardmäßig ist der Anschluss 82.

Starten Sie die Orchestrierungskonsole im Runbook Designer

Wählen Sie auf der Symbolleiste die Schaltfläche Orchestrierungskonsole aus.

Hinweis

Wenn die URL nicht für die Orchestrierungskonsole festgelegt wurde, erhalten Sie eine Fehlermeldung. Gehen Sie wie folgt vor, um die URL festzulegen.

Definieren der URL der Orchestrierungskonsole im Runbook Designer

  1. Wählen Sie Optionen, und wählen Sie dann Orchestrierungskonsole.

  2. Geben Sie im Feld URL http://computer name:port number ein, wobei „Computername“ der Name des Servers ist, auf dem der Webdienst installiert ist, und „Port“ die Portnummer ist, die während der Konfiguration des Webdiensts ausgewählt wurde. Standardmäßig ist der Anschluss 82.

  3. Wählen Sie Fertig stellen aus.

Runbooks beginnen und beenden

Zusätzlich zum Anzeigen des aktuellen Status eines Runbook können Sie auch ein Runbook über die Orchestration-Konsole starten und stoppen. Wenn Sie ein Runbook beginnen, wird ein Job angelegt und wartet auf einen verfügbaren Runbook-Server, um das Runbook zu verarbeiten. Handelt es sich bei der ersten Aktion in einem Runbook um einen Monitor, wird der Job kontinuierlich ausgeführt und erzeugt möglicherweise mehrere Instanzen eines Runbooks, bis das Runbook oder der Job gestoppt wird. Wenn ein Runbook-Server verfügbar ist, stellt der Job dem Runbook-Server eine Instanz des Runbooks zur Verarbeitung bereit. Ein laufendes Runbook hat mindestens einen Job und eine oder mehrere Instanzen, die mit ihm verbunden sind.

Wenn Sie ein Runbook stoppen, werden das Runbook, alle Aufträge und alle Instanzen, die dem Runbook zugeordnet sind, gestoppt.

Wählen Sie die erforderliche Registerkarte für Schritte aus, um den Status eines Runbook zu starten, zu beenden oder anzuzeigen:

Gehen Sie folgendermaßen vor, um ein Runbook zu starten:

  1. Wählen Sie Runbooks, um den Arbeitsbereich Runbooks zu öffnen.

  2. Wenn sich das Runbook in einem Ordner befindet, wählen Sie den Ordner im Bereich Runbooks aus.

  3. Wählen Sie im Ergebnisbereich die Registerkarte Runbooks aus.

  4. Wählen Sie das Runbook aus, und wählen Sie dann im Bereich Aktionen die Option Runbook beginnen.

  5. Wenn für das Runbook Parameter erforderlich sind, werden diese im Bereich Runbook-Parameter aufgeführt. Markieren Sie die Spalte Wert für jedes Runbook und geben Sie einen Wert für das zu verwendende Runbook ein.

  6. Wenn Sie das Runbook auf einem anderen Server als dem Standardserver ausführen möchten, wählen Sie einen Server im Bereich Verfügbare(r) Runbook-Server aus, und wählen Sie dann den Pfeil nach rechts, um den Server zum Bereich Ausgewählte(r) Runbook-Server hinzuzufügen.

    Hinweis

    Wenn Sie dem Bereich Ausgewählte(r) Runbook-Server mehrere Server hinzufügen, wird das Runbook nur auf dem ersten Server ausgeführt, wenn dieser verfügbar ist. Die anderen Server sind Backup-Server, auf denen das Runbook nur ausgeführt wird, wenn der primäre Server nicht verfügbar ist.

  7. Wählen Sie Starten aus.

Aufträge stoppen

Ein Job ist eine Anforderung zur Ausführung eines Runbooks. Ein Job wird nur erstellt, wenn Sie die Ausführung eines Runbooks anfordern. Wenn die erste Aktion in einem Runbook ein Monitor ist, läuft der Job kontinuierlich, bis das Runbook oder der Job gestoppt wird. Eine Sanduhr zeigt den Status eines laufenden Auftrags an. Eine Instanz ist eine laufende Kopie eines Runbooks.

Sie können keinen Auftrag beginnen, sondern nur ein Runbook.

Wenn Sie eine Instanz anzeigen, können Sie den zugehörigen Auftrag anhalten. Das Anhalten des Auftrags stoppt die Instanz, den Auftrag, alle anderen verbundenen Instanzen und das Runbook.

Nächste Schritte

Weitere Informationen zur Bereitstellung von Runbooks finden Sie unter Runbooks bereitstellen.