Workiva kundestøttesenter

Følg disse instruksjonene for å erstatte GroundRunner- og GroundRunnerMonitor-binærfilene på en vertsmaskin med en nyere versjon.

Viktige planleggingsnotater

• GroundRunner-tjenesten støtter ikke grasiøs avslutning. Når tjenesten stoppes, avsluttes all drift om bord umiddelbart. Resultatene fra disse operasjonene vil gå tapt, og kommandoene må kjøres på nytt.
• Fordi det å stoppe tjenesten er forstyrrende, anbefaler vi på det sterkeste at du koordinerer et distribusjonsvindu med interessentene dine før du utfører oppdateringen, og sørger for at ingen kritiske jobber kjører eller er planlagt å kjøre i løpet av vedlikeholdsperioden.

Forutsetninger (alle plattformer)

• Sjekk om du trenger å oppdatere. Den nåværende versjonen (per 1. juni 2026) er 9.21.1.
  Se Hvordan sjekker jeg versjonen av en GroundRunner? for å finne ut hvilken GroundRunner-versjon du bruker.
  Hvis GroundRunner-en din er utdatert, vises følgende banner.
• Hvis GroundRunner-en din er utdatert, noter versjonsnummeret som vises i feltet Versjon.

For Windows-plattformer

• Windows GroundRunner.zip, hentet fra Workiva.
  (Se Installer og administrer GroundRunners for detaljer.)
• Administratorrettigheter for begge:
  • Maskinen der GroundRunner er installert.
  • Katalogen der binærfilene er installert. 
• Tillatelse til å stoppe og starte GroundRunner-tjenesten.

For Linux-plattformer

• Windows GroundRunner.zip, hentet fra Workiva.
  (Se Installer og administrer GroundRunners for detaljer.)
• Linux-verktøyene unzip(1), tar(1)oggzip(1) må installeres (disse er standard i de fleste installasjoner).
• Fileierskapstillatelser (chown).
• Administratorrettigheter for begge:
  • Maskinen der GroundRunner er installert.
  • Katalogen der binærfilene er installert. 
• Tillatelse til å stoppe og starte GroundRunner-tjenesten.

Windows-installasjon

1. Pakk ut GroundRunner.zip til en midlertidig mappe.
2. Åpne tjenestekonsollen: trykk Win + R, skriv services.msc, og trykk Enter.
3. Finn GroundRunner i listen, høyreklikk på den, og velg Stopp. 
4. Vent til statusen viser Stoppet.
5. Sikkerhetskopier de eksisterende binærfilene.
   I Filutforsker navigerer du til installasjonsmappen for GroundRunner og kopierer GroundRunner.exe og GroundRunnerMonitor.exe og eventuelle konfigurasjonsfiler til en sikkerhetskopiplassering (f.eks. gi dem nytt navn til GroundRunner.exe.bak og GroundRunnerMonitor.exe.bak).
6. Erstatt binærfilene ved å kopiere GroundRunner.exe og GroundRunnerMonitor.exe fra den utpakkede katalogen til installasjonsmappen, og overskrive de eksisterende filene.
7. Tilbake i tjenestekonsollen, høyreklikk på GroundRunner og velg Start. 
8. Bekreft at statusen viser Kjører.

Linux (systemd) installasjon

Disse instruksjonene gjelder for standard Linux-systemer uten sikkerhetsforbedring. Hvis verten din kjører SELinux, AppArmor eller annen sikkerhetsprogramvare, se Obligatorisk tilgangskontroll (SELinux / AppArmor) på slutten av denne delen.

1. Pakk ut artefaktene i zip-filen.

   Merk: Utpakking av zip-filen til /tmp/groundrunner-update brukes som eksempel. Du kan pakke ut zip-filen der det passer best med organisasjonens retningslinjer.

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

2. Stopp den løpende prosessen. Hvis du bruker systemd, bruk denne kommandoen:

   sudo systemctl stopp<service-name>

   VIKTIG MERKNAD: Hvis du ikke har GroundRunner konfigurert som en systemd-tjeneste, må du sette den opp som en systemd-tjeneste før du utfører oppdateringen. Dokumentasjon om hvordan du konfigurerer en systemd-tjeneste finner du via dokumentasjonen for Linux-distribusjonen din. Hvis du bruker en ikke-systemd Linux-distribusjon, vennligst se dokumentasjonen for distribusjonen din.

3. Sikkerhetskopier binærfiler og konfigurasjoner i GroundRunner-katalogen:

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

   Merk: Du kan gjerne sikkerhetskopiere hele installasjonsmappen (dvs. inkludert logger og andre mapper/filer), men det kan opprette en ekstremt stor sikkerhetskopifil.

