Starta om en GroundRunner

Använd dessa steg för att få igång GroundRunner igen efter att det har stoppats.

Viktigt: I det här dokumentet avses med "GroundRunner" att starta processen "GroundRunnerMonitor" (detta är "GroundRunnerMonitor" på Linux och "GroundRunnerMonitor.exe" på Windows).
Starta inte GroundRunner (Linux) eller GroundRunner.exe (Windows) direkt – bildskärmen ansvarar för att hantera dess drift.

Förkunskapskrav

Åtkomst till värddatorn där GroundRunner är installerat
Installationskatalogen där binärfilerna finns
Tillstånd att starta tjänster eller processer på maskinen

Verifiera binärfiler

Innan du försöker starta GroundRunner, använd följande kommandon för att bekräfta att binärfilerna fortfarande finns i installationskatalogen. Din installationskatalog kan variera.

För Linux

ls /sökväg/till/groundrunner/installation/GroundRunner ls /sökväg/till/groundrunner/installation/GroundRunnerMonitor

För Windows

mapp C:\sökväg\till\groundrunner\install\GroundRunner.exe mapp C:\sökväg\till\groundrunner\install\GroundRunnerMonitor.exe

Om någon av binärfilerna saknas måste du återställa den från en säkerhetskopia eller installera om den innan du fortsätter.

Linux

Obs: Instruktionerna nedan gäller för systemd-baserade Linuxdistributioner. Om ditt system använder ett annat init-system eller en annan processövervakare, vänligen se din distributions dokumentation för motsvarande tjänsthanteringskommandon.

Om du inte känner till tjänstens namn kan du söka efter det med följande kommando:
sudo systemctl list-units | grep -i groundrunner

Om tjänsten inte känns igen eller inte kan hittas kanske GroundRunnerMonitor inte har registrerats som en systemd-tjänst. Se Om du inte kör GroundRunner som en övervakad tjänst nedan.

Starta systemd-tjänsten

Om GroundRunnerMonitor konfigurerades som en systemd-tjänst, starta den med följande kommando. Var medveten om att ditt tjänstnamn kan variera beroende på hur det konfigurerades.
sudo systemctl start<service-name>
Verifiera att den körs:
sudo systemctl status<service-name>
(Valfritt, men rekommenderat) Aktivera tjänsten så att den startar automatiskt efter en systemomstart:
sudo systemctl enable<service-name>

Fönster

Använda tjänstkonsolen

Öppna tjänstkonsolen:
1. Tryck Win+R.
2. Skriv in services.msc
3. Tryck Ange.
Leta reda på GroundRunner-tjänsten i listan, högerklicka på den och välj Starta.

Kolumnen Status ska uppdateras till "Körs".

Om du inte ser någon "GroundRunner"-tjänst i listan kan GroundRunnerMonitor.exe ha konfigurerats som en förgrundsprocess.

Använda kommandoraden

Alternativt kan du använda kommandoraden. Om du inte vet namnet på tjänsten:

Tryck Win+R.
Skriv in cmd.
Skriv in sc query för att få en lista över alla tjänster.
Leta reda på ditt tjänstnamn.
Ange sc start<service-name>.
Ange sc-fråga<service-name> för att verifiera att den körs.
Värdet i fältet "STATE" ska vara "RUNNING".
(Valfritt men rekommenderat) Konfigurera tjänsten så att den startar automatiskt efter en systemomstart.
- Använda kommandoraden
  1. Tryck Win+R.
  2. Skriv in cmd.
  3. Tryck Ange.
  4. Ange sc-konfiguration<service-name> start=auto i kommandofönstret och tryck på Enter.
- Använda tjänstkonsolen
  1. Tryck Win+R.
  2. Skriv in services.msc.
  3. Tryck Ange.
  4. I tjänstkonsolen:
    1. Högerklicka på GroundRunner tjänsten.
    2. Klicka på Egenskaper.
    3. Ställ in Starttyp till "Automatisk".
    4. Klicka på OK.

