Een GroundRunner opnieuw opstarten

Volg deze stappen om GroundRunner weer aan de praat te krijgen nadat het is vastgelopen.

Belangrijk: In dit document verwijst "GroundRunner" naar het starten van het "GroundRunnerMonitor"-proces (dit is "GroundRunnerMonitor" op Linux en "GroundRunnerMonitor.exe" op Windows).
Start GroundRunner (Linux) of GroundRunner.exe (Windows) niet rechtstreeks op; de monitor is verantwoordelijk voor het beheer ervan.

Voorwaarden

Toegang tot de hostmachine waarop GroundRunner is geïnstalleerd.
De installatiemap waar de binaire bestanden zich bevinden
Toestemming om services of processen op de machine te starten.

Controleer binaire bestanden

Voordat je GroundRunner probeert te starten, gebruik je de volgende commando's om te controleren of de binaire bestanden nog steeds in de installatiemap aanwezig zijn. De installatiemap kan variëren.

Voor Linux

ls /pad/naar/groundrunner/installatie/GroundRunner ls /pad/naar/groundrunner/installatie/GroundRunnerMonitor

Voor Windows

map C:\pad\naar\groundrunner\install\GroundRunner.exe map C:\pad\naar\groundrunner\install\GroundRunnerMonitor.exe

Als een van beide binaire bestanden ontbreekt, moet u dat binaire bestand herstellen vanuit een back-up of het opnieuw installeren voordat u verder kunt gaan.

Linux

Opmerking: De onderstaande instructies zijn voor Linux-distributies die op systemd gebaseerd zijn. Als uw systeem een ander init-systeem of procesbeheerder gebruikt, raadpleeg dan de documentatie van uw distributie voor de equivalente servicebeheeropdrachten.

Als je de servicenaam niet weet, kun je ernaar zoeken met de volgende opdracht:
sudo systemctl list-units | grep -i groundrunner

Als de service niet wordt herkend of niet kan worden gevonden, is GroundRunnerMonitor mogelijk niet geregistreerd als een systemd-service. Zie Als u GroundRunner niet als een bewaakte service uitvoert hieronder.

Start de systemd-service

Als GroundRunnerMonitor is geconfigureerd als een systemd-service, start deze dan met de volgende opdracht. Houd er rekening mee dat de naam van uw service kan variëren, afhankelijk van hoe deze is geconfigureerd.
sudo systemctl start<service-name>
Controleer of het actief is:
sudo systemctl status<service-name>
(Optioneel, maar aanbevolen) Schakel de service in zodat deze automatisch start na een systeemherstart:
sudo systemctl enable<service-name>

Windows

De serviceconsole gebruiken

Open de Services-console:
1. Druk op Win+R.
2. Voer services.mscin
3. Druk op Enter.
Zoek de GroundRunner-service in de lijst, klik er met de rechtermuisknop op en selecteer Start.

De kolom Status moet worden bijgewerkt naar "Actief".

Als u geen "GroundRunner"-service ziet staan, is mogelijk GroundRunnerMonitor.exe als voorgrondproces ingesteld.

De opdrachtregel gebruiken

Je kunt ook de opdrachtregel gebruiken. Als u de naam van de dienst niet weet:

Druk op Win+R.
Voer cmdin.
Voer sc query in om een lijst van alle services te krijgen.
Zoek de naam van uw dienst op.
Voer sc start in<service-name>.
Voer sc query in<service-name> om te controleren of het werkt.
De waarde van het veld "STATE" moet 'RUNNING' zijn.
(Optioneel, maar aanbevolen) Configureer de service zodanig dat deze automatisch start na een systeemherstart.
- De opdrachtregel gebruiken
  1. Druk op Win+R.
  2. Voer cmdin.
  3. Druk op Enter.
  4. Voer sc config in<service-name> Typ start=auto in het opdrachtvenster en druk op Enter.
- De serviceconsole gebruiken
  1. Druk op Win+R.
  2. Voer services.mscin.
  3. Druk op Enter.
  4. In de Services-console:
    1. Klik met de rechtermuisknop op de GroundRunner service.
    2. Klik op Eigenschappen.
    3. Stel het opstarttype in op "Automatisch".
    4. Klik op OK.

Verificatie

