Workiva supportcenter

Följ dessa instruktioner för att ersätta binärfilerna GroundRunner och GroundRunnerMonitor på en värddator med en nyare version.

Viktiga planeringsanteckningar

• GroundRunner-tjänsten stöder inte smidig avstängning. När tjänsten upphör avbryts all verksamhet ombord omedelbart. Resultat från dessa operationer kommer att gå förlorade och kommandona måste köras om.
• Eftersom det är störande att stoppa tjänsten rekommenderar vi starkt att du samordnar ett distributionsfönster med dina intressenter innan du utför uppdateringen, och ser till att inga kritiska jobb körs eller är schemalagda att köras under underhållsperioden.

Förkunskapskrav (alla plattformar)

• Kontrollera om du behöver uppdatera. Den nuvarande versionen (från och med 1 juni 2026) är 9.21.1.
  Se Hur kontrollerar jag versionen av en GroundRunner? för att ta reda på vilken GroundRunner-version du använder.
  Om din GroundRunner är föråldrad visas följande banner.
• Om din GroundRunner är föråldrad, anteckna versionsnumret som visas i fältet Version.

För Windows-plattformar

• Windows GroundRunner.zip, hämtad från Workiva.
  (Se Installera och hantera GroundRunners för mer information.)
• Administratörsbehörigheter för båda:
  • Maskinen där GroundRunner är installerad.
  • Katalogen där binärfilerna är installerade. 
• Tillstånd att stoppa och starta GroundRunner-tjänsten.

För Linux-plattformar

• Windows GroundRunner.zip, hämtad från Workiva.
  (Se Installera och hantera GroundRunners för mer information.)
• Linux-verktygen unzip(1), tar(1)ochgzip(1) måste installeras (dessa är standard i de flesta installationer).
• Ägarskapsbehörigheter för fil (chown).
• Administratörsbehörigheter för båda:
  • Maskinen där GroundRunner är installerad.
  • Katalogen där binärfilerna är installerade. 
• Tillstånd att stoppa och starta GroundRunner-tjänsten.

Windows-installation

1. Extrahera GroundRunner.zip till en tillfällig katalog.
2. Öppna tjänstkonsolen: tryck på Win + R, skriv services.mscoch tryck på Enter.
3. Hitta GroundRunner i listan, högerklicka på den och välj Stoppa. 
4. Vänta tills statusen visar Stoppad.
5. Säkerhetskopiera de befintliga binärfilerna.
   I Utforskaren, navigera till installationskatalogen för GroundRunner och kopiera GroundRunner.exe och GroundRunnerMonitor.exe och eventuella konfigurationsfiler till en säkerhetskopia (t.ex. byt namn på dem till GroundRunner.exe.bak och GroundRunnerMonitor.exe.bak).
6. Ersätt binärfilerna genom att kopiera GroundRunner.exe och GroundRunnerMonitor.exe från den extraherade katalogen till installationskatalogen och skriva över de befintliga filerna.
7. Tillbaka i tjänstekonsolen, högerklicka på GroundRunner och välj Starta. 
8. Kontrollera att statusen visar Körs.

Linux-installation (systemd)

Dessa instruktioner gäller för vanliga Linux-system utan säkerhetsförbättringar. Om din värd kör SELinux, AppArmor eller annan säkerhetsprogramvara, se Obligatorisk åtkomstkontroll (SELinux / AppArmor) i slutet av detta avsnitt.

1. Extrahera artefakterna i zip-filen.

   Obs: Att extrahera zip-filen till /tmp/groundrunner-update används som exempel. Du kan extrahera zip-filen var som helst som passar bäst med din organisations policyer.

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

2. Stoppa den pågående processen. Om du använder systemd, använd det här kommandot:

   sudo systemctl stopp<service-name>

   VIKTIGT: Om du inte har konfigurerat din GroundRunner som en systemd-tjänst, vänligen konfigurera den som en systemd-tjänst innan du utför uppdateringen. Dokumentation om hur man konfigurerar en systemd-tjänst kan hittas via din Linuxdistributions dokumentation. Om du använder en Linux-distribution som inte är systemd, vänligen se dokumentationen för din distribution.

3. Säkerhetskopiera binärfiler och konfigurationer i GroundRunner-katalogen:

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

   Obs: Du får gärna säkerhetskopiera hela installationskatalogen (dvs. inklusive loggar och andra mappar/filer) men det kan skapa en extremt stor säkerhetskopia.

