GroundRunners ermöglichen die Interaktion von Kettenbefehlen mit Systemen vor Ort oder mit entfernten Datenquellen, die sonst nicht über das Internet zugänglich sind. Sie werden in der Regel von einem IT-Fachmann oder einer anderen Person, die mit den Netzwerkeinstellungen Ihres Unternehmens vertraut ist, auf einem dedizierten Server installiert, z. B. dem Server, auf dem Ihre verbundene Datenquelle gehostet wird.
Bevor Sie einen GroundRunner einrichten, empfehlen wir Ihnen, die Sicherheitsarchitektur des Chain Builderszu lesen.
Anforderungen
Ein kompatibles Betriebssystem ist erforderlich, und wenn der GroundRunner auf gemeinsam genutzte Ressourcen zugreift, wie z.B. einen Windows Universal Naming Convention (UNC) Pfad, dann ist auch ein Benutzerkonto mit ausreichenden Rechten erforderlich.
Die Java-Laufzeitumgebung (JRE) ist unter der GPL v2 lizenziert, unterliegt aber der classpath exception.
Hinweis: Um benutzerdefinierte Zertifikate mit Ihrer Java-Installation zu verwenden oder einfach die gemeinsam genutzten Bibliotheken von Workiva nicht zu verwenden, lesen Sie unseren Artikel Benutzerdefinierte Zertifikate mit GroundRunners verwenden .
Den GroundRunner herunterladen
So laden Sie einen GroundRunner zur Installation oder manuellen Aktualisierung herunter:
- Wählen Sie im Chain Builder Einstellungen
in der Seitenleiste. - Klicken Sie oben auf Downloads .
- Suchen Sie den GroundRunner für Ihr Betriebssystem, und klicken Sie auf Download auf der rechten Seite.
Installieren Sie den GroundRunner
Der Microsoft Installer (MSI) erfordert .NET 3.5 oder höher. Wenn Sie diese Anforderung nicht erfüllen können, installieren Sie den GroundRunner stattdessen über die Befehlszeilenschnittstelle.
So installieren Sie den GroundRunner:
- Entpacken Sie die Datei windows_amd64_ground_runner.zip .
- Führen Sie GroundRunner.msi aus, um den GroundRunner Setup Wizard zu starten.
- Klicken Sie auf Weiter.
- Lesen und akzeptieren Sie die Bedingungen der Lizenzvereinbarung und klicken Sie auf Weiter.
- Geben Sie als Zielordner den Pfad ein, in dem der GroundRunner installiert werden soll (z. B.
C:\Programme\GroundRunner\
) und klicken Sie auf Weiter.
- Geben Sie in Platform company token, Ihren company tokenein.
- Unter Platform auth host:
- In Nordamerika geben Sie bitte
h.app.wdesk.com/s/wdata/oc/app ein
- Wenn Sie in Europa sind, geben Sie
h.eu.wdesk.com/s/wdata/oc/app ein
- In APAC geben Sie bitte
h.apac.wdesk.com/s/wdata/oc/app ein
- In Nordamerika geben Sie bitte
- Wenn Sie einen Proxy-Server verwenden, geben Sie dessen URL und Port unter Proxy-Hostein. (Zum Beispiel: http://yourproxy:3000.)
- Um den Proxyserver zu umgehen, geben Sie unter No proxy host eine durch Kommata getrennte Liste von Hosts ein.
- Klicken Sie auf Weiter, Installieren, und Fertigstellen.
- Nach der Installation klicken Sie im Windows Service Manager mit der rechten Maustaste auf den GroundRunner und wählen Start.
Ihr GroundRunner wurde nun installiert und ist bereit für die Aktivierung.
Für die Installation über die Befehlszeilenschnittstelle müssen Sie die GroundRunner-Installation in ein eigenes Verzeichnis innerhalb Ihrer Programmdateien herunterladen (z. B. c:\Programme (x86)\wdata
). Sie können dann die Installationsdatei entpacken und in das Stammverzeichnis extrahieren.
Sie können dann den GroundRunner :
- Führen Sie über die Windows-Befehlszeilenschnittstelle den Befehl
c:\Programme (x86)\wdata\installer.exe install
aus und akzeptieren Sie alle Standardeinstellungen.- Für den Pfad erstellen Sie einen Ordner Files innerhalb des neuen Verzeichnisses (z. B.
C:\Program Files (x86)\Wdata\Files
). - Für den Autorisierungs-Hostnamen (AUTH_HOST):
- In Nordamerika geben Sie bitte
h.app.wdesk.com/s/wdata/oc/app ein
- Wenn Sie in Europa sind, geben Sie
h.eu.wdesk.com/s/wdata/oc/app ein
- In APAC geben Sie bitte
h.apac.wdesk.com/s/wdata/oc/app ein
- In Nordamerika geben Sie bitte
- Geben Sie Ihren Firmen-Tokenein.
- Für den Pfad erstellen Sie einen Ordner Files innerhalb des neuen Verzeichnisses (z. B.
- Löschen Sie alle Dateien aus dem Verzeichnis, mit Ausnahme des Verzeichnisses für die GroundRunner Software.
- Wählen Sie aus, ob der GroundRunner als Dienst oder als Vordergrundprozess laufen soll.
- Wenn Sie als Dienst ausgeführt werden, führen Sie einen der folgenden Schritte aus:
- Geben Sie in der CLI den Befehl
sc start GroundRunner ein
- Starten Sie im Windows Service Manager den Dienst HostRunner
- Geben Sie in der CLI den Befehl
- Wenn Sie als Vordergrundprozess ausgeführt werden, geben Sie die folgenden Befehle in die CLI ein:
cd c:\Program Files (x86)\wdata GroundRunner.exe
- Wenn Sie als Dienst ausgeführt werden, führen Sie einen der folgenden Schritte aus:
Schritt 1. Installieren Sie den GroundRunner
- Laden Sie die GroundRunner Installationsdatei in ein eigenes Verzeichnis herunter, z.B.
/home/<Benutzername>/wdata/
. - Entpacken Sie die Installationsdatei in einer CLI:
- Unter Linux verwenden Sie den Befehl
unzip linux_amd64_ground_runner.zip
- Unter macOS verwenden Sie den Befehl
unzip GroundRunner.zip
- Unter Linux verwenden Sie den Befehl
- Geben Sie die Angaben zum GroundRunner ein.
- Sowohl für Linux als auch für Mac OS verwenden Sie den Befehl
<!--sudo -->./installer install
- Für den Autorisierungs-Hostnamen (AUTH_HOST):
- In Nordamerika geben Sie bitte
h.app.wdesk.com/s/wdata/oc/app ein
- Wenn Sie in Europa sind, geben Sie
h.eu.wdesk.com/s/wdata/oc/app ein
- In APAC geben Sie bitte
h.apac.wdesk.com/s/wdata/oc/app ein
- In Nordamerika geben Sie bitte
- Geben Sie Ihren Firmen-Tokenein.
- Sowohl für Linux als auch für Mac OS verwenden Sie den Befehl
- Löschen Sie alle Dateien aus dem Verzeichnis mit Ausnahme des ausführbaren Verzeichnisses GroundRunner .
Schritt 2. Wählen Sie aus, ob der Prozess als Dienst oder im Vordergrund laufen soll
Geben Sie in der CLI die folgenden Befehle ein, um den GroundRunner entweder als Hintergrunddienst oder als Vordergrundprozess auszuführen.
Hintergrunddienst
Wenn es über das Standard-Init-Programm des Betriebssystems ausgeführt wird, können Sie es als Hintergrunddienst laufen lassen:
/home/[Benutzername]/wdata/Inhalt/GroundRunnerMonitor
Prozess im Vordergrund
Um es als Vordergrundprozess laufen zu lassen, wobei die Protokolle in die Konsole geschrieben werden:
cd home/[Benutzername]/wdata/Contents sudo ./GroundRunner
Um ihn als Vordergrundprozess laufen zu lassen und die Protokolle in die Logdatei zu schreiben:
cd home/[Nutzername]/wdata/Inhalte sudo ./GroundRunnerMonitor
Aktivieren Sie den GroundRunner
Nachdem Sie Ihren GroundRunner installiert haben, müssen Sie ihn im Chain Builder aktivieren.
- Wählen Sie im Chain Builder Einstellungen
in der Seitenleiste. - Klicken Sie oben auf Läufer .
- Geben Sie unter Pending Registrationeinen kurzen, beschreibenden Namen für den Läufer ein (z. B. <datasource>-GroundRunner).
- Klicken Sie auf Aktivieren Sie.
Manuelle Aktualisierung eines GroundRunners
Es kann vorkommen, dass Sie einen GroundRunner manuell aktualisieren müssen.
Laden Sie die neueste MSI herunter und installieren Sie sie, und deinstallieren Sie alle zuvor heruntergeladenen Versionen.
- Laden Sie den neuesten GroundRunner für Ihr Betriebssystem herunter.
- Im Windows-Dienste-Manager stoppen Sie den GroundRunner-Dienst.
- Verschieben Sie die heruntergeladene GroundRunner-Installationsdatei in ihr eigenes Verzeichnis - z.B.
c:\groundrunner_upgrade
- und entpacken Sie die Dateien. - Kopieren Sie GroundRunner.exe und GroundRunnerMonitor.exe und fügen Sie sie in das Verzeichnis ein, in dem die GroundRunner-Binärdateien installiert sind.
- Starten Sie im Windows Dienste-Manager den GroundRunner Dienstneu.
- Laden Sie den neuesten GroundRunner für Ihr Betriebssystem herunter.
- Auf dem Server, der den GroundRunner hostet, wechseln Sie in das Verzeichnis, in dem der Dienst läuft.
- In einer CLI, stoppen Sie den GroundRunner Dienst.
- Verschieben Sie die heruntergeladene GroundRunner-Installationsdatei in ihr eigenes Verzeichnis - z.B.
/home/<Benutzername>/groundrunner_upgrade/
- und entpacken Sie die Dateien. - Kopieren Sie GroundRunner.exe und GroundRunnerMonitor.exe und fügen Sie sie in das Verzeichnis ein, in dem die GroundRunner-Binärdateien installiert sind.
- Um den GroundRunner Dienst neu zu starten, geben Sie folgende Befehle in die CLI ein:
cd /home/<Benutzername>/wdata/Contents
./GroundRunner
GroundRunner deinstallieren
Wenn Sie einen GroundRunner nicht mehr benötigen, können Sie ihn deinstallieren.
- Stoppen Sie den GroundRunner Dienst.
- Wenn das Programm als Dienst läuft, verwenden Sie den Windows Service Manager oder geben Sie den Befehl
sc stop GroundRunner
in der CLI ein. - Wenn Sie als Vordergrundprozess laufen, drücken Sie die Tastenfolge <ctrl> <c>.
- Wenn das Programm als Dienst läuft, verwenden Sie den Windows Service Manager oder geben Sie den Befehl
- Geben Sie in der CLI als Administrator den Befehl
installer.exe uninstall
ein. - Löschen Sie das ausführbare Verzeichnis
GroundRunner
.
Stoppen Sie in der CLI den GroundRunner-Dienst und löschen Sie sein ausführbares Verzeichnis (z.B. /home/<Benutzername>/wdata/Contents
).
GroundRunner Konfigurationseinstellungen und Outbound-Domains
Um die Kommunikation mit der Datenquelle zu ermöglichen, müssen Sie eventuell Firewall-Ports auf dem Server öffnen, auf dem der GroundRunner installiert ist. Um die Konfigurationseinstellungen einiger GroundRunner zu ändern, können Sie die Datei GroundRunner.config in dem Verzeichnis bearbeiten, in dem die Binärdateien installiert sind.
Konfiguration | Einstellungen |
---|---|
PORT |
0 bis 65535. Standardmäßig verwenden die GroundRunner den Port 8821 , um miteinander zu kommunizieren. Ein Port ist jedoch nur dann erforderlich, wenn GroundRunner auf verschiedenen Servern innerhalb Ihres Netzwerks Befehlsausgaben gemeinsam nutzen. |
FIRMEN_TOKEN | Belassen Sie es bei der Standardeinstellung, es sei denn, der GroundRunner ist für einen anderen Mieter konfiguriert. |
LOG_LEVEL | Info oder debug |
PROTOKOLL | Als Standard belassen. |
HTTP_PROXY_URL |
Wenn Sie einen Proxyserver verwenden, geben Sie dessen URL und Port ein (falls erforderlich). Zum Beispiel: Hinweis: GroundRunners kann Proxyserver verwenden, jedoch nicht solche, die über New Technology LAN Manager (NTLM) authentifiziert sind. Lassen Sie stattdessen die IP-Adresse des Servers zu. |
LONG_POLL | Wenn Sie einen Proxy-Server verwenden, setzen Sie diesen auf true, um den Runner anzuweisen, Long-Polling zum Abrufen von Befehlen zu verwenden. Um die Leistung zu gewährleisten, sollten Sie Long-Polling nur verwenden, wenn Web-Sockets von Ihrem Proxy-Server oder Ihrer Firewall nicht unterstützt werden. |
NO_PROXY | Um den Proxyserver zu umgehen, geben Sie eine durch Kommata getrennte Liste von Hosts an, die Sie stattdessen direkt erreichen möchten. Um mehrere Hosts nach einem gemeinsamen Muster einzuschließen, verwenden Sie den Platzhalter * . |
GROUNDRUNNER_CERT |
Wird benötigt, wenn mehr als ein GroundRunner verwendet wird und verschlüsselte Informationen an den zweiten GroundRunner gesendet werden sollen.Muss in Verbindung mit PORTverwendet werden. Sie müssen auch das Feld PROTOCOL als HTTPS angeben, wenn Sie den Runner aktivieren. |
GROUNDRUNNER_CERT_KEY | Wird benötigt, wenn mehr als ein GroundRunner verwendet wird und verschlüsselte Informationen von einem zweiten GroundRunner empfangen werden sollen.Muss auch in Verbindung mit PORTverwendet werden. |
Hinweis: Ihr selbstsigniertes Zertifikat muss einen Subject Alternative Name (SAN) haben. Wenn dies nicht der Fall ist, zeigt der GroundRunner beim Herunterladen von Dateien eine Fehlermeldung an, die auf das fehlende SAN hinweist.
Wenn Ihr Netzwerk ausgehende Domänen zulassen muss, gelten diese für GroundRunners:
Bereich | Zweck |
---|---|
|
Die wichtigsten Subdomains für die gängigen Workiva-Dienste, einschließlich Wdata. |
*.wdesk.com |
Die Hauptdomäne für die Produktionsplattform Workiva. |
*.*.wdesk.com |
Die Subdomänen für die unterstützenden Komponenten der Workiva-Plattform. |
Wertpapier
GroundRunners sammelt oder aggregiert niemals Daten, sondern speichert diese nur während der Übertragung. Ein Extended Validation (EV)-Zertifikat verschlüsselt und schützt immer den Datenverkehr zwischen einem GroundRunner und seiner Datenquelle über DigiCert®.
Hinweis: Um Daten vor Ort zu sichern, können CloudRunner Ausgaben mit GroundRunnern teilen, aber GroundRunner können keine Dateiausgaben mit CloudRunner teilen.
Behebung von GroundRunner Fehlern
Wenn Sie diese Fehler bei der Ausführung einer Kette erhalten, überprüfen Sie die GroundRunners des Befehls.
Tipp: Um die Fehlersuche zu erleichtern, können Sie eine Kette erstellen, um automatisch die Protokolldatei eines GroundRunners in eine Tabelle herunterzuladen.
Fehlermeldung | Ursache | Auflösung |
---|---|---|
Kommunikation mit Agent fehlgeschlagen - dieser Befehl wurde nicht ausgeführt |
Der Befehl konnte nicht mit seinem GroundRunner kommunizieren. In diesem Fall ist der GroundRunner nicht gestartet oder es ist eine Netzwerkunterbrechung zwischen dem GroundRunner und dem Chain Builder aufgetreten. |
Überprüfen:
|
Die mit dem Befehl verbundenen Ressourcen können nicht heruntergeladen werden. Bitte kontaktieren Sie den Support, wenn der Fehler weiterhin besteht. |
Die mit diesen Kettenbefehlen verbundenen Läufer können nicht miteinander kommunizieren. Dies tritt häufig auf, wenn Befehle verschiedene Runner verwenden und der CloudRunner versucht, eine Datei zu verwenden, die von einem GroundRunner-basierten Befehl ausgegeben wurde. |
Verwenden Sie für alle Befehle in der Kette denselben Läufer. Wenn die Befehle der Kette mehrere Runner erfordern, vergewissern Sie sich, dass keine Befehle mit GroundRunner Dateiausgaben an Befehle weitergeben, die den CloudRunner verwenden. |
Fehler beim Starten des Befehls: exec: "\[connector].exe\": Datei nicht vorhanden" commandExecutorId=[ID] | Eine Malware- oder Antiviren-Anwendung hat den Connector fälschlicherweise identifiziert und seine Kommunikation mit dem GroundRunner abgefangen. | Schließen Sie das GroundRunner Installationsverzeichnis von den Scans der Anwendung aus. |
Zertifikat-Fehler | Verwendung von selbstsignierten Zertifikaten |
In vielen Fällen wird es sinnvoll sein, selbstsignierte Zertifikate zur Verschlüsselung der GroundRunner Kommunikation zu verwenden. Wenn Sie ein selbstsigniertes Zertifikat verwenden, stellen Sie sicher, dass der Common Name des Zertifikats mit der URL übereinstimmt, unter der der Server erreichbar ist. Wenn Ihr GroundRunner beispielsweise auf Port 8821 lauscht und Sie von Ihrem Netzwerk aus auf den Server zugreifen können localhost, würde der Common Name des Zertifikats localhostlauten. |
Intermittierender Kettenausfall mit Fehler: "Connection reset by peer" |
Wenn mehrere Runner auf demselben Rechner installiert sind, muss jeder von ihnen eine eindeutige GUID haben. Wenn dieselbe GUID verwendet wird, können sich die Runner überschneiden und in eine Aktualisierungsschleife geraten, was zu gelegentlichen Kettenfehlern führt. |
Wir empfehlen eine komplette Neuinstallation des GroundRunner.
|