Kontroll

Efter att du startat GroundRunner, verifiera att den förväntade versionen (9.21.1) rapporteras i Workiva Chains-applikationen och visas som "Körs".

Anteckningar

Kör alltid GroundRunnerMonitor, inte GroundRunner direkt —GroundRunnerMonitor-processen ansvarar för att hantera GroundRunners livscykel, inklusive att tillämpa automatiska uppdateringar. Att köra GroundRunner-binärfilen kringgår denna hantering direkt och kommer att resultera i missade uppdateringar och oväntat beteende.
Anpassade konfigurationer — Om din miljö använder en annan tjänsthanterare än systemd eller Windows Service Control Manager, utför motsvarande start- och statuskontroll för din konfiguration.
Byt inte namn på binärfilerna —Den automatiska uppgraderingsmekanismen förlitar sig på standardnamnen på körbara filer (GroundRunner, GroundRunnerMonitor och GroundRunner.exe, GroundRunnerMonitor.exe) för att upptäcka och tillämpa framtida uppdateringar.
API-tillståndsregenerering —Du behöver inte regenerera API-tillståndet efter att du har startat om GroundRunner-servern. Så länge GroundRunner-tjänsten startar om korrekt efter omstarten och återansluter till Workiva, förblir det befintliga API-tillståndet giltigt.
Antivirusskanning och GroundRunners —Vi anser att det är bäst att exkludera hela GroundRunner-installationskatalogen och dess tmp-undermapp från antivirusskanning, snarare än att exkludera enskilda .exe-filer. Detta förhindrar liknande blockeringar på andra körbara plugin-filer.

Konfigurera GroundRunner som en övervakad tjänst

Linux (systemd)

Konfigurera GroundRunnerMonitor som en systemd-tjänst. Om det inte redan finns en enhetsfil för GroundRunnerMonitor måste en skapas. SUSEs guide för att konfigurera en systemd-tjänst är en användbar referens för den här processen, även om det är en tredjepartsresurs och din specifika miljö kan kräva justeringar.

I din systemd-enhetsfil, se till att följande inställningar finns under [Service] så att processen startar om automatiskt vid avslutning eller fel:

[Tjänst] Omstart=alltid Omstartssekund=10

Efter att du har skapat eller uppdaterat enhetsfilen, använd följande kommandon för att ladda om systemd och aktivera tjänsten:

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

Fönster

Registrera GroundRunnerMonitor som en Windows-tjänst. När du har registrerat dig, konfigurera tjänsten så att den startas om vid fel. Antingen:

Använda tjänstkonsolen

Tryck Win+R.
Skriv in services.msc.
Tryck Ange.
I tjänstekonsolen högerklickar du på tjänsten GroundRunner.
Klicka på Egenskaper.
Välj fliken Återställning.
Ställ in värdena för Första felet, Andra feletoch Efterföljande fel till "Starta om tjänsten".
Klicka på OK.

Använda kommandoraden

Tryck Win+R.
Skriv in cmd.
Tryck Ange.
Skriv in följande kommando och tryck på Enter:
sc failure<service-name> reset=0 actions=restart/10000/restart/10000/restart/10000
Detta anger att Windows ska starta om tjänsten efter 10 sekunder vid varje fel.

Om du inte kör GroundRunner som en övervakad tjänst

Vi rekommenderar att GroundRunnerMonitor körs som en omstartbar tjänst på värdoperativsystemet, snarare än som en förgrundsprocess, eftersom en förgrundsprocess inte överlever terminalavbrott, maskinomstarter eller automatiska uppdateringar – och alla dessa kommer att kräva manuell åtgärd för att få GroundRunner att köra igen. För information om installation av GroundRunners, se Workivas supportsida: Installera och hantera GroundRunners.

Videodemonstrationer

Dessa videor illustrerar processerna som beskrivs ovan.

För Linux

För Windows

Support

Community

Workiva supportcenter