Übersicht über die Orchestrierungskonsole

Wichtig

Diese Version von Orchestrator hat das Ende des Supports erreicht. Es wird empfohlen, ein Upgrade auf Orchestrator 2022 durchzuführen.

Die Orchestrator-Konsole ist eine einzelne Webseite, die aus mehreren Bereichen und Arbeitsbereichen besteht. In diesem Artikel werden diese Bereiche und Arbeitsbereiche beschrieben und Prozeduren für den Zugriff auf die Konsole und die Verwaltung von Runbooks beschrieben. Sie enthält Details zur Verwendung der neuesten Webkonsole, die auf HTML5 basiert und SilverLight (veraltet) verwendet. Stellen Sie mithilfe der in diesem Artikel beschriebenen Schritte sicher, dass Sie zur neuesten Webkonsole migrieren .

Hinweis

Extrahieren Sie das Releasepaket v10.19.350.0 aus DLC.

Der Navigationsbereich auf der linken Seite zeigt die Struktur Runbook und Ordner, wie sie auf dem Runbook Designer. Im Gegensatz zur Konsole in früheren Versionen können Sie die Ordner nicht auswählen, sondern 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 und gleichzeitig auf demselben Bildschirm zu bleiben.

Rechts neben dem Navigationsbereich wird der ausgewählte Bildschirm angezeigt. Der Dashboardbildschirm wird standardmäßig angezeigt.

Hinweis

Derzeit wird die automatische Aktualisierung für keinen der Bildschirme unterstützt. Laden Sie die Seite manuell neu.

Dashboard

Das Dashboard zeigt oben aktive Aufträge an, gefolgt von einer Tabelle mit allen abgeschlossenen Aufträgen (Verlauf). Der Bereich Abgeschlossene Aufträge (Verlauf) ist standardmäßig reduziert, sodass der Fokus auf die aktiven Aufträge möglich ist.

Screenshot: Dashboard Verlauf

Jede Zeile in beiden Panels entspricht einem eindeutigen Auftrag. Ein Auftrag kann über eine oder mehrere Runbookinstanzen verfügen. Jede Zeile zeigt Folgendes an:

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

Sie können jede der Auftragszeilen auswählen und erweitern und die Instanzen des Auftrags anzeigen.

Runbooks

Wenn Sie ein Runbook in der Navigationsstruktur auswählen oder einen Runbooklink auswählen, navigiert die App zum Runbook-Bildschirm. Im oberen Bereich werden Runbookmetadaten aufgelistet (bearbeiten status, Zeitstempel usw.). Mit der Schaltfläche Ausführen können Sie das Runbook für die Ausführung auf der gewünschten Teilmenge von Runbookservern in die Warteschlange stellen. Die Schaltfläche Ausführen ist für Runbooks deaktiviert, die sich nicht im Status Veröffentlicht befinden.

Screenshot: Runbookansicht

Unterhalb dieses Bereichs befindet sich eine Registerkartenansicht:

  • Ansicht: Für das grafische Runbook-Image.
  • Aufträge: 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 für alle zugehörigen Aufträge (siehe unten).

Sie können die Zeilen in der Ansicht Aufträge genau wie die Zeilen auf dem Bildschirm Dashboard auswählen. Aufträge, die ausgeführt werden, können über die Schaltflächen rechts neben der ausgeführten Zeile beendet werden.

Screenshot: Runbookaufträge

Screenshot: Runbook-Instanzen

Sie können die Zeilen in der Ansicht Aufträge genau wie die Zeilen auf dem Bildschirm Dashboard auswählen. Aufträge, die ausgeführt werden, können über die Schaltflächen rechts neben der ausgeführten Zeile beendet werden.

Während dieser Bildschirm aktiv ist, können Sie ein anderes Runbook in der Navigationsstruktur auswählen. Dadurch wird die ausgewählte Registerkarte nicht geändert. Sie können Aufträge verschiedener Runbooks anzeigen, indem Sie die Registerkarte Aufträge auswählen und zu den gewünschten Runbooks in der Navigationsstruktur navigieren.

Aufträge

Wenn Sie einen Auftrag auswählen (mit der Schaltfläche (i)), navigiert die App zu diesem Bildschirm. Im oberen Bereich werden die Metadaten des Auftrags (Zeitstempel, Parameter) angezeigt.