4. Ersätt binärfilerna:

   cd /sökväg_till_groundrunner_installationskatalog cp /tmp/groundrunner-uppdatering/GroundRunner . cp /tmp/groundrunner-uppdatering/GroundRunnerMonitor .

5. Ange körbara behörigheter:

   chmod +x GroundRunner GroundRunnerMonitor

   Obs: Om din GroundRunner körs av en specifik systemanvändare kan du behöva hämta de nya körbara filerna.

6. Starta tjänsten:

   sudo systemctl start<service-name>

7. Kontrollera tjänstens status för att säkerställa att den är felfri:

   sudo systemctl-status<service-name>

8. Städa upp:

   rm -rf /tmp/groundrunner-uppdatering

Obligatorisk åtkomstkontroll (SELinux / AppArmor)

Om värden tillämpar en obligatorisk åtkomstkontrollpolicy (SELinux, AppArmor eller liknande) kan det leda till att tjänsten misslyckas om binärfiler ersätts på disken. 

Se din distributions dokumentation för information om hur du hanterar säkerhetspolicyer kring anpassade tjänster.

Obs: Annan säkerhetsprogramvara – som FAPOLICYD, IMA/EVM eller anpassad filintegritetsövervakning – kan också blockera körningen av ersatta binärfiler. Om tjänsten inte startar efter en uppdatering och du har uteslutit SELinux/AppArmor, kontrollera om några ytterligare säkerhetsramverk på ditt system kräver uppdaterade förtroendelistor eller filsignaturer.

Kontroll

Du kan bekräfta att GroundRunner är aktiv och att dess version är korrekt genom att följa instruktionerna i Hur kontrollerar jag statusen för en GroundRunner?

Vi uppmuntrar dig att skapa och köra en "pilotkedja" som kör en testuppsättning kommandon på GroundRunner för att säkerställa korrekt installation. 

Vi uppmuntrar dig också att övervaka ditt system och GroundRunners aktivitet omedelbart efter uppdatering och omstart. Detta gör att du kan vara säker på att det fungerar korrekt. Du kan göra detta med hjälp av ett CLI-kommando för att strömma och visa nya loggposter allt eftersom de inträffar.

För Windows

För att visa slutet av loggfilen med PowerShell, ange följande:

Get-Content -Sökväg "C:\path_to_\output.log" -Svans 10 -Vänta

Detta håller PowerShell-fönstret öppet och strömmar nya loggposter i realtid. -tail 10 laddar de sista 10 raderna omedelbart.

För Linux

För att visa slutet av loggfilen och strömma nya poster i realtid, ange följande:

svans -f /sökväg till/utgång.log

Rollback

Om den nya versionen inte fungerar korrekt kan du återställa till den tidigare versionen genom att följa dessa steg:

1. Stoppa GroundRunner-tjänsten enligt beskrivningen ovan.
2. Byt namn på de installerade filerna GroundRunner.exe och GroundRunnerMonitor.exe.
3. Kopiera GroundRunner.exe.bak och GroundRunnerMonitor.exe.bak från säkerhetskopian till installationskatalogen. 
4. Byt namn på dessa filer genom att ta bort filändelsen ".bak".
5. Starta om GroundRunner-tjänsten genom att följa lämpliga steg som beskrivs ovan.

Obs: Samma instruktioner gäller för Linux GroundRunners, men du måste extrahera binärfilerna från säkerhetskopian av tarballen.

Anteckningar

• Byt inte namn på binärfilerna. Den automatiska uppgraderingsmekanismen förlitar sig på standardnamnen på körbara filer (GroundRunner och GroundRunnerMonitor på Linux och GroundRunner.exe och GroundRunnerMonitor.exepå Windows) för att upptäcka och tillämpa framtida uppdateringar. Att byta namn på dem kommer att bryta automatiska uppgraderingar.
• macOS stöds endast för utvecklingsändamål. Det är inte en produktionsplattform som stöds.
• Andra tjänsthanterare: Exemplen ovan använder systemd (Linux) och Windows Service Control Manager. Om din miljö använder en annan tjänsthanterare eller processövervakare, utför motsvarande stopp-, ersättnings- och startsteg för din konfiguration.
• Som standard använder GroundRunners ett lokalt administrativt konto utan åtkomst till fjärrresurser som t.ex. aktier. För åtkomst till en aktie, t.ex. en UNC-sökväg i Windows, startar du GroundRunner under ett användarkonto med tillräckliga rättigheter till resursen. Om du använder ett annat användarkonto än den lokala systemadministratören som är standard ska du bevilja det behörighet att hantera GroundRunners installationskatalog för att möjliggöra automatiska uppdateringar.