Installer og administrer GroundRunners

GroundRunners gjør det mulig for kjedekommandoer å samhandle med lokale systemer eller eksterne datakilder som ellers ikke er tilgjengelige over internett. De installeres vanligvis på en dedikert server, for eksempel den som er vert for den tilkoblede datakilden, av en IT-profesjonell eller noen som på annen måte er kjent med organisasjonens nettverksinnstillinger.

Før du setter opp en GroundRunner, anbefaler vi å se gjennom Chain Builder sikkerhetsarkitekturen.

Krav

Et kompatibelt operativsystem er nødvendig, og hvis GroundRunner-en din skal ha tilgang til delte ressurser, for eksempel en Windows Universal Naming Convention (UNC)-sti, trenger du også en brukerkonto med tilstrekkelige rettigheter.

Det installeres ikke et Java Runtime Environment (JRE) sammen med GroundRunner under den første GroundRunner-installasjonen.

Etter at installasjonen er fullført og GroundRunner kjører, vil den automatisk laste ned en JRE etter behov for å kjøre kommandoer som er avhengige av Java. Ingen installasjon eller administrativ inngripen er nødvendig, og den hentede JRE-en vil ikke påvirke eksisterende JRE-installasjoner hvis de finnes på verten.

Alternativt, hvis du har organisasjonskrav som krever bruk av en bestemt JRE, kan miljøvariabelen SHARED_LIBRARY_OVERRIDES settes til å peke til systeminstallasjonen. I dette tilfellet vil ikke GroundRunner automatisk laste ned Workiva-standard JRE, og vil bruke den medfølgende system-JRE-installasjonen.

Workiva-leverte JRE-er er lisensiert under GPL v2, og dekkes avclasspath-unntaket.

Merk: Hvis du vil bruke tilpassede sertifikater med Java-installasjonen din, kan du seBruke tilpassede sertifikater med GroundRunners.

For øyeblikket kan GroundRunners installeres på følgende operativsystemfamilier uten eksterne bibliotekavhengigheter:

Windows og Windows Server
Linux-distribusjoner og derivater:
- RedHat, Fedora, AmazonLinux
- Debian/Ubuntu
macOS (kun for testing)

Workiva streber etter å støtte alle moderne versjoner av operativsystemfamiliene som er oppført ovenfor. Vi kan imidlertid ikke støtte operativsystemer som er utpekt som «utgått på levetiden» av leverandøren. Disse eldre operativsystemene utgjør potensielle sikkerhetsrisikoer og bør oppdateres til en oppdatert versjon så snart som mulig. Lær mer om vår policy for utrangering av gjenbruk.

Merknad: Hvert operativsystems støtteplan er satt av den enkelte leverandøren. For eksempel opphørte Microsofts støtte for Windows 7 14. januar 2020, og Workivas støtte for Windows 7 opphørte samme dato.

Maskinvarekrav

Selv om GroundRunners krever begrensede serverressurser, anbefaler vi minst:

512 MB tilgjengelig RAM (random access memory)
100 GB tilgjengelig diskplass

Merk: For å beregne nødvendig diskplass, må du vite at en kjede med fem kommandoer som hver produserer 10 MB flyktige utdata krever 50 MB for å fullføres.

Den anbefalte vertskonfigurasjonen inkluderer en virtuell maskin konfigurert med:

To til fire prosessorer

Merknad: ARM-baserte prosessorer er ikke kompatible med GroundRunners.
8 GB systemminne
En SSD-lagringsenhet (solid state drive)

Denne serveren må være tilgjengelig døgnet rundt for å kommunisere med GroundRunner.

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.

Rollekrav

På Workiva-plattformen

På Workiva-plattformen trenger du en rolle som gir tilgang til Chain Builder-innstillingene og muligheten til å administrere Runners. Det er to:

Kjedeeier: Dette er den primære rollen som kreves. Brukere med denne rollen kan få tilgang til «Nedlastinger»-delen i Chain Builder for å hente de nyeste GroundRunner-installasjonsfilene og administrere «Runners»-fanen for å aktivere eller overvåke tjenesten.
Sikkerhetsadministrator for organisasjonskjede: Denne rollen på organisasjonsnivå har også autorisasjon til å administrere tilkoblinger og løpere på tvers av flere arbeidsområder.