Nadat u GroundRunner hebt gestart, controleert u of de verwachte versie (9.21.1) wordt weergegeven in de Workiva Chains-applicatie en of deze de status "Actief" heeft.

Notities

Voer altijd GroundRunnerMonitor uit, niet GroundRunner direct —Het GroundRunnerMonitor-proces is verantwoordelijk voor het beheren van de levenscyclus van GroundRunner, inclusief het toepassen van automatische updates. Door het GroundRunner-programma rechtstreeks uit te voeren, wordt dit beheer omzeild, wat kan leiden tot gemiste updates en onverwacht gedrag.
Aangepaste configuraties — Als uw omgeving een andere servicemanager gebruikt dan systemd of de Windows Service Control Manager, voer dan de overeenkomstige start- en statuscontrole uit voor uw configuratie.
Hernoem de binaire bestanden niet —Het automatische upgrademechanisme vertrouwt op de standaard uitvoerbare namen (GroundRunner, GroundRunnerMonitor en GroundRunner.exe, GroundRunnerMonitor.exe) om toekomstige updates te detecteren en toe te passen.
API Grant opnieuw genereren —U hoeft de API Grant niet opnieuw te genereren na het herstarten van de GroundRunner-server. Zolang de GroundRunner-service na de herstart correct opnieuw opstart en opnieuw verbinding maakt met Workiva, blijft de bestaande API-toekenning geldig.
Antivirusscans en GroundRunners —Wij vinden het raadzaam om de volledige installatiemap van GroundRunner en de bijbehorende submap tmp uit te sluiten van antivirusscans, in plaats van individuele .exe-bestanden uit te sluiten. Dit voorkomt soortgelijke blokkeringen op andere uitvoerbare pluginbestanden.

GroundRunner configureren als een bewaakte service.

Linux (systemd)

Configureer GroundRunnerMonitor als een systemd-service. Als er nog geen unit-bestand bestaat voor GroundRunnerMonitor, moet er een worden aangemaakt. De SUSE-handleiding voor het instellen van een systemd-service is een nuttige referentie voor dit proces, hoewel het een bron van derden is en uw specifieke omgeving mogelijk aanpassingen vereist.

Zorg ervoor dat in uw systemd-unitbestand de volgende instellingen aanwezig zijn onder [Service] zodat het proces automatisch opnieuw wordt gestart bij afsluiting of fout:

[Service] Herstart=altijd HerstartSec=10

Nadat u het unit-bestand hebt aangemaakt of bijgewerkt, gebruikt u de volgende opdrachten om systemd opnieuw te laden en de service in te schakelen:

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

Windows

Registreer GroundRunnerMonitor als een Windows-service. Na registratie configureert u de service zodanig dat deze bij een storing opnieuw opstart. Of:

De serviceconsole gebruiken

Druk op Win+R.
Voer services.mscin.
Druk op Enter.
Klik in de Services-console met de rechtermuisknop op de service GroundRunner.
Klik op Eigenschappen.
Selecteer het tabblad Herstel.
Stel de waarden voor Eerste fout, Tweede fout, en Vervolgfouten in op "De service opnieuw starten".
Klik op OK.

De opdrachtregel gebruiken

Druk op Win+R.
Voer cmdin.
Druk op Enter.
Voer de volgende opdracht in en druk op Enter:
sc mislukking<service-name> reset=0 actions=restart/10000/restart/10000/restart/10000
Dit geeft Windows de opdracht om de service na 10 seconden opnieuw te starten bij elke fout.

Als u GroundRunner niet als een bewaakte service uitvoert, is dit niet nodig.

We raden aan GroundRunnerMonitor als een herstartbare service op het hostbesturingssysteem uit te voeren, in plaats van als een proces op de voorgrond. Een proces op de voorgrond overleeft namelijk geen verbindingen die worden verbroken, geen herstarts van de computer of automatische updates. In al deze gevallen is handmatige tussenkomst nodig om GroundRunner weer aan de praat te krijgen. Voor informatie over het installeren van GroundRunners kunt u terecht op de Workiva-ondersteuningspagina: GroundRunners installeren en beheren.

Videodemonstraties

Deze video's illustreren de hierboven beschreven processen.

Voor Linux

Voor Windows

Ondersteuning

Community

Workiva-ondersteuningscentrum