4. Erstatt binærfilene:

   cd /sti_til_groundrunner_install_dir cp /tmp/groundrunner-oppdatering/GroundRunner . cp /tmp/groundrunner-oppdatering/GroundRunnerMonitor .

5. Angi kjørbare tillatelser:

   chmod +x GroundRunner GroundRunnerMonitor

   Merk: Hvis GroundRunner kjøres av en spesifikk systembruker, må du kanskje hente de nye kjørbare filene.

6. Start tjenesten:

   sudo systemctl start<service-name>

7. Sjekk statusen til tjenesten for å sikre at den er i orden:

   sudo systemctl-status<service-name>

8. Rydd opp:

   rm -rf /tmp/groundrunner-oppdatering

Obligatorisk tilgangskontroll (SELinux / AppArmor)

Hvis verten håndhever en obligatorisk tilgangskontrollpolicy (SELinux, AppArmor eller lignende), kan det føre til at tjenesten mislykkes hvis man bytter ut binærfiler på disken. 

Se distribusjonens dokumentasjon for administrasjon av sikkerhetspolicyer rundt tilpassede tjenester.

Merk: Annen sikkerhetsprogramvare – som FAPOLICYD, IMA/EVM eller tilpasset filintegritetsovervåking – kan også blokkere kjøring av erstattede binærfiler. Hvis tjenesten ikke starter etter en oppdatering, og du har utelukket SELinux/AppArmor, bør du sjekke om det finnes ytterligere sikkerhetsrammeverk på systemet ditt som krever oppdaterte tillitslister eller filsignaturer.

Bekreftelse

Du kan bekrefte at GroundRunner er aktiv og at versjonen er riktig ved å følge instruksjonene i Hvordan sjekker jeg statusen til en GroundRunner?

Vi oppfordrer deg til å opprette og kjøre en «pilotkjede» som kjører et testsett med kommandoer på GroundRunner for å sikre riktig installasjon. 

Vi oppfordrer deg også til å overvåke systemet ditt og GroundRunners aktivitet umiddelbart etter oppdatering og omstart. Dette lar deg være trygg på at det fungerer som det skal. Du kan gjøre dette ved hjelp av en CLI-kommando for å strømme og vise nye loggoppføringer etter hvert som de skjer.

For Windows

For å se slutten av loggfilen ved hjelp av PowerShell, skriv inn følgende:

Get-Content -Sti "C:\sti_til_\output.log" -Hale 10 -Vent

Dette holder PowerShell-vinduet åpent og strømmer nye loggoppføringer i sanntid. -tail 10 laster de siste 10 linjene umiddelbart.

For Linux

For å se slutten av loggfilen og strømme nye oppføringer i sanntid, skriv inn følgende:

hale -f /sti_til/utdata.logg

Tilbakerulling

Hvis den nye versjonen ikke fungerer som den skal, kan du gå tilbake til den forrige versjonen ved å følge disse trinnene:

1. Stopp GroundRunner-tjenesten som beskrevet ovenfor.
2. Gi nytt navn til de installerte filene GroundRunner.exe og GroundRunnerMonitor.exe.
3. Kopier GroundRunner.exe.bak og GroundRunnerMonitor.exe.bak fra sikkerhetskopieringsplasseringen til installasjonsmappen. 
4. Gi disse filene nytt navn ved å fjerne filtypen «.bak».
5. Start GroundRunner-tjenesten på nytt ved å følge de aktuelle trinnene beskrevet ovenfor.

Merk: De samme instruksjonene gjelder for Linux GroundRunners, men du må pakke ut binærfilene fra sikkerhetskopi-tarballen.

Merknader

• Ikke gi binærfilene nytt navn. Den automatiske oppgraderingsmekanismen er avhengig av standardnavnene på kjørbare filer (GroundRunner og GroundRunnerMonitor på Linux, og GroundRunner.exe og GroundRunnerMonitor.exepå Windows) for å oppdage og installere fremtidige oppdateringer. Å gi dem nytt navn vil bryte automatiske oppgraderinger.
• macOS støttes kun for utviklingsformål. Det er ikke en støttet produksjonsplattform.
• Andre tjenestebehandlere: Eksemplene ovenfor bruker systemd (Linux) og Windows Service Control Manager. Hvis miljøet ditt bruker en annen tjenesteansvarlig eller prosessupervisor, utfør de tilsvarende stopp-, erstatt- og starttrinnene for konfigurasjonen.
• Som standard bruker GroundRunners en lokal administratorkonto uten tilgang til eksterne ressurser som delte disker. For å få tilgang til en delt ressurs, for eksempel en Windows UNC-sti, start GroundRunner under en brukerkonto med tilstrekkelige rettigheter til ressursen. Hvis du bruker en annen brukerkonto enn standard lokal systemadministrator, må du gi den tillatelser til å administrere GroundRunners installasjonskatalog for å aktivere automatiske oppdateringer.