På serveren

Fordi en «manuell oppdatering» innebærer å stoppe tjenester og erstatte kjørbare filer på den fysiske eller virtuelle maskinen der GroundRunner er installert, må brukeren ha administratorrettigheter på vertsserveren.

Windows: Du må kunne kjøre ledeteksten som administrator og få tilgang til Windows Service Manager (for å stoppe og starte GroundRunner-tjenesten på nytt).
Linux/macOS: Du må ha sudo eller root tilgang for å flytte filer til installasjonsmappen og starte bakgrunnsprosessen på nytt.

Last ned GroundRunner

Slik laster du ned en GroundRunner for installasjon eller manuell oppdatering:

Klikk på Kjederi Workiva Home-sidefeltet.
Klikk på Tilkoblingeri sidefeltet i Kjedebyggeren (dette er en ny fane).

Alternativt kan du klikke på brukerprofilikonet øverst til høyre, velge Kjedeadministratorog deretter Arbeidsplassinnstillinger.
Klikk på Nedlastinger i den øverste menylinjen.
Finn GroundRunner for operativsystemet ditt, og klikk på Last ned for å laste den ned.
Når den er lastet ned til datamaskinen din, velger du de riktige instruksjonene fra settet nedenfor og følger dem for å installere GroundRunner.

Installer GroundRunner

Microsoft Installer (MSI) krever .NET 3.5 eller høyere.
Hvis du ikke kan oppfylle dette kravet, må du installere GroundRunner ved hjelp av kommandolinjegrensesnittet i stedet.

Slik installerer du GroundRunner:

