Workiva Support Center

Folgen Sie diesen Anweisungen, um die GroundRunner- und GroundRunnerMonitor-Binärdateien auf einem Host-Rechner durch eine neuere Version zu ersetzen.

Wichtige Planungshinweise

• Der GroundRunner Dienst unterstützt kein ordnungsgemäßes Herunterfahren. Wenn der Dienst angehalten wird, werden alle laufenden Operationen sofort beendet. Die Ergebnisse dieser Operationen gehen verloren und die Befehle müssen erneut ausgeführt werden.
• Da das Anhalten des Dienstes eine Unterbrechung darstellt, empfehlen wir dringend, vor der Aktualisierung ein Zeitfenster für die Bereitstellung mit den Beteiligten abzustimmen und sicherzustellen, dass während des Wartungszeitraums keine kritischen Aufträge ausgeführt werden oder geplant sind.

Voraussetzungen (alle Plattformen)

• Prüfen Sie, ob Sie eine Aktualisierung benötigen. Die aktuelle Version (Stand: 1. Juni 2026) ist 9.21.1.
  Siehe Wie überprüfe ich die Version eines GroundRunners? um zu erfahren, welche GroundRunner Version Sie verwenden.
  Wenn Ihr GroundRunner nicht mehr aktuell ist, wird das folgende Banner angezeigt.
• Wenn Ihr GroundRunner nicht mehr aktuell ist, notieren Sie die Versionsnummer, die im Feld Version angezeigt wird.

Für Windows-Plattformen

• Die Windows GroundRunner.zip, die von Workiva bezogen wird.
  (Weitere Informationen finden Sie unter GroundRunners installieren und verwalten.)
• Administratorberechtigungen für beide:
  • Der Rechner, auf dem der GroundRunner installiert ist.
  • Das Verzeichnis, in dem die Binärdateien installiert sind. 
• Berechtigung zum Stoppen und Starten des GroundRunner Dienstes.

Für Linux-Plattformen

• Die Windows GroundRunner.zip, die von Workiva bezogen wird.
  (Weitere Informationen finden Sie unter GroundRunners installieren und verwalten.)
• Die Linux-Dienstprogramme unzip(1), tar(1) und gzip(1) müssen installiert sein (diese sind bei den meisten Installationen Standard).
• Berechtigungen zum Besitz von Dateien (chown).
• Administratorberechtigungen für beide:
  • Der Rechner, auf dem der GroundRunner installiert ist.
  • Das Verzeichnis, in dem die Binärdateien installiert sind. 
• Berechtigung zum Stoppen und Starten des GroundRunner Dienstes.

Windows-Installation

1. Entpacken Sie GroundRunner.zip in ein temporäres Verzeichnis.
2. Öffnen Sie die Dienste-Konsole: Drücken Sie Win + R, geben Sie services.msc ein, und drücken Sie Enter.
3. Suchen Sie GroundRunner in der Liste, klicken Sie mit der rechten Maustaste darauf, und wählen Sie Stop. 
4. Warten Sie, bis der Status Stopped anzeigt.
5. Sichern Sie die vorhandenen Binärdateien.
   Navigieren Sie im Datei-Explorer zum GroundRunner-Installationsverzeichnis und kopieren Sie GroundRunner.exe und GroundRunnerMonitor.exe und alle Konfigurationsdateien an einen Sicherungsort (z.B. benennen Sie sie um in GroundRunner.exe.bak und GroundRunnerMonitor.exe.bak).
6. Ersetzen Sie die Binärdateien, indem Sie GroundRunner.exe und GroundRunnerMonitor.exe aus dem extrahierten Verzeichnis in das Installationsverzeichnis kopieren und die vorhandenen Dateien überschreiben.
7. Zurück in der Dienste-Konsole, klicken Sie mit der rechten Maustaste auf GroundRunner und wählen Sie Start. 
8. Überprüfen Sie, ob der Status Running anzeigt.

Linux (systemd) Installation

Diese Anweisungen gelten für normale, nicht sicherheitserweiterte Linux-Systeme. Wenn auf Ihrem Host SELinux, AppArmor oder eine andere Sicherheitssoftware läuft, lesen Sie Mandatory Access Control (SELinux / AppArmor) am Ende dieses Abschnitts.

1. Entpacken Sie die Artefakte in der Zip-Datei.

   Hinweis: Das Entpacken der Zip-Datei nach /tmp/groundrunner-update dient nur als Beispiel. Sie können die ZIP-Datei entpacken, wo immer dies am besten mit den Richtlinien Ihrer Organisation vereinbar ist.

   unzip GroundRunner.zip -d /tmp/groundrunner-update

2. Stoppen Sie den laufenden Prozess. Wenn Sie systemd verwenden, benutzen Sie diesen Befehl:

   sudo systemctl stop <service-name>

   WICHTIGER HINWEIS: Wenn Sie nicht Ihren GroundRunner als systemd-Dienst konfiguriert haben, richten Sie ihn bitte als systemd-Dienst ein, bevor Sie das Update durchführen. Die Dokumentation zur Konfiguration eines systemd-Dienstes finden Sie in der Dokumentation Ihrer Linux-Distribution. Wenn Sie eine Linux-Distribution ohne systemd verwenden, konsultieren Sie bitte die Dokumentation Ihrer Distribution.

3. Sichern Sie die Binärdateien und Konfigurationen im GroundRunner Verzeichnis:

   cd /Pfad_zum_groundrunner_install_dir tar czvf groundrunner.bak.tar.gz GroundRunner* *config config* monitor.version

   Hinweis: Sie können gerne das gesamte Installationsverzeichnis sichern (d.h. einschließlich der Protokolle und anderer Ordner/Dateien), aber das kann eine extrem große Sicherungsdatei erzeugen.