Im Bereich folgt eine Tabelle mit den Instanzen dieses Auftrags.

Screenshot: Auftragsdetails

Die meisten Aufträge verfügen über eine einzelne Instanz. Wenn das Runbook über eine Monitor/Event-Triggeraktivität verfügt, startet jeder Trigger einen eindeutigen Auftrag instance. Der folgende Screenshot zeigt einen Auftrag mit mehr als einer Instanz.

Screenshot: Instanzen von Aufträgen

Hinweis

Ein Auftrag kann jederzeit höchstens eine Instanz ausführen. Da ein Runbook jedoch viele gleichzeitig ausgeführte Aufträge haben kann, kann ein Runbook über mehrere ausgeführte Instanzen verfügen.

Die status des Auftrags wird visuell mit den Symbolen angezeigt:

Symbol Status
Drei Punkte Auftrag befindet sich in der Warteschlange
Sanduhr Auftrag wird ausgeführt
Kreis mit Schrägstrich Auftrag wurde abgebrochen
Tick Auftrag erfolgreich abgeschlossen
Rotes Ausrufezeichen Auftrag abgeschlossen, aber nicht erfolgreich
Warnung Auftrag mit Warnung(en) abgeschlossen

Instanzen

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

Screenshot: instance

Der obere Bereich verfügt außerdem über drei Navigationsschaltflächen:

  • Zurück: Zeigen Sie die Instanz an, die vor dieser Instanz ausgeführt wurde.
  • Weiter: Zeigen Sie die Instanz an, die nach dieser Instanz ausgeführt wurde.
  • Neueste: Zeigen Sie die aktuellsten instance an.

Screenshot: Runbook instance Details

Screenshot: Runbookdetails

Hinweis

Die Auftrags-ID ist identisch, und da der zweite instance noch ausgeführt wird, wird der Auftrag auch weiterhin ausgeführt.

Unterhalb des Bereichs sehen Sie das Runbookdiagramm. Sie können jede Runbookaktivität auswählen, um Aktivitätsausgaben anzuzeigen. Ein für jede Aktivität dediziertes Symbol gibt die status dieser Aktivität an. Wenn Sie eine Aktivität auswählen, werden in einem Bereich auf der rechten Seite die Ausgaben der Aktivität aufgelistet.

Da eine Aktivität mehr als einmal innerhalb eines instance ausgeführt werden kann (aufgrund von Schleifen), weist jede Ausführung der Aktivität eine eindeutige Sequenznummer auf. Mit dem Overlay können Sie die Sequenz # mithilfe der Dropdownliste oben auswählen.

Screenshot: instance Detail

Hinweis

Um eine schnelle Ladezeit sicherzustellen, 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 status Instanz und Aktivität folgen dem gleichen Format wie der Auftragsstatus.

Runbooks ausführen

Navigieren Sie zum Runbook-Bildschirm des gewünschten Runbooks, und wählen Sie Ausführen aus. Rechts wird ein Überlagerungsformular geöffnet, zu dem Sie aufgefordert werden:

  • Legen Sie Werte auf alle Eingabeparameter fest (erforderlich).
  • Wählen Sie die Runbookserver aus, auf denen dieser Auftrag geplant werden kann.

Screenshot: parametrisierte Ausführung

Nur einer dieser Server führt diesen Auftrag aus. Um ein Runbook auf vielen Servern auszuführen, müssen Sie diese vielen Aufträge ausführen und die Server explizit einzeln festlegen.

Hinweis

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

Wenn das Formular übermittelt wird, wird oben rechts ein ausgeblendetes Popup angezeigt, um zu benachrichtigen, ob der Auftrag erfolgreich in die Warteschlange eingereiht wurde oder nicht.

Screenshot: Benachrichtigung der Auftragswarteschlange

Beenden der Ausführung von Aufträgen

Die Schaltfläche Beenden wird auf dem Dashboard und im Bildschirm Auftrag angezeigt. Das popup oben rechts wird angezeigt, ob der Auftrag beendet wurde oder nicht.

Screenshot: Benachrichtigung zum Beenden des Auftrags

Häufig gestellte Fragen