Pakk ut GroundRunner.zip til en ny mappe, og åpne mappen.
Kjør GroundRunner.msi for å åpne GroundRunner-oppsettveiviseren.
Klikk på Neste.
Les og godta vilkårene i lisensavtalen, og klikk på Neste.
For målmappen skriver du inn banen der GroundRunner skal installeres (for eksempel: C:\Programfiler\GroundRunner\) og klikker på Neste.
I Plattformfirmatokenskriver du inn firmatokenet ditt.
I Plattformgodkjenningsvert:
- For APAC, skriv inn h.apac.wdesk.com/s/chains-reaper.
- For EMEA, skriv inn h.eu.wdesk.com/s/chains-reaper.
- For USA, Mellom-Amerika og Sør-Amerika, skriv inn h.app.wdesk.com/s/chains-reaper.
Hvis du bruker en proxy-server, skriver du inn URL-en og porten i Proxy-vert.
(For eksempel, http://dinproxy:3000.)
For å omgå proxy-serveren, skriv inn en kommaseparert liste over verter under Ingen proxy-vert.
Klikk på Neste, Installerog Fullfør.
Når den er installert, høyreklikker du på GroundRunner fra Windows Service Manager og velger Start.

GroundRunner-enheten din er nå installert og klar til aktivering.

For å installere via kommandolinjegrensesnittet må du laste ned GroundRunner-installasjonen til en egen mappe i programfilene dine (for eksempel c:\Program Files (x86)\wdata). Du kan deretter pakke ut installasjonsfilen og pakke den ut til rotkatalogen i den mappen.

Deretter kan du installere GroundRunner:

I Windows-kommandovinduet skriver du inn
```
c:\Program Files (x86)\wdata\installer.exe install
```
og godtar alle standardinnstillinger.
- Velg "Windows" for init-systemet.
  
  Du må spesifisere at GroundRunner skal fungere som en Windows-tjeneste for at den skal støttes med automatiske oppdateringer. GroundRunners skal kun kjøres som en tjeneste, bortsett fra for testformål.
- For banen, opprett en Files -mappe i den nye katalogen
  (for eksempel C:\Program Files (x86)\Wdata\Files).
- For autorisasjonsvertsnavnet (AUTH_HOST):
  - For APAC, skriv inn h.apac.wdesk.com/s/chains-reaper.
  - For EMEA, skriv inn h.eu.wdesk.com/s/chains-reaper.
  - For USA, Mellom-Amerika og Sør-Amerika, skriv inn h.app.wdesk.com/s/chains-reaper.
- Skriv inn ditt firmatoken.
Slett alle filer fra katalogen unntatt den kjørbare GroundRunner-katalogen.
Velg om GroundRunner skal kjøres som en tjeneste eller en forgrunnsprosess.
- Hvis du kjører som en tjeneste, gjør ett av følgende:
  - I kommandodialogboksen skriver du inn sc start GroundRunner.
  - I Windows Service Manager starter du GroundRunner-tjenesten.
- Hvis den kjører som en forgrunnsprosess, skriv inn følgende i kommandodialogen:
```
cd c:\Program Files (x86)\wdata GroundRunner.exe
```

GroundRunner-enheten din er nå installert og klar til aktivering.

Trinn 1. Installer GroundRunner

Last ned GroundRunners installasjonsfil til en egen katalog,
for eksempel: /home/brukernavn/wdata/.

Merk: «/home/brukernavn/wdata» er gitt som et eksempel. Følg organisasjonens retningslinjer for installasjonssteder for tjenester.
I en kommandodialogboks, pakk ut installasjonsfilen ved hjelp av:
```
unzip GroundRunner.zip
```
Skriv inn detaljene for GroundRunner.
1. Skriv inn ./installer installere
2. For autorisasjonsvertsnavnet (AUTH_HOST):
  - For APAC, skriv inn h.apac.wdesk.com/s/chains-reaper.
  - For EMEA, skriv inn h.eu.wdesk.com/s/chains-reaper.
  - For USA, Mellom-Amerika og Sør-Amerika, skriv inn h.app.wdesk.com/s/chains-reaper.
3. Skriv inn ditt firmatoken.
Slett alle filer fra katalogen unntatt mappen som ble opprettet under installasjonsprosessen.

Trinn 2. Konfigurer GroundRunner som en systemd-tjeneste (Linux)

For å sikre at automatiske oppdateringer i GroundRunner fungerer, og for god GroundRunner-hygiene, må GroundRunner installeres som en aktivert, omstartbar systemd-tjeneste. Se dokumentasjonen og organisasjonens retningslinjer for operativsystemet ditt om hvordan du kjører GroundRunner som en systemd-tjeneste.

For grunnleggende konfigurasjoner har vi følgende krav til systemd-enhetsfilen for at automatiske oppdateringer skal fungere ordentlig:

Sørg for at den kjørbare filen ExecStart peker til binærfilen GroundRunnerMonitor og IKKE binærfilen
GroundRunner.
Sett Omstart = alltid.
Ikke angi StartLimitBurst eller StartLimitIntervalSec, da disse kan forhindre at GroundRunner starter på nytt på grunn av forbigående feil. Hvis du ønsker at GroundRunner ikke skal havne i en rask omstartsløkke, kan du konfigurere RestartSec.
Skriv inn systemctl enable for å aktivere systemd GroundRunner-tjenesteenheten slik at GroundRunner overlever en omstart.

Workiva støtter ikke offisielt å kjøre en GroundRunner som en forgrunnsprosess. Dette kan være nyttig for å teste en konfigurasjon, men når en GroundRunner er konfigurert, bør den settes opp som en langvarig bakgrunnsprosess.

Bruk av GroundRunners på macOS (kun testing)

Workiva støtter GroundRunners på macOS kun for testformål. Selv om macOS GroundRunners kan kjøre de samme kommandoene som Linux- og Windows-versjonene, støtter ikke Workiva offisielt launchd som en gyldig tjenestebehandler. Dette er fordi Apple avviklet støtten for macOS-serverprogramvaren sin i 2022. Apple bærbare og stasjonære datamaskiner er ikke egnet for å kjøre GroundRunners.

Aktiver GroundRunner

Etter at du har installert GroundRunner, må du aktivere den i Chain Builder.

Klikk på Tilkoblingeri sidefeltet i Kjedebyggeren.
Klikk på Løpere øverst, og klikk deretter på Venter på registrering.
Skriv inn et kort, beskrivende navn for løperen.
For eksempel "<datasource> "-GroundRunner".
Klikk på Aktiver.

Oppdater en GroundRunner manuelt

Selv om dette sjelden er nødvendig, kan det hende du må oppgradere en GroundRunner manuelt.
Se Workiva-støttesiden GroundRunner Manual-oppdatering for instruksjoner om hvordan du gjør dette.

Avinstaller en GroundRunner

Hvis du ikke lenger trenger en GroundRunner, kan du avinstallere den.

Fra Windows-innstillinger går du til Apper og funksjoner, velger GroundRunner (64-bit)og klikker på Avinstaller.

Stopp GroundRunner-tjenesten.
- Hvis den kjører som en tjeneste, bruk Windows Service Manager, eller skriv inn
  sc stop GroundRunner i et kommandovindu.
- Hvis den kjører som en forgrunnsprosess, trykk Ctrl+C.
I kommandodialogboksen skriver du inn
installer.exe avinstallersom administrator.
Slett den kjørbare mappen GroundRunner.

I kommandodialogboksen, stopp GroundRunner-tjenesten og slett den kjørbare mappen (f.eks. /home/<username> /wdata/Innhold).

Installere en tilpasset JRE

Om nødvendig kan du installere din egen JRE for å støtte en GroundRunner. Java-versjonen av denne JRE-en må samsvare med den som kreves for Groundrunner. Bortsett fra Oracle Essbase ogOracle Hyperion Financial Management (HFM) GroundRunners, bruker alle GroundRunners samme JRE-versjon.Hvis du vil ha informasjon om hvordan du installerer en tilpasset JRE, kan du se Deaktiver delte Workiva-biblioteker.

GroundRunner-konfigurasjonsinnstillinger og utgående domener

For å aktivere kommunikasjon med datakilden, må du kanskje åpne brannmurporter på serveren der GroundRunner er installert. For å endre konfigurasjonsinnstillingene for noen GroundRunner-filer, kan du redigere filen GroundRunner.configi katalogen der binærfilene er installert.

Konfigurasjon	Innstillinger
HAVN	0 til 65535. Som standard bruker GroundRunners port 8821 for å kommunisere med hverandre. En port er imidlertid bare nødvendig hvis GroundRunnere på forskjellige servere deler kommandoutganger i nettverket ditt.
COMPANY_TOKEN	La som standard, med mindre GroundRunner er konfigurert for en annen leietaker.
LOGGNIVÅ	Info eller feilsøking
PROTOKOLL	La som standard.
HTTP_PROXY_URL	Hvis du bruker en proxy-server, skriver du inn URL-en og porten (hvis nødvendig). For eksempel, `http://dinproxy:3000` Merk: GroundRunners kan bruke proxy-servere, men ikke de som er autentisert via New Technology LAN Manager (NTLM). Tillat i stedet serverens IP-adresse.
LANG_AVSTEMNING	Hvis du bruker en proxy-server, sett til sann for å instruere løperen til å bruke long-polling for å hente kommandoer. For å sikre ytelse, bruk long-polling bare hvis web sockets ikke støttes av proxy-serveren eller brannmuren din.
INGEN_PROXY	For å omgå proxy-serveren, oppgi i stedet en kommaseparert liste over verter som skal nås direkte. For å inkludere flere verter basert på et felles mønster, bruk jokertegnet *.
BANESLØPER_CERT	Nødvendig hvis du bruker mer enn én GroundRunner og ønsker å sende kryptert informasjon til den andre GroundRunneren. Dette må brukes sammen med PORT. Du må også spesifiserePROTOCOL -feltet som HTTPS når du aktiverer løperen.
BANKELØPER_CERT_KEY	Nødvendig hvis du bruker mer enn én GroundRunner og ønsker å motta kryptert informasjon fra en annen GroundRunner. Dette må også brukes sammen med PORT.
DEAKTIVER_NETTSOKKETER	Websockets er nødvendige for å kjøre transformasjoner. Når den er deaktivert, vil alle kommandoer som bruker transformasjoner bli hoppet over fullstendig.

Merknad: Det selvsignerte sertifikatet ditt må ha et alternativt emnenavn (SAN). Hvis den ikke gjør det, vil GroundRunner vise en feilmelding som refererer til det manglende SAN-et når den prøver å laste ned filer.

Hvis nettverket ditt må tillate utgående domener, gjelder disse for GroundRunners:

Domene	Hensikt
`h.app.wdesk.com` `h.apac.wdesk.com` `h.eu.wdesk.com`	De viktigste underdomenene for vanlige Workiva-tjenester, inkludert Wdata.
`*.wdesk.com`	Hoveddomenet for produksjonsplattformen Workiva.
`..wdesk.com`	Underdomenene for støttekomponenter i Workiva-plattformen.

Sikkerhet

GroundRunners samler aldri inn eller aggregerer data; de beholder data kun under overføring. Et utvidet valideringssertifikat (EV) krypterer og beskytter alltid trafikk mellom en GroundRunner og dens datakilde via DigiCert®.

Merk: For å sikre lokale data kan CloudRunnere dele utdata med GroundRunnere, men GroundRunnere kan ikke dele filutdata med CloudRunner.

Feilsøk GroundRunner-feil

Hvis du får disse feilmeldingene når en kjede kjører, sjekk kommandoens GroundRunners.

Tips: For å forenkle feilsøkingen kan du opprette en kjede for å automatisk laste ned en GroundRunner-loggfil til en tabell.

Feilmelding	Forårsake	Oppløsning
Kunne ikke kommunisere med agenten – denne kommandoen ble ikke utført	Kommandoen kunne ikke kommunisere med sin GroundRunner. Hvis dette skjer, startet ikke GroundRunner, eller det har oppstått et nettverksavbrudd mellom GroundRunner og Chain Builder.	Verifisere: GroundRunner-tjenesten fungerer. GroundRunner-serveren er koblet til internett.
Kan ikke laste ned ressurser tilknyttet kommandoen. Kontakt kundestøtte hvis feilen vedvarer.	Løperne som er tilknyttet disse kjedens kommandoer kan ikke kommunisere med hverandre. Dette skjer ofte når kommandoer bruker forskjellige løpere og CloudRunner prøver å bruke en filutdata fra en GroundRunner-basert kommando.	Bruk samme løper med alle kommandoene i kjeden. Hvis kjedens kommandoer krever flere løpere, må du bekrefte at ingen kommandoer med GroundRunners sender filutdata til kommandoer som bruker CloudRunner.
Feil ved oppstart av kommando: `exec: \\[connector].exe\": filen finnes ikke" commandExecutorId=[ID]`	Et skadelig programvare- eller antivirusprogram identifiserte koblingen feilaktig og avlyttet kommunikasjonen med GroundRunner.	Ekskluder GroundRunner-installasjonskatalogen fra programmets skanninger.
Sertifikatfeil	Bruk av selvsignerte sertifikater	I mange tilfeller vil det være praktisk å bruke selvsignerte sertifikater for å kryptere GroundRunner-kommunikasjon. Hvis du bruker et selvsignert sertifikat, må du sørge for atFellesnavn på sertifikatet samsvarer med URL-adressen der serveren kan nås. Hvis for eksempel GroundRunner-en din lytter på port 8821 og du kan få tilgang til serveren fra nettverket ditt `localhost`, vil sertifikatets Common Name være "`localhost`".
Periodisk kjedefeil med feil: "Tilkobling tilbakestilt av motpart"	Når flere løpere er installert på samme maskin, må hver av dem ha en unik GUID. Hvis samme GUID brukes, kan løperne overlappe hverandre og gå inn i en oppdateringsløkke – noe som kan forårsake sporadiske kjedefeil.	Vi anbefaler en fullstendig ny installasjon av GroundRunner.
Kommandoer hoppes over på GroundRunner, men lykkes på CloudRunner	Websockets er nødvendige for å kjøre transformasjoner. Når websockets er deaktivert, vil alle transformasjoner bli hoppet over fullstendig.	Åpne konfigurasjonsfilen din og sett `DISABLE_WEBSOCKETS=false`.
Feil ved lesing fra socket. `Prøver tilkobling på nytt: les tcp<IP> :<Port> -> : : wsarecv: Et tilkoblingsforsøk mislyktes fordi den tilkoblede parten ikke svarte riktig etter en stund, eller den etablerte tilkoblingen mislyktes fordi den tilkoblede verten ikke svarte.`	Intern brannmur eller nettverksproblem	Be det interne IT- eller nettverksteamet ditt om å gjennomgå loggene og konfigurasjonen for å løse feilen.
lese<IP> :<Port> -> : : `wsarecv: En eksisterende forbindelse ble tvunget til å lukkes av den eksterne verten`	Intern brannmur eller nettverksproblem	Be det interne IT- eller nettverksteamet ditt om å gjennomgå loggene og konfigurasjonen for å løse feilen.

Ytterligere ressurser

Støtte

Fellesskap

Workiva kundestøttesenter