Starte en GroundRunner på nytt

Bruk disse trinnene for å få GroundRunner til å kjøre igjen etter at den har stoppet.

Viktig: Gjennom hele dette dokumentet betyr referanser til «GroundRunner» å starte «GroundRunnerMonitor»-prosessen (dette er «GroundRunnerMonitor» på Linux og «GroundRunnerMonitor.exe» på Windows).
Ikke start GroundRunner (Linux) eller GroundRunner.exe (Windows) direkte – skjermen er ansvarlig for å administrere driften.

Forutsetninger

Tilgang til vertsmaskinen der GroundRunner er installert
Installasjonskatalogen der binærfilene ligger
Tillatelse til å starte tjenester eller prosesser på maskinen

Bekreft binærfiler

Før du prøver å starte GroundRunner, bruk følgende kommandoer for å bekrefte at binærfilene fortsatt er tilstede i installasjonsmappen. Installasjonskatalogen din kan variere.

For Linux

ls /sti/til/groundrunner/installasjon/GroundRunner ls /sti/til/groundrunner/installasjon/GroundRunnerMonitor

For Windows

dir C:\sti\til\groundrunner\install\GroundRunner.exe dir C:\sti\til\groundrunner\install\GroundRunnerMonitor.exe

Hvis en av binærfilene mangler, må du gjenopprette den binærfilen fra en sikkerhetskopi eller installere den på nytt før du fortsetter.

Linux

Merk: Instruksjonene nedenfor gjelder for systemd-baserte Linux-distribusjoner. Hvis systemet ditt bruker et annet init-system eller en annen prosessupervisor, kan du se i distribusjonens dokumentasjon for tilsvarende tjenesteadministrasjonskommandoer.

Hvis du ikke vet tjenestenavnet, kan du søke etter det ved å bruke følgende kommando:
sudo systemctl list-units | grep -i groundrunner

Hvis tjenesten ikke gjenkjennes eller ikke finnes, kan det hende at GroundRunnerMonitor ikke er registrert som en systemd-tjeneste. Se Hvis du ikke kjører GroundRunner som en overvåket tjeneste nedenfor.

Start systemd-tjenesten

Hvis GroundRunnerMonitor ble konfigurert som en systemd-tjeneste, start den med følgende kommando. Vær oppmerksom på at tjenestenavnet kan variere avhengig av hvordan det ble konfigurert.
sudo systemctl start<service-name>
Bekreft at den kjører:
sudo systemctl status<service-name>
(Valgfritt, men anbefalt) Aktiver tjenesten slik at den starter automatisk etter en systemomstart:
sudo systemctl enable<service-name>

Vinduer

Bruke tjenestekonsollen

Åpne tjenestekonsollen:
1. Trykk Win+R.
2. Skriv inn services.msc
3. Trykk Enter.
Finn GroundRunner-tjenesten i listen, høyreklikk på den og velg Start.

Statuskolonnen skal oppdateres til «Kjører».

Hvis du ikke ser en «GroundRunner»-tjeneste oppført, kan det hende at GroundRunnerMonitor.exeer konfigurert som en forgrunnsprosess.

Bruke kommandolinjen

Alternativt kan du bruke kommandolinjen. Hvis du ikke vet navnet på tjenesten:

Trykk Win+R.
Skriv inn cmd.
Skriv inn sc query for å få en liste over alle tjenester.
Finn tjenestenavnet ditt.
Skriv inn sc start<service-name>.
Skriv inn sc-spørring<service-name> for å bekrefte at den kjører.
Verdien i feltet «STATE» skal være «RUNNING».
(Valgfritt, men anbefalt) Konfigurer tjenesten til å starte automatisk etter en systemomstart.
- Bruke kommandolinjen
  1. Trykk Win+R.
  2. Skriv inn cmd.
  3. Trykk Enter.
  4. Skriv inn sc-konfigurasjon<service-name> start=auto i kommandovinduet, og trykk Enter.
- Bruke tjenestekonsollen
  1. Trykk Win+R.
  2. Skriv inn services.msc.
  3. Trykk Enter.
  4. I tjenestekonsollen:
    1. Høyreklikk på GroundRunner -tjenesten.
    2. Klikk på Egenskaper.
    3. Sett Oppstartstype til "Automatisk".
    4. Klikk på OK.

Bekreftelse