Die Konsole wird nicht geladen. Fehler "Uh oh! Probleme beim Herstellen einer Verbindung mit WebApi [status 0]" werden angezeigt.

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

    Screenshot: Fehlerkonsole

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

Um CORS-Fehler zu beheben, müssen Sie sicherstellen, dass die Datei der web.config API über eine geeignete CORS-Konfiguration verfügen muss. Der Browserfehler zeigt den Ursprungswert an, den er in der Web-API web.configerwartet. Obwohl bei Domänennamen die Groß-/Kleinschreibung nicht beachtet wird, verwendet IIS CORS beim Vergleichstest die Groß-/Kleinschreibung. Stellen Sie sicher, dass sich der origin Wert in Kleinbuchstaben in der IIS CORS-Konfiguration befindet.

Tipp

Eine typische IIS-CORS-Konfiguration der Web-API:

<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>

Ausführliche Informationen zum Konfigurieren von CORS in finden Sie in web.configdiesem Artikel zur CORS-Modulkonfiguration.

Gewusst wie 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. Stellen Sie sicher, dass am Ende der URL kein nachgestellter / Schrägstrich vorhanden ist.

Migrieren zu HTML5-Webkomponenten

Die HTML5-Webkomponenten wurden im Dezember 2021 über eine Blogbeitragsankündigung veröffentlicht. Das Release enthielt eine .NET Core 5-REST-API und eine neu gestaltete HTML5-Konsole (ohne Silverlight).

Es wird empfohlen, zu den .NET Core 6-Webkomponenten (v10.19.350.0) zu migrieren, die gemäß der System Center 2019-Supportrichtlinie unterstützt werden.

Im Folgenden sind die Verbesserungen an den Webkomponenten aufgeführt:

  1. Führen Sie ein Upgrade auf den neuesten LTSC .NET Core 6 aus. .NET 5 hat das Ende des Supports erreicht.
  2. Job start Formularparameter in der .NET 5-Webkonsole waren obligatorisch.
  3. Horizontales Scrollen zur Navigationsstruktur hinzugefügt, behebt das Rendern tief geschachtelter Inhalte.
  4. API-Endpunkte wurden gehärtet, und Probleme in Bezug auf Benutzerberechtigungen, die nicht berücksichtigt werden, wurden behoben.
  5. Zeitstempel, die in der Konsole angezeigt werden, entsprechen jetzt der Zeitzone des Systems.
  6. Runbooks auf Stammebene (d. h. ohne übergeordnete Ordner) sind jetzt sichtbar.
  7. Die Swagger-Spezifikation (auch als OpenAPI bezeichnet) zur Beschreibung der API wird zusammen mit der App veröffentlicht.
  8. Gepackt in einem Microsoft Installer (.msi) zusammen mit einer Installationsoberfläche, um die Installation/Deinstallation zu vereinfachen.

Voraussetzungen für die Installation

Der eingeschlossene Setup.exe testet und fordert die folgenden fehlenden Voraussetzungen auf:

  1. .NET 6-Hostingpaket
  2. IIS-Module: CORS - und URL-Neuschreibung.

Tipp

Sie können die Version v10.19.350.0 parallel mit den Features .NET 5 und SilverLight Web installieren.

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

Setup.exe /components:webapi,webconsole

Lesen Sie die Dokumentation zum API- und Konsoleninstallationsprogramm, und führen Sie die unter gezeigten Schritte ausSetup.exe.

Das Installationsprogramm erstellt automatisch neue IIS-Websites mit neuer web.config. Möglicherweise haben Sie Änderungen am web.config vorgenommen (z. B. Hinzufügen von Domänen zu CORS-zulässigen Ursprüngen, Datenbankeinstellungen, anderen IIS-Websiteelementen). Vergleichen Sie das vorherige und das neue web.config , und aktualisieren Sie die neue web.config nach Bedarf.

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

Befolgen Sie die häufig gestellten Fragen, um häufige Probleme zu beheben. Sobald Sie mit der Version v10.19.350.0 vertraut sind, können Sie die .NET 5-Apps und die entsprechenden IIS-Websites entfernen.

Häufig gestellte Fragen

Nachdem ich mit dem Browser zur HTML5-Konsole navigiert habe, sehe ich Uh oh! Probleme beim Herstellen einer Verbindung mit der API-Nachricht .

