Workiva-ondersteuningscentrum

Volg deze instructies om de binaire bestanden van GroundRunner en GroundRunnerMonitor op een hostmachine te vervangen door een nieuwere versie.

Belangrijke planningsnotities

• De GroundRunner-service ondersteunt geen gecontroleerde afsluiting. Wanneer de dienstverlening wordt stopgezet, worden alle lopende activiteiten aan boord onmiddellijk beëindigd. De resultaten van deze bewerkingen gaan verloren en de opdrachten moeten opnieuw worden uitgevoerd.
• Omdat het stopzetten van de service storend is, raden we ten zeerste aan om vóór het uitvoeren van de update een implementatieperiode af te stemmen met uw belanghebbenden en ervoor te zorgen dat er geen kritieke taken actief zijn of gepland staan ​​tijdens de onderhoudsperiode.

Voorwaarden (alle platforms)

• Controleer of u een update nodig heeft. De huidige versie (vanaf 1 juni 2026) is 9.21.1.
  Zie Hoe controleer ik de versie van GroundRunner? om te zien welke GroundRunner-versie u gebruikt.
  Als uw GroundRunner-versie verouderd is, wordt de volgende banner weergegeven.
• Als uw GroundRunner verouderd is, noteer dan het versienummer dat wordt weergegeven in het veld Versie.

Voor Windows-platformen

• Het Windows GroundRunner.zipbestand is afkomstig van Workiva.
  (Zie GroundRunners installeren en beheren voor meer informatie.)
• Beheerdersrechten voor beide:
  • De machine waarop de GroundRunner is geïnstalleerd.
  • De map waarin de binaire bestanden zijn geïnstalleerd. 
• Toestemming om de GroundRunner-service te stoppen en te starten.

Voor Linux-platforms

• Het Windows GroundRunner.zipbestand is afkomstig van Workiva.
  (Zie GroundRunners installeren en beheren voor meer informatie.)
• De Linux-hulpprogramma's unzip(1), tar(1), engzip(1) moeten geïnstalleerd zijn (deze zijn standaard in de meeste installaties).
• Bestandseigendomsrechten (chown).
• Beheerdersrechten voor beide:
  • De machine waarop de GroundRunner is geïnstalleerd.
  • De map waarin de binaire bestanden zijn geïnstalleerd. 
• Toestemming om de GroundRunner-service te stoppen en te starten.

Windows-installatie

1. Pak het bestand GroundRunner.zip uit naar een tijdelijke map.
2. Open de Services-console: druk op Win + R, typ services.mscen druk op Enter.
3. Zoek GroundRunner in de lijst, klik er met de rechtermuisknop op en selecteer Stop. 
4. Wacht tot de status Gestoptweergeeft.
5. Maak een back-up van de bestaande binaire bestanden.
   Ga in Bestandsverkenner naar de installatiemap van GroundRunner en kopieer GroundRunner.exe en GroundRunnerMonitor.exe en alle configuratiebestanden naar een back-uplocatie (hernoem ze bijvoorbeeld naar GroundRunner.exe.bak en GroundRunnerMonitor.exe.bak).
6. Vervang de binaire bestanden door GroundRunner.exe en GroundRunnerMonitor.exe vanuit de uitgepakte map naar de installatiemap te kopiëren en de bestaande bestanden te overschrijven.
7. Ga terug naar de Services-console, klik met de rechtermuisknop op GroundRunner en selecteer Start. 
8. Controleer of de status Runningweergeeft.

Linux (systemd) installatie

Deze instructies zijn bedoeld voor standaard Linux-systemen zonder beveiligingsverbeteringen. Als uw host SELinux, AppArmor of andere beveiligingssoftware gebruikt, raadpleeg dan Verplichte toegangscontrole (SELinux / AppArmor) aan het einde van deze sectie.

1. Pak de bestanden uit het zipbestand.

   Opmerking: Het uitpakken van het zipbestand naar /tmp/groundrunner-update wordt alleen ter illustratie gebruikt. Je kunt het zipbestand uitpakken op een locatie die het beste aansluit bij het beleid van je organisatie.

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

2. Stop het lopende proces. Als je systemd gebruikt, gebruik dan dit commando:

   sudo systemctl stop<service-name>

   BELANGRIJKE OPMERKING: Als je GroundRunner nietals systemd-service hebt geconfigureerd, configureer het dan als systemd-servicevoordat je de update uitvoert. Documentatie over het configureren van een systemd-service is te vinden in de documentatie van uw Linux-distributie. Als u een Linux-distributie gebruikt die geen gebruik maakt van systemd, raadpleeg dan de documentatie van uw distributie.

3. Maak een back-up van de binaire bestanden en configuratiebestanden in de GroundRunner-directory:

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

   Opmerking: U kunt gerust een back-up maken van de volledige installatiemap (inclusief logbestanden en andere mappen/bestanden), maar dit kan een extreem groot back-upbestand opleveren.