4. Ersetzen Sie die Binärdateien:

   cd /pfad_zu_groundrunner_install_dir cp /tmp/groundrunner-update/GroundRunner . cp /tmp/groundrunner-update/GroundRunnerMonitor .

5. Berechtigungen für ausführbare Dateien festlegen:

   chmod +x GroundRunner GroundRunnerMonitor

   Hinweis: Wenn Ihr GroundRunner von einem bestimmten Systembenutzer ausgeführt wird, müssen Sie möglicherweise chown die neuen ausführbaren Dateien.

6. Starten Sie den Dienst:

   sudo systemctl start <Dienst-Name&gt

7. Überprüfen Sie den Status des Dienstes, um sicherzustellen, dass er in Ordnung ist:

   sudo systemctl status <Dienst-Name&gt

8. Aufräumen:

   rm -rf /tmp/groundrunner-update

Obligatorische Zugriffskontrolle (SELinux / AppArmor)

Wenn der Host eine obligatorische Zugriffskontrollpolitik (SELinux, AppArmor oder ähnliches) durchsetzt, kann das Ersetzen von Binärdateien auf der Festplatte zum Ausfall des Dienstes führen. 

Lesen Sie in der Dokumentation Ihrer Distribution nach, wie Sie Sicherheitsrichtlinien für benutzerdefinierte Dienste verwalten.

Hinweis: Andere Sicherheitssoftware - wie FAPOLICYD, IMA/EVM oder eine benutzerdefinierte Überwachung der Dateiintegrität - kann ebenfalls die Ausführung von ersetzten Binärdateien blockieren. Wenn der Dienst nach einer Aktualisierung nicht startet und Sie SELinux/AppArmor ausgeschlossen haben, prüfen Sie, ob zusätzliche Sicherheits-Frameworks auf Ihrem System aktualisierte Vertrauenslisten oder Dateisignaturen erfordern.

Überprüfung

Sie können sich vergewissern, dass der GroundRunner aktiv ist und seine Version korrekt ist, indem Sie die Anweisungen unter befolgen. Wie überprüfe ich den Status eines GroundRunners?

Wir empfehlen Ihnen, eine "Pilotkette" zu erstellen und auszuführen, die einen Testsatz von Befehlen auf dem GroundRunner ausführt, um eine ordnungsgemäße Installation sicherzustellen. 

Wir empfehlen Ihnen auch, Ihr System und die Aktivität des GroundRunners unmittelbar nach der Aktualisierung und dem Neustart zu überwachen. Auf diese Weise können Sie sicher sein, dass das System ordnungsgemäß funktioniert. Sie können dies mit einem CLI-Befehl tun, um neue Protokolleinträge zu streamen und anzuzeigen, sobald sie auftreten.

Für Windows

Um das Ende der Protokolldatei mit PowerShell anzuzeigen, geben Sie Folgendes ein:

Get-Content -Path "C:\path_to_\output.log" -Tail 10 -Wait

Dadurch bleibt das PowerShell-Fenster geöffnet und streamt neue Protokolleinträge in Echtzeit. -tail 10 lädt sofort die letzten 10 Zeilen.

Für Linux

Um das Ende der Protokolldatei anzuzeigen und neue Einträge in Echtzeit zu streamen, geben Sie Folgendes ein:

tail -f /Pfad_nach/output.log

Rollback

Wenn die neue Version nicht richtig funktioniert, können Sie mit den folgenden Schritten zur vorherigen Version zurückkehren:

1. Beenden Sie den GroundRunner Dienst wie oben beschrieben.
2. Benennen Sie die installierten Dateien GroundRunner.exe und GroundRunnerMonitor.exe um.
3. Kopieren Sie GroundRunner.exe.bak und GroundRunnerMonitor.exe.bak vom Sicherungsort in das Installationsverzeichnis. 
4. Benennen Sie diese Dateien um, indem Sie die Erweiterung ".bak" entfernen.
5. Starten Sie den GroundRunner Dienst neu, indem Sie die oben beschriebenen Schritte durchführen.

Hinweis: Diese Anweisungen gelten auch für Linux GroundRunner, aber Sie müssen die Binärdateien aus dem Backup-Tarball extrahieren.

Hinweise

• Benennen Sie die Binärdateien nicht um. Der Auto-Upgrade-Mechanismus stützt sich auf die Standardnamen der ausführbaren Dateien (GroundRunner und GroundRunnerMonitor unter Linux sowie GroundRunner.exe und GroundRunnerMonitor.exe unter Windows), um zukünftige Updates zu erkennen und anzuwenden. Wenn Sie sie umbenennen, werden die automatischen Aktualisierungen unterbrochen.
• macOS wird nur für Entwicklungszwecke unterstützt. Es handelt sich nicht um eine unterstützte Produktionsplattform.
• Andere Dienstmanager: Die obigen Beispiele verwenden systemd (Linux) und den Windows Service Control Manager. Wenn Ihre Umgebung einen anderen Dienstmanager oder Prozess-Supervisor verwendet, führen Sie die entsprechenden Schritte zum Anhalten, Ersetzen und Starten für Ihre Konfiguration aus.
• Standardmäßig verwenden GroundRunner ein lokales Administratorkonto ohne Zugriff auf Remote-Ressourcen wie freigegebene Laufwerke. Um auf eine gemeinsam genutzte Ressource wie z.B. einen Windows UNC Pfad zuzugreifen, starten Sie den GroundRunner unter einem Benutzerkonto mit entsprechenden Rechten auf die Ressource. Wenn Sie ein anderes Benutzerkonto als den standardmäßigen lokalen Systemadministrator verwenden, erteilen Sie ihm die Berechtigung, das GroundRunner-Installationsverzeichnis zu verwalten, um automatische Updates zu ermöglichen.