Überprüfen Sie die Konsolenprotokolle des Browsers (drücken Sie UMSCHALT+STRG+I in Microsoft Edge), und überprüfen Sie, ob ein CORS-Fehler vorliegt. Ein CORS-Fehler bedeutet, dass die Webkonsolen-URL nicht der Liste der zulässigen Ursprünge der API hinzugefügt wurde.

Wenn die Anforderungen 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, Über Leserechte für Orchestrator-Ressourcen verfügt. Diese Berechtigungen können mithilfe des Runbook-Designer erteilt werden. Sie können die Identität des Browserprozesses ändern, indem Sie den Browser mit der Option Ausführen unter öffnen.
  • Stellen Sie sicher, dass die Windows-Authentifizierung in IIS-Features aktiviert ist und dass die Methode mit der IIS-Website aktiviert ist.

Ich beobachte etwa 500 Fehlerantworten

Sie können einen beliebigen REST-Client verwenden, um Anforderungen an die API ausstellen zu können. Wenn die API keine Verbindung mit der Datenbank herstellen kann oder die erforderliche .NET-Runtime nicht installiert ist, werden Fehler mit Code 500 ausgegeben. Die Fehlerdetails sind in den ETW-Ereignisprotokollen (verwenden Sie Ereignisanzeige) sichtbar, die möglicherweise die Grundursache aufdecken.

Ü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-Endpunkte (TLS) erstellt, ich benötige sie.

Die Einrichtung von TLS liegt außerhalb des Rahmens unserer Installationsprogramme. Sie müssen die IIS-Dokumentation befolgen. Stellen Sie nach der Einrichtung sicher, dass auch die HTTPS-Domäne der Webkonsole der Liste der zulässigen CORS-Ursprungs hinzugefügt wird.

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 2022-Konsole beschrieben.

Screenshot des Dashboard.

Der Navigationsbereich auf der linken Seite zeigt die Struktur Runbook und Ordner, wie sie auf dem Runbook-Designer. Im Gegensatz zur Konsole in früheren Versionen können Sie die Ordner nicht auswählen, sondern 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 auf demselben Bildschirm verbleibt.

Rechts neben dem Navigationsbereich wird der ausgewählte Bildschirm angezeigt. Der Dashboardbildschirm wird standardmäßig angezeigt.

Hinweis

Derzeit wird die automatische Aktualisierung für keinen der Bildschirme unterstützt. Laden Sie die Seite manuell neu.

Dashboard

Das Dashboard zeigt oben aktive Aufträge an, gefolgt von einer Tabelle mit allen abgeschlossenen Aufträgen (Verlauf). Der Bereich Abgeschlossene Aufträge (Verlauf) ist standardmäßig reduziert, sodass der Fokus auf die aktiven Aufträge möglich ist.

Screenshot: Dashboard Verlauf

Jede Zeile in beiden Panels entspricht einem eindeutigen Auftrag. Ein Auftrag kann über eine oder mehrere Runbookinstanzen verfügen. Jede Zeile zeigt Folgendes an:

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

Sie können jede der Auftragszeilen auswählen und erweitern und die Instanzen des Auftrags anzeigen.

Runbooks

Wenn Sie ein Runbook in der Navigationsstruktur auswählen oder einen Runbooklink auswählen, navigiert die App zum Runbook-Bildschirm. Im oberen Bereich werden Runbookmetadaten aufgelistet (bearbeiten status, Zeitstempel usw.). Mit der auf dem Bildschirm verfügbaren Schaltfläche Ausführen können Sie das Runbook für die Ausführung auf der gewünschten Teilmenge der Runbookserver in die Warteschlange stellen. Die Schaltfläche Ausführen ist für Runbooks deaktiviert, die sich nicht im Status Veröffentlicht befinden.

Screenshot: Runbookansicht

Unterhalb dieses Bereichs befindet sich eine Registerkartenansicht:

  • Ansicht: Für das grafische Runbook-Image.
  • Aufträge: 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 für alle zugehörigen Aufträge (siehe unten).

Sie können die Zeilen in der Ansicht Aufträge genau wie die Zeilen auf dem Bildschirm Dashboard auswählen. Aufträge, die ausgeführt werden, können über die Schaltflächen rechts neben der ausgeführten Zeile beendet werden.