4. Vervang de binaire bestanden:

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

5. Stel de uitvoerrechten in:

   chmod +x GroundRunner GroundRunnerMonitor

   Opmerking: Als GroundRunner door een specifieke systeemgebruiker wordt uitgevoerd, moet u mogelijk de eigenaar van de nieuwe uitvoerbare bestanden wijzigen.

6. Start de service:

   sudo systemctl start<service-name>

7. Controleer de status van de service om er zeker van te zijn dat deze goed functioneert:

   sudo systemctl status<service-name>

8. Opruimen:

   rm -rf /tmp/groundrunner-update

Verplichte toegangscontrole (SELinux / AppArmor)

Als de host een verplicht toegangsbeleid hanteert (SELinux, AppArmor of iets dergelijks), kan het vervangen van binaire bestanden op de schijf ervoor zorgen dat de service uitvalt. 

Raadpleeg de documentatie van uw distributie voor meer informatie over het beheren van beveiligingsbeleid rondom aangepaste services.

Opmerking: Andere beveiligingssoftware — zoals FAPOLICYD, IMA/EVM of aangepaste bestandsintegriteitscontrole — kan ook de uitvoering van vervangen binaire bestanden blokkeren. Als de service na een update niet start en je SELinux/AppArmor als oorzaak hebt uitgesloten, controleer dan of er op je systeem nog andere beveiligingsframeworks zijn die bijgewerkte vertrouwenslijsten of bestandshandtekeningen vereisen.

Verificatie

U kunt controleren of de GroundRunner actief is en of de versie correct is door de instructies te volgen in Hoe controleer ik de status van een GroundRunner?

We raden u aan een "proefdraai" te maken en uit te voeren die een reeks testcommando's op de GroundRunner uitvoert om een ​​correcte installatie te garanderen. 

We raden u ook aan om uw systeem en de activiteit van GroundRunner direct na de update en herstart te controleren. Hierdoor kunt u erop vertrouwen dat het naar behoren werkt. Je kunt dit doen met een CLI-opdracht om nieuwe logboekvermeldingen te streamen en te bekijken zodra ze binnenkomen.

Voor Windows

Om het einde van het logbestand met PowerShell te bekijken, voert u het volgende in:

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

Dit houdt het PowerShell-venster open en streamt nieuwe logboekvermeldingen in realtime. -tail 10 laadt de laatste 10 regels direct.

Voor Linux

Om het einde van het logbestand te bekijken en nieuwe vermeldingen in realtime te streamen, voert u het volgende in:

staart -f /pad_naar/uitvoer.log

Terugdraaien

Als de nieuwe versie niet goed werkt, kunt u terugkeren naar de vorige versie door de volgende stappen te volgen:

1. Stop de GroundRunner-service zoals hierboven beschreven.
2. Hernoem de geïnstalleerde bestanden GroundRunner.exe en GroundRunnerMonitor.exe.
3. Kopieer GroundRunner.exe.bak en GroundRunnerMonitor.exe.bak vanuit de back-uplocatie naar de installatiemap. 
4. Hernoem deze bestanden door de extensie ".bak" te verwijderen.
5. Start de GroundRunner-service opnieuw door de bovenstaande stappen te volgen.

Opmerking: Deze instructies gelden ook voor Linux GroundRunners, maar u moet de binaire bestanden uit het back-up tarball-bestand extraheren.

Notities

• Hernoem de binaire bestanden niet. Het automatische upgrademechanisme gebruikt de standaard uitvoerbare bestandsnamen (GroundRunner en GroundRunnerMonitor op Linux, en GroundRunner.exe en GroundRunnerMonitor.exeop Windows) om toekomstige updates te detecteren en toe te passen. Als je ze hernoemt, worden automatische updates niet meer uitgevoerd.
• macOS wordt alleen ondersteund voor ontwikkelingsdoeleinden. Het is geen ondersteund productieplatform.
• Andere servicemanagers: De bovenstaande voorbeelden gebruiken systemd (Linux) en de Windows Service Control Manager. Als uw omgeving een andere servicemanager of procesbeheerder gebruikt, voer dan dezelfde stappen voor stoppen, vervangen en starten uit voor uw configuratie.
• GroundRunners gebruikt standaard een lokaal beheerdersaccount zonder toegang tot externe bronnen zoals gedeelde schijven. Om toegang te krijgen tot een gedeelde bron, zoals een UNC-pad in Windows, start u GroundRunner onder een gebruikersaccount met voldoende rechten voor die bron. Als u een ander gebruikersaccount gebruikt dan de standaard lokale systeembeheerder, moet u dit account de benodigde machtigingen geven om de installatiemap van GroundRunner te beheren, zodat automatische updates mogelijk zijn.