GroundRunners maken interactie mogelijk tussen chain commands en systemen op locatie of gegevensbronnen op afstand die anders niet toegankelijk zijn via het internet. Ze worden meestal geïnstalleerd op een speciale server, zoals de server waarop je verbonden gegevensbron staat, door een IT-professional of iemand anders die bekend is met de netwerkinstellingen van je organisatie.
Alvorens een GroundRunner op te zetten, raden we aan om de Chain Builder beveiligingsarchitectuurdoor te nemen.
Vereisten
Een compatibel besturingssysteem is vereist, en als je GroundRunner toegang krijgt tot gedeelde bronnen zoals een Windows Universal Naming Convention (UNC) pad, dan is ook een gebruikersaccount met voldoende rechten nodig.
De Java Runtime Environment (JRE) heeft een licentie onder de GPL v2, maar valt onder de classpath exception.
Opmerking: Om aangepaste certificaten te gebruiken met uw Java-installatie, of om Workiva's gedeelde bibliotheken gewoon niet te gebruiken, zie onze Aangepaste certificaten gebruiken met GroundRunners artikel.
De GroundRunner downloaden
Om een GroundRunner te downloaden voor installatie of handmatige update:
- Selecteer in Chain Builder Instellingen in de zijbalk.
- Klik bovenaan op Downloads .
- Zoek de GroundRunner voor uw besturingssysteem en klik op Download aan de rechterkant.
Installeer de GroundRunner
De Microsoft Installer (MSI) vereist .NET 3.5 of hoger. Als je niet aan deze eis kunt voldoen, installeer GroundRunner dan via de opdrachtregelinterface.
Om de GroundRunner te installeren:
- Pak het bestand windows_amd64_ground_runner.zip uit.
- Voer GroundRunner.msi uit om de GroundRunner Setup Wizard te starten.
- Klik op Volgende.
- Bekijk en accepteer de voorwaarden in de licentieovereenkomst en klik op Volgende.
- Voer voor de bestemmingsmap het pad in waar de GroundRunner wordt geïnstalleerd (zoals
C:\Program Files\GroundRunner) en klik op Volgende. - In Platform bedrijfstoken, voer je bedrijfstokenin.
- In Platform auth host:
- Als u in Noord-Amerika bent, voer dan
h.app.wdesk.com/s/wdata/oc/app in - Als u in Europa bent, voer dan
h.eu.wdesk.com/s/wdata/oc/app in - Als u zich in APAC bevindt, voer dan
h.apac.wdesk.com/s/wdata/oc/app in
- Als u in Noord-Amerika bent, voer dan
- Als u een proxyserver gebruikt, voert u de URL en poort daarvan in Proxy host. (Bijvoorbeeld http://yourproxy:3000.)
- Om de proxyserver te omzeilen, voert u een door komma's gescheiden lijst met hosts in onder No proxy host.
- Klik op Volgende, Installeren, en Voltooien.
- Klik na de installatie met de rechtermuisknop op GroundRunner in Windows Service Manager en selecteer Start.
Je GroundRunner is nu geïnstalleerd en klaar voor activering.
Om te installeren via de command line interface, moet je de GroundRunner installatie downloaden naar zijn eigen directory binnen je programmabestanden (zoals c:\Program Files (x86)\wdata). Daarna kun je het installatiebestand uitpakken en in de root van de map plaatsen.
Vervolgens kun je de GroundRunner :
- Voer vanuit de Windows CLI het commando
c:\Program Files (x86)\wdata-installer.exe installuit en accepteer alle standaardinstellingen.- Maak voor het pad een map Files aan in de nieuwe map (bijvoorbeeld
C:\Program Files (x86)\WdataFiles). - Voor de autorisatiehostnaam (AUTH_HOST):
- Als u in Noord-Amerika bent, voer dan
h.app.wdesk.com/s/wdata/oc/app in - Als u in Europa bent, voer dan
h.eu.wdesk.com/s/wdata/oc/app in - Als u zich in APAC bevindt, voer dan
h.apac.wdesk.com/s/wdata/oc/app in
- Als u in Noord-Amerika bent, voer dan
- Voer uw bedrijfstoken in.
- Maak voor het pad een map Files aan in de nieuwe map (bijvoorbeeld
- Verwijder alle bestanden uit de directory behalve de GroundRunner executable directory.
- Selecteer of de GroundRunner als service of als voorgrondproces moet worden uitgevoerd.
- Als het als een service wordt uitgevoerd, doe dan een van de volgende dingen:
- Voer in de CLI het commando
sc start GroundRunner in - Start in Windows Servicebeheer de service HostRunner
- Voer in de CLI het commando
- Als het als voorgrondproces wordt uitgevoerd, voer dan deze commando's in de CLI in:
cd c:Program Files (x86)\wdata GroundRunner.exe
- Als het als een service wordt uitgevoerd, doe dan een van de volgende dingen:
Stap 1. Installeer de GroundRunner
- Download het installatiebestand van GroundRunner naar zijn eigen directory, zoals
/home/<username>/wdata/. - Pak het installatiebestand uit in een CLI:
- Gebruik voor Linux het commando
unzip linux_amd64_ground_runner.zip - Voor macOS gebruik je het commando
unzip GroundRunner.zip
- Gebruik voor Linux het commando
- Voer de gegevens van de GroundRunner in.
- Gebruik voor zowel Linux als Mac OS de opdracht
<!--sudo -->./installer install - Voor de autorisatiehostnaam (AUTH_HOST):
- Als u in Noord-Amerika bent, voer dan
h.app.wdesk.com/s/wdata/oc/app in - Als u in Europa bent, voer dan
h.eu.wdesk.com/s/wdata/oc/app in - Als u zich in APAC bevindt, voer dan
h.apac.wdesk.com/s/wdata/oc/app in
- Als u in Noord-Amerika bent, voer dan
- Voer uw bedrijfstoken in.
- Gebruik voor zowel Linux als Mac OS de opdracht
- Verwijder alle bestanden uit de directory behalve de GroundRunner executable directory.
Stap 2. Selecteer of u het als service of als voorgrondproces wilt uitvoeren
Voer in de CLI de volgende commando's in om de GroundRunner als achtergrond service of als voorgrond proces te draaien.
Achtergrond service
Als het wordt uitgevoerd vanuit het standaard OS init programma, kun je het draaien als een achtergrond service:
/home/[gebruikersnaam]/wdata/Contents/GroundRunnerMonitor
Voorgrondproces
Om het als een voorgrondproces uit te voeren met logs die naar de console worden geschreven:
cd home/[gebruikersnaam]/wdata/Content sudo ./GroundRunner
Om het als een voorgrondproces te draaien en de logs naar een logbestand te schrijven:
cd home/[gebruikersnaam]/wdata/Contents sudo ./GroundRunnerMonitor
Activeer de GroundRunner
Na het installeren van uw GroundRunner, moet u deze activeren binnen Chain Builder.
- Selecteer in Chain Builder Instellingen in de zijbalk.
- Klik bovenaan op Runners .
- Voer onder In afwachting van registratieeen korte, beschrijvende naam voor de loper in (zoals <databron>-GroundRunner).
- Klik op Activeren.
Een GroundRunner handmatig bijwerken
Het komt zelden voor dat je een GroundRunner handmatig moet upgraden.
Download en installeer de nieuwste MSI en verwijder eerder gedownloade versies.
- Download de nieuwste GroundRunner voor uw besturingssysteem.
- In Windows Services Manager, stop de GroundRunner service.
- Verplaats het gedownloade GroundRunner installatiebestand naar zijn eigen directory - bijvoorbeeld
c:\groundrunner_upgrade- en pak de bestanden uit. - Kopieer en plak GroundRunner.exe en GroundRunnerMonitor.exe in de directory waar de GroundRunner binaries zijn geïnstalleerd.
- In Windows Services Manager, herstart de GroundRunner service.
- Download de nieuwste GroundRunner voor uw besturingssysteem.
- Ga op de server waarop de GroundRunner draait naar de directory waar de service draait.
- In een CLI, stop de GroundRunner service.
- Verplaats het gedownloade GroundRunner installatiebestand naar zijn eigen directory - bijvoorbeeld
/home/<username>/groundrunner_upgrade/- en pak de bestanden uit. - Kopieer en plak GroundRunner.exe en GroundRunnerMonitor.exe in de directory waar de GroundRunner binaries zijn geïnstalleerd.
- Om de GroundRunner service te herstarten, voer je deze commando's in de CLI in:
cd /home/<username>/wdata/Contents
./GroundRunner
Een GroundRunner verwijderen
Als je een GroundRunner niet langer nodig hebt, kun je deze verwijderen.
- Stop de GroundRunner-service.
- Als het als een service draait, gebruik dan Windows Service Manager of voer het commando
sc stop GroundRunnerin de CLI in. - Als het als voorgrondproces wordt uitgevoerd, druk dan op de toetsenreeks <ctrl> <c>.
- Als het als een service draait, gebruik dan Windows Service Manager of voer het commando
- Voer in de CLI als beheerder de opdracht
installer.exe uninstallin. - Verwijder de map
GroundRunnerexecutable.
Stop in de CLI de GroundRunner service en verwijder de executable directory (bijv. /home/<username>/wdata/Contents).
GroundRunner configuratie-instellingen en uitgaande domeinen
Om communicatie met de databron mogelijk te maken, kan het nodig zijn om firewall poorten te openen op de server waar GroundRunner is geïnstalleerd. Om de configuratie-instellingen van sommige GroundRunners te wijzigen, kun je het bestand GroundRunner.config bewerken in de directory waar de binaries zijn geïnstalleerd.
| Configuratie | Instellingen |
|---|---|
| PORT |
0 tot 65535. Standaard gebruiken GroundRunners poort 8821 om met elkaar te communiceren. Een poort is echter alleen nodig als GroundRunners op verschillende servers commando-uitgangen binnen je netwerk delen. |
| BEDRIJFSTOKEN | Standaard laten staan, tenzij de GroundRunner is geconfigureerd voor een andere huurder. |
| LOG_LEVEL | Info of debug |
| PROTOCOL | Standaard laten staan. |
| HTTP_PROXY_URL |
Als u een proxyserver gebruikt, voer dan de URL en poort in (indien nodig). Bijvoorbeeld Opmerking: GroundRunners mogen proxyservers gebruiken, maar niet die geverifieerd zijn via New Technology LAN Manager (NTLM). Laat in plaats daarvan het IP-adres van de server toe. |
| LANG_POLL | Als een proxyserver wordt gebruikt, stel deze dan in op true om de runner te instrueren om long-polling te gebruiken om commando's op te halen. Om prestaties te garanderen, gebruik je long-polling alleen als web sockets niet worden ondersteund door je proxyserver of firewall. |
| GEEN_PROXY | Om de proxyserver te omzeilen, geef je een door komma's gescheiden lijst van hosts op die je in plaats daarvan rechtstreeks kunt bereiken. Gebruik het jokerteken * om meerdere hosts op te nemen op basis van een gemeenschappelijk patroon. |
| GRONDLOPER_CERTIFICAAT |
Nodig indien je meer dan één GroundRunner gebruikt en versleutelde informatie naar de tweede GroundRunner wilt sturen.Moet worden gebruikt in combinatie met PORT. Je moet ook het veld PROTOCOL opgeven als HTTPS wanneer je de runner activeert. |
| GRONDLOPER_CERTIFICAAT_SLEUTEL | Nodig als je meer dan één GroundRunner gebruikt en versleutelde informatie van een tweede GroundRunner wilt ontvangen.Moet ook worden gebruikt in combinatie met PORT. |
| UITSCHAKELEN_WEBSOCKETS | Websockets zijn nodig om transformaties uit te voeren. Als deze optie is uitgeschakeld, worden alle commando's die transformaties gebruiken volledig overgeslagen. |
Opmerking: Je zelfondertekende certificaat moet een SAN (Subject Alternative Name) hebben. Als dit niet het geval is, zal GroundRunner bij het downloaden van bestanden een foutmelding geven over het ontbrekende SAN.
Als je netwerk uitgaande domeinenmoet toestaan, zijn deze van toepassing op GroundRunners:
| Domein | Doel |
|---|---|
|
|
De belangrijkste subdomeinen voor veelgebruikte Workiva-services, waaronder Wdata. |
*.wdesk.com |
Het hoofddomein voor het Workiva productieplatform. |
*.*.wdesk.com |
De subdomeinen voor ondersteunende componenten in het Workiva platform. |
Beveiliging
GroundRunners verzamelt of aggregeert nooit gegevens; ze bewaren gegevens alleen tijdens de overdracht. Een extended validation (EV) certificaat versleutelt en beschermt het verkeer tussen een GroundRunner en zijn databron altijd via DigiCert®.
Opmerking: Om on-premises gegevens te beveiligen, kunnen CloudRunners uitvoer delen met GroundRunners, maar GroundRunners kunnen geen bestandsuitvoer delen met CloudRunner.
GroundRunner fouten oplossen
Als je deze fouten krijgt wanneer een ketting wordt uitgevoerd, controleer dan de GroundRunners van de opdracht.
Tip: Om het oplossen van problemen te vergemakkelijken, kun je een ketting aanmaken om automatisch het logbestand van een GroundRunner naar een tabel te downloaden.
| Foutmelding | Oorzaak | Resolutie |
|---|---|---|
| Communiceren met agent mislukt - dit commando is niet uitgevoerd |
Het commando kon niet communiceren met zijn GroundRunner. Als dit gebeurt, is de GroundRunner niet gestart of is er een netwerkstoring opgetreden tussen de GroundRunner en Chain Builder. |
Controleren:
|
| Kan bronnen behorende bij opdracht niet downloaden. Neem contact op met Support als de fout zich blijft voordoen. |
De lopers die geassocieerd zijn met deze kettingcommando's kunnen niet met elkaar communiceren. Dit gebeurt vaak wanneer commando's verschillende runners gebruiken en de CloudRunner een bestand probeert te gebruiken dat wordt uitgevoerd door een GroundRunner-gebaseerd commando. |
Gebruik dezelfde loper voor alle commando's in de keten. Als de commando's van de keten meerdere runners vereisen, controleer dan of er geen commando's met GroundRunners bestandsuitvoer doorgeven aan commando's die de CloudRunner gebruiken. |
| Fout bij het starten van opdracht: exec: [connector].exe: bestand bestaat niet" commandExecutorId=[ID] | Een malware- of antivirusprogramma heeft de connector verkeerd geïdentificeerd en de communicatie met de GroundRunner onderschept. | Sluit de GroundRunner installatiedirectory uit van de scans van de applicatie. |
| Fouten in certificaten | Zelf ondertekende certificaten gebruiken |
In veel gevallen zal het handig zijn om self-signed certificaten te gebruiken om GroundRunner communicatie te versleutelen. Als je een zelfondertekend certificaat gebruikt, zorg er dan voor dat de Common Name van het certificaat overeenkomt met de URL waarop de server bereikbaar is. Als je GroundRunner bijvoorbeeld luistert op poort 8821 en je hebt toegang tot de server vanaf je netwerk localhost, dan zou de Common Name van het certificaat localhostzijn. |
| Intermitterende kettingfout met fout: "Verbinding gereset door peer". |
Als er meerdere runners op dezelfde machine zijn geïnstalleerd, moeten ze elk een unieke GUID hebben. Als dezelfde GUID wordt gebruikt, kunnen de runners elkaar overlappen en in een updatelus terechtkomen -- wat af en toe kettingfouten veroorzaakt. |
We raden een volledige herinstallatie van GroundRunner aan.
|
| Commando's worden overgeslagen op GroundRunner maar slagen op CloudRunner | Websockets zijn nodig om transformaties uit te voeren. Als websockets zijn uitgeschakeld, worden alle transformaties volledig overgeslagen. |
Open je config-bestand en stel
|