Screenshot: Runbookaufträge

Screenshot: Runbook-Instanzen

Während dieser Bildschirm aktiv ist, können Sie ein anderes Runbook in der Navigationsstruktur auswählen. Dadurch wird die ausgewählte Registerkarte nicht geändert. Sie können Aufträge verschiedener Runbooks schnell anzeigen, indem Sie die Registerkarte Aufträge auswählen und zu den gewünschten Runbooks in der Navigationsstruktur navigieren.

Aufträge

Wenn Sie einen Auftrag auswählen (mit der Schaltfläche (i)), navigiert die App zu diesem Bildschirm. Im oberen Bereich werden die Metadaten des Auftrags (Zeitstempel, Parameter) angezeigt.

Im Bereich folgt eine Tabelle mit den Instanzen dieses Auftrags.

Screenshot: Auftragsdetails

Die meisten Aufträge verfügen über eine einzelne Instanz. Wenn das Runbook über eine Monitor/Event-Triggeraktivität verfügt, startet jeder Trigger einen eindeutigen Auftrag instance. Der folgende Screenshot zeigt einen Auftrag mit mehr als einer Instanz.

Screenshot: Instanzen von Aufträgen

Hinweis

Ein Auftrag kann jederzeit höchstens eine Instanz ausführen. Da ein Runbook jedoch viele gleichzeitig ausgeführte Aufträge haben kann, kann ein Runbook über mehrere ausgeführte Instanzen verfügen.

Die status des Auftrags wird visuell mit den Symbolen angezeigt:

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

Instanzen

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

Screenshot: instance

Der obere Bereich verfügt außerdem über drei Navigationsschaltflächen:

  • Zurück: Zeigen Sie die Instanz an, die vor dieser Instanz ausgeführt wurde.
  • Weiter: Zeigen Sie die Instanz an, die nach dieser Instanz ausgeführt wurde.
  • Neueste: Aktuelle instance anzeigen

Screenshot: Runbook instance Details

Screenshot: Runbookdetails

Hinweis

Die Auftrags-ID ist identisch, und da der zweite instance noch ausgeführt wird, wird der Auftrag auch weiterhin ausgeführt.

Unterhalb des Bereichs sehen Sie das Runbookdiagramm. Sie können jede Runbookaktivität auswählen, um Aktivitätsausgaben anzuzeigen. Ein für jede Aktivität dediziertes Symbol gibt die status dieser Aktivität an. Wenn Sie eine Aktivität auswählen, wird auf der rechten Seite eine Überlagerung angezeigt, die die Ausgaben der Aktivität auflistet.

Da eine Aktivität mehr als einmal innerhalb eines instance ausgeführt werden kann (aufgrund von Schleifen), weist jede Ausführung der Aktivität eine eindeutige Sequenznummer auf. Mit dem Overlay können Sie die Sequenz # mithilfe der Dropdownliste oben auswählen.

Screenshot: instance Detail

Hinweis

Um eine schnelle Ladezeit sicherzustellen, 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 status Instanz und Aktivität folgen dem gleichen Format wie der Auftragsstatus.

Runbooks ausführen

Navigieren Sie zum Runbook-Bildschirm des gewünschten Runbooks, und wählen Sie Ausführen aus. Rechts wird ein Überlagerungsformular geöffnet, zu dem Sie aufgefordert werden:

  • Festlegen von Werten auf alle Eingabeparameter (erforderlich)
  • Wählen Sie die Runbookserver aus, auf denen dieser Auftrag geplant werden kann.

Screenshot: parametrisierte Ausführung

Nur einer dieser Server führt diesen Auftrag tatsächlich aus. Um ein Runbook auf vielen Servern auszuführen, müssen Sie diese anzahl von Aufträgen ausführen und die Server explizit nacheinander festlegen.

Hinweis

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

Wenn das Formular übermittelt wird, wird oben rechts ein ausgeblendetes Popup angezeigt, um zu benachrichtigen, ob der Auftrag erfolgreich in die Warteschlange eingereiht wurde oder nicht.

Screenshot: Benachrichtigung der Auftragswarteschlange

Beenden der Ausführung von Aufträgen