Etter at du har startet GroundRunner, må du bekrefte at den forventede versjonen (9.21.1) er rapportert i Workiva Chains-applikasjonen og vises som "Kjører".

Merknader

Kjør alltid GroundRunnerMonitor, ikke GroundRunner direkte —GroundRunnerMonitor-prosessen er ansvarlig for å administrere livssyklusen til GroundRunner, inkludert å bruke automatiske oppdateringer. Å kjøre GroundRunner-binærfilen omgår denne administrasjonen direkte og vil føre til tapte oppdateringer og uventet oppførsel.
Tilpassede konfigurasjoner — Hvis miljøet ditt bruker en annen tjenestebehandler enn systemd eller Windows Service Control Manager, utfør tilsvarende start- og statuskontroll for konfigurasjonen din.
Ikke gi binærfilene nytt navn —Den automatiske oppgraderingsmekanismen er avhengig av standardnavnene på de kjørbare filene (GroundRunner, GroundRunnerMonitor og GroundRunner.exe, GroundRunnerMonitor.exe) for å oppdage og installere fremtidige oppdateringer.
Regenerering av API-tilskudd —Du trenger ikke å regenerere API-tilskuddet etter at du har startet GroundRunner-serveren på nytt. Så lenge GroundRunner-tjenesten starter på nytt på riktig måte etter omstart og kobler seg til Workiva igjen, forblir den eksisterende API-tilskuddet gyldig.
Antivirusskanning og GroundRunners —Vi anser det som beste fremgangsmåte å ekskludere hele GroundRunner-installasjonsmappen og dens tmp-undermappe fra antivirusskanning, i stedet for å ekskludere individuelle .exe-filer. Dette forhindrer lignende blokkeringer på andre kjørbare plugin-filer.

Konfigurere GroundRunner som en overvåket tjeneste

Linux (systemd)

Konfigurer GroundRunnerMonitor som en systemd-tjeneste. Hvis det ikke allerede finnes en enhetsfil for GroundRunnerMonitor, må det opprettes en. SUSEs veiledning for å sette opp en systemd-tjeneste er en nyttig referanse for denne prosessen, selv om det er en tredjepartsressurs og ditt spesifikke miljø kan kreve justeringer.

I systemd-enhetsfilen din må du sørge for at følgende innstillinger er tilstede under [Tjeneste] slik at prosessen starter på nytt automatisk ved avslutning eller feil:

[Tjeneste] Omstart=alltid Omstartsekund=10

Etter at du har opprettet eller oppdatert enhetsfilen, bruk følgende kommandoer for å laste inn systemd på nytt og aktivere tjenesten:

sudo systemctl daemon-reload sudo systemctl enable<service-name> sudo systemctl start

Vinduer

Registrer GroundRunnerMonitor som en Windows-tjeneste. Når den er registrert, konfigurerer du tjenesten til å starte på nytt ved feil. Enten:

Bruke tjenestekonsollen

Trykk Win+R.
Skriv inn services.msc.
Trykk Enter.
I tjenestekonsollen høyreklikker du på GroundRunner -tjenesten.
Klikk på Egenskaper.
Velg fanen Gjenoppretting.
Sett verdiene for Første feil, Andre feilog Etterfølgende feil til «Start tjenesten på nytt».
Klikk på OK.

Bruke kommandolinjen

Trykk Win+R.
Skriv inn cmd.
Trykk Enter.
Skriv inn følgende kommando og trykk Skriv inn:
sc failure<service-name> reset=0 actions=restart/10000/restart/10000/restart/10000
Dette forteller Windows at tjenesten skal startes på nytt etter 10 sekunder ved hver feil.

Hvis du ikke kjører GroundRunner som en overvåket tjeneste

Vi anbefaler at GroundRunnerMonitor kjøres som en omstartbar tjeneste på vertsoperativsystemet, i stedet for som en forgrunnsprosess, fordi en forgrunnsprosess ikke vil overleve terminalfrakoblinger, maskinomstart eller automatiske oppdateringer – og alle disse vil kreve manuell inngripen for å få GroundRunner til å kjøre igjen. For informasjon om installasjon av GroundRunners, se Workivas kundestøtteside: Installer og administrer GroundRunners.

Videodemonstrasjoner

Disse videoene illustrerer prosessene beskrevet ovenfor.

For Linux

For Windows

Støtte

Fellesskap

Workiva kundestøttesenter