Die Schaltfläche Beenden wird auf dem Dashboard und im Bildschirm Auftrag angezeigt. Sie finden oben rechts auf der Seite ein ausgeblendetes Popupfenster, um zu bestätigen, ob ein Auftrag noch ausgeführt wird oder ob er beendet wurde.

Screenshot: Benachrichtigung zum Beenden des Auftrags

Häufig gestellte Fragen

Die Konsole wird nicht geladen. Fehler "Uh oh! Probleme beim Herstellen einer Verbindung mit WebApi [status 0]" angezeigt

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

    Screenshot: Fehlerkonsole

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

Um CORS-Fehler zu beheben, müssen Sie sicherstellen, dass die Datei der web.config API über eine geeignete CORS-Konfiguration verfügen muss. Der Browserfehler zeigt den Ursprungswert an, den er in der Web-API web.configerwartet. Obwohl bei Domänennamen die Groß-/Kleinschreibung nicht beachtet wird, verwendet IIS CORS beim Vergleichstest die Groß-/Kleinschreibung. Stellen Sie sicher, dass sich der origin Wert in Kleinbuchstaben in der IIS CORS-Konfiguration befindet.

Tipp

Eine typische IIS-CORS-Konfiguration der Web-API:

<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>

Ausführliche Informationen zum Konfigurieren von CORS in finden Sie in web.configdiesem Artikel zur CORS-Modulkonfiguration.

Gewusst wie 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. Stellen Sie sicher, dass am Ende der URL kein nachgestelltes / vorhanden ist.

Die Orchestrierungskonsole ist eine einzelne Webseite, die aus mehreren Bereichen und Arbeitsbereichen besteht. In diesem Artikel werden diese Bereiche und Arbeitsbereiche beschrieben und Prozeduren für den Zugriff auf die Konsole und die Verwaltung von Runbooks beschrieben.

Der Navigationsbereich ist der linke Bereich in der Orchestrierungskonsole, in dem Sie den arbeitsbereich auswählen können, den Sie verwenden möchten. Je nach ausgewähltem Arbeitsbereich können Sie bestimmte Daten anzeigen und bestimmte Optionen verwenden. Folgende Arbeitsbereiche stehen im Navigationsbereich zur Verfügung.

Arbeitsbereich „Runbooks“

Im Arbeitsbereich Runbooks können Sie Runbooks starten und beenden. Sie können außerdem Informationen zu den für jedes Runbook erstellten Aufträgen und Instanzen sowie die zugehörigen Definitionen anzeigen.

Zusammenfassung

Die Registerkarte Zusammenfassung wird für die im Arbeitsbereich Runbooks ausgewählten Ordner oder Runbooks angezeigt. Auf dieser Registerkarte werden Zusammenfassungsinformationen für die Aufträge und Instanzen des ausgewählten Runbooks oder für alle Runbooks im ausgewählten Ordner angezeigt. Die angezeigten Statistiken werden alle 10 Minuten aktualisiert, sodass die innerhalb dieser Zeit ausgeführte Aktivität möglicherweise erst in den Zahlen widergespiegelt wird, wenn sie aktualisiert wurden.

In jeder Spalte der Zusammenfassung wird die Anzahl der Aufträge und Instanzen angezeigt, die mit einem bestimmten Status („Erfolgreich“, „Warnung“ oder „Fehlerhaft“) innerhalb der letzten Stunde, des letzten Tags und der letzten Woche abgeschlossen wurden. Für Instanzen wird auch die Anzahl der Instanzen angezeigt, die aktuell verarbeitet werden. Für Aufträge wird auch die Anzahl der Aufträge angezeigt, die erstellt wurden und sich aktuell in der Warteschlange befinden.

Runbooks

Die Registerkarte Runbooks wird angezeigt, wenn Sie im Arbeitsbereich Runbooks einen Ordner auswählen. Auf ihr werden die in dem ausgewählten Ordner enthaltenen Runbooks aufgeführt und der Status der für diese Runbooks ausgeführten Aufträge und Instanzen angezeigt. Um eines dieser Runbooks auszuwählen und ihre Aktionen zu steuern, wählen Sie im Bereich Aktionen eine Option aus. Bei einer größeren Anzahl von Runbooks können Sie mithilfe eines Filters die Liste verfeinern.

Aufträge

Die Registerkarte Aufträge wird angezeigt, wenn Sie im Arbeitsbereich Runbooks einen Ordner oder ein Runbook auswählen. Auf diese Registerkarte werden die für ein bestimmtes Runbook erstellten Aufträge und der Abschlussstatus angezeigt. Bei einem Ordner werden die für sämtliche Runbooks in diesem Ordner erstellten Aufträge und deren Abschlussstatus aufgeführt. Ein Auftrag ist eine Anforderung an einen Runbook-Server zur Ausführung eines Runbooks. Er wird bei jeder Anforderung zur Ausführung an ein Runbook erstellt. Wenn ein Runbook mit einem Monitor gestartet wird, wird ein Auftrag erstellt, der bis zur Beendigung des Runbooks fortlaufend ausgeführt wird. In diesem Fall zeigt die status des Auftrags eine Sanduhr an, die angibt, dass sie gerade ausgeführt wird.

Instanzen

Die Registerkarte Instanzen wird angezeigt, wenn Sie einen Ordner oder ein Runbook im Arbeitsbereich Runbooks auswählen. Bei einem Runbook werde auf dieser Registerkarte die für das Runbook erstellten Instanzen und deren Abschlussstatus aufgeführt. Bei einem Ordner werden die für sämtliche Runbooks im Ordner erstellten Instanzen und deren Abschlussstatus aufgeführt. Ein instance ist eine ausgeführte Kopie eines Runbooks und wird jedes Mal erstellt, wenn das Runbook ausgeführt wird. Wenn ein Runbook mit einem Monitor gestartet wird, wird eine Instanz erstellt, die so lange ausgeführt wird, bis die Monitorbedingung erfüllt ist. In diesem Fall wird der Status der Instanz als Sanduhr angezeigt. Wenn die Monitorbedingung erfüllt ist, wird die Ausführung der Instanz mit den nachfolgenden Aktivitäten fortgesetzt und anschließend der Abschlussstatus angezeigt. Danach wird vom Runbook eine neue Instanz erstellt, die ebenfalls ausgeführt wird, bis die Monitorbedingung erfüllt ist.

Arbeitsbereich „Runbook-Server“

Im Arbeitsbereich Runbook-Server können Sie den Status aktueller und abgeschlossener Aufträge und Instanzen für jeden Runbook-Server anzeigen.

Aufträge

Auf der Registerkarte Aufträge werden die auf dem Runbook-Server ausgeführten Aufträge und ihr Abschlussstatus aufgeführt. Ein Auftrag ist eine Anforderung an einen Runbook-Server zur Ausführung eines Runbooks. Er wird bei jeder Anforderung zur Ausführung an ein Runbook erstellt. Wenn ein Runbook mit einem Monitor gestartet wird, wird ein Auftrag erstellt, der bis zur Beendigung des Runbooks fortlaufend ausgeführt wird. In diesem Fall zeigt die status des Auftrags eine Sanduhr an, was bedeutet, dass sie derzeit ausgeführt wird.

Instanzen

Auf der Registerkarte Instanzen werden die auf dem Runbook-Server erstellten Instanzen und ihr Abschlussstatus aufgeführt. Ein instance ist eine ausgeführte Kopie eines Runbooks und wird jedes Mal erstellt, wenn das Runbook ausgeführt wird. Wenn ein Runbook mit einem Monitor gestartet wird, wird eine Instanz erstellt, die so lange ausgeführt wird, bis die Monitorbedingung erfüllt ist. In diesem Fall wird der Status der Instanz als Sanduhr angezeigt. Wenn die Monitorbedingung erfüllt ist, wird die Ausführung der Instanz mit den nachfolgenden Aktivitäten fortgesetzt und anschließend der Abschlussstatus angezeigt. Danach wird vom Runbook eine neue Instanz erstellt, die ebenfalls ausgeführt wird, bis die Monitorbedingung erfüllt ist.

Arbeitsbereich „Ereignisse“

Im Arbeitsbereich Ereignisse können Sie Protokollereignisse anzeigen. Standardmäßig schließen Protokollereignisse alle Ereignisse für den Management-Server und sämtliche Runbook-Server ein. Um die Ereignisse einzuschränken, wählen Sie Filtern aus, und geben Sie Kriterien an, um die angezeigten Ereignisse einzuschränken. Wenn sich ein Ereignis auf einen bestimmten Runbook-Server bezieht, wird der Name des Servers im Feld Quelle angegeben. In diesem Fall können Sie das Ereignis auswählen und dann runbook Server anzeigen im Bereich Aktionen auswählen. Wenn Sie Runbook-Server anzeigen auswählen , wird die Registerkarte Aufträge im Arbeitsbereich Runbookserver für diesen Runbookserver geöffnet.

Starten der Orchestrierungskonsole in einem Browser

  1. Öffnen Sie Ihren Browser.

  2. Geben Sie in der Adressleiste ein http://computer name/:port number , 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. Dies ist standardmäßig Port 82.

Starten Sie die Orchestrierungskonsole im Runbook-Designer

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

Hinweis

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

Festlegen der URL der Orchestrierungskonsole im Runbook-Designer

  1. Wählen Sie Optionenund dann Orchestration Consoleaus.

  2. Geben Sie http://computer name:port number in das Feld URL 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. Dies ist standardmäßig Port 82.

  3. Wählen Sie Fertig stellen aus.

Starten und Beenden von Runbooks

Zusätzlich zum Anzeigen des aktuellen Status eines Runbooks können Sie über die Orchestration-Konsole auch ein Runbook starten oder beenden. Wenn Sie ein Runbook starten, wird ein Auftrag erstellt und in eine Warteschlange eingereiht, bis das Runbook von einem verfügbaren Runbook-Server verarbeitet werden kann. Wenn die erste Aktion in einem Runbook ein Monitor ist, wird der Auftrag fortlaufend ausgeführt, und es werden eventuell mehrere Instanzen eines Runbooks erzeugt, bis das Runbook oder der Auftrag beendet wird. Ist ein Runbook-Server verfügbar, wird von dem Auftrag eine Instanz des Runbooks auf dem Runbook-Server zur Verarbeitung bereitgestellt. Mit einem aktiven Runbook sind mindestens ein Auftrag und eine oder mehrere Instanzen verbunden.

Wenn Sie ein Runbook beenden, werden das Runbook, alle Aufträge und alle dem Runbook zugeordneten Instanzen beendet.

Wählen Sie die erforderliche Registerkarte für die Schritte zum Starten, Beenden oder Anzeigen der status eines Runbooks aus:

Führen Sie die folgenden Schritte aus, um ein Runbook zu starten:

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

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

  3. Klicken Sie im Ergebnisbereich auf die Registerkarte Runbooks .

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

  5. Wenn das Runbook Parameter erfordert, werden diese im Bereich Runbookparameter aufgeführt. Wählen Sie die Spalte Wert für jedes Runbook aus, 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 im Bereich Verfügbare Runbookserver einen Server aus, und klicken Sie dann auf den Pfeil nach rechts, um den Server dem Bereich Ausgewählte Runbookserver hinzuzufügen.

    Hinweis

    Wenn Sie dem Bereich Ausgewählte Runbookserver mehrere Server hinzufügen, wird das Runbook nur auf dem ersten Server ausgeführt, wenn es verfügbar ist. Die anderen Server sind Sicherungsserver, auf denen das Runbook nur ausgeführt wird, wenn der primäre Server nicht verfügbar ist.

  7. Wählen Sie Starten aus.

Beenden von Aufträgen

Ein Auftrag ist eine Anforderung zur Ausführung eines Runbooks. Ein Auftrag wird nur dann erstellt, wenn Sie die Ausführung eines Runbooks anfordern. Wenn die erste Aktion in einem Runbook ein Monitor ist, wird der Auftrag fortlaufend ausgeführt, bis das Runbook oder der Auftrag beendet wird. Eine Sanduhr gibt den Status eines ausgeführten Auftrags an. Eine Instanz ist eine ausgeführte Kopie eines Runbooks.

Sie können einen Auftrag nicht starten. Sie können nur ein Runbook starten.

Wenn Sie eine Instanz anzeigen, können Sie den zugehörigen Auftrag beenden. Durch das Beenden des Auftrags wird die Instanz, der Auftrag und alle zugehörigen Instanzen sowie das Runbook beendet.

Nächste Schritte

Weitere Informationen zum Bereitstellen von Runbooks finden Sie unter Bereitstellen von Runbooks.