GroundRunners maken het mogelijk om via ketenopdrachten te communiceren met lokale systemen of externe gegevensbronnen die anders niet via internet toegankelijk zijn. Ze worden doorgaans geïnstalleerd op een speciale server, zoals de server waarop uw verbonden gegevensbron is gehost, door een IT-professional of iemand anders die bekend is met de netwerkinstellingen van uw organisatie.
Voordat u een GroundRunner instelt, raden we u aan de beveiligingsarchitectuur van Chain Builderte bekijken.
Vereisten
Een compatibel besturingssysteem is vereist, en als uw GroundRunner toegang krijgt tot gedeelde bronnen zoals een UNC-pad (Universal Naming Convention) van Windows, is ook een gebruikersaccount met voldoende rechten nodig.
Een Java Runtime Environment (JRE) wordt niet meegeleverd met GroundRunner tijdens de eerste installatie van GroundRunner.
Nadat de installatie is voltooid en GroundRunner actief is, downloadt het programma automatisch een JRE wanneer dat nodig is om commando's uit te voeren die afhankelijk zijn van Java. Er is geen installatie of tussenkomst van de beheerder nodig en de opgehaalde JRE heeft geen invloed op bestaande JRE-installaties, indien deze op de host aanwezig zijn.
Als alternatief kunt u, indien uw organisatie vereist dat een specifieke JRE wordt gebruikt, de omgevingsvariabele SHARED_LIBRARY_OVERRIDES zo instellen dat deze verwijst naar de systeeminstallatie. In dit geval zal GroundRunner niet automatisch de standaard Workiva JRE downloaden, maar de door het systeem geleverde JRE-installatie gebruiken.
De door Workiva geleverde JRE's zijn gelicentieerd onder GPL v2 en vallen onder declasspath exception.
Opmerking: ZieAangepaste certificaten gebruiken met GroundRunners voor het gebruik van aangepaste certificaten met uw Java-installatie.
Functievereisten
Op het Workiva-platform
Op het Workiva-platform heb je een rol nodig die toegang geeft tot de Chain Builder-instellingen en de mogelijkheid om Runners te beheren. Er zijn er twee:
- Keteneigenaar: Dit is de primaire vereiste rol. Gebruikers met deze rol hebben toegang tot de sectie "Downloads" in Chain Builder om de nieuwste GroundRunner-installatiebestanden op te halen en kunnen het tabblad "Runners" beheren om de service te activeren of te bewaken.
- Beveiligingsbeheerder organisatieketen: Deze rol op organisatieniveau heeft ook de bevoegdheid om verbindingen en runners te beheren in meerdere werkruimtes.
Op de server
Omdat een "handmatige update" inhoudt dat services worden gestopt en uitvoerbare bestanden worden vervangen op de fysieke of virtuele machine waarop GroundRunner is geïnstalleerd, moet de gebruiker beheerdersrechten hebben op de hostserver.
- Windows: U moet de mogelijkheid hebben om de opdrachtprompt als beheerder uit te voeren en toegang te hebben tot Windows Service Manager (om de GroundRunner-service te stoppen en opnieuw te starten).
- Linux/macOS: Je moet sudo of root toegang hebben om bestanden naar de installatiemap te verplaatsen en het achtergrondproces opnieuw te starten.
Download de GroundRunner
Om GroundRunner te downloaden voor installatie of handmatige update:
- Klik in de zijbalk van Workiva Home op Kettingen.
- Klik in de zijbalk van Chain Builder (dit is een nieuw tabblad) op Verbindingen.
Als alternatief kunt u op het gebruikersprofielpictogram rechtsboven klikken, Ketensbeheerselecteren en vervolgens Werkplekinstellingen. - Klik op Downloads in de bovenste menubalk.
- Zoek de GroundRunner-versie voor uw besturingssysteem en klik op Download om deze te downloaden.
- Zodra het programma succesvol naar uw computer is gedownload, selecteert u de juiste instructies uit de onderstaande lijst en volgt u deze om GroundRunner te installeren.
Installeer de GroundRunner
Voor het Microsoft Installer (MSI) is .NET 3.5 of hoger vereist.
Als u niet aan deze vereiste kunt voldoen, moet u GroundRunner installeren via de opdrachtregelinterface.
Om de GroundRunner te installeren:
- Pak het bestand GroundRunner.zip uit naar een nieuwe map en open die map.
- Voer GroundRunner.msi uit om de GroundRunner-installatiewizard te openen.
- Klik op Volgende.
- Lees de voorwaarden in de licentieovereenkomst door en ga ermee akkoord, en klik vervolgens op Volgende.
- Voer bij Bestemmingsmap het pad in waar GroundRunner geïnstalleerd zal worden (bijvoorbeeld:
C:\Program Files\GroundRunner\) en klik op Volgende.
- Voer in Platformbedrijfstokenuw bedrijfstokenin.
- In Platform-authenticatiehost:
- Voor APAC, voer
h.apac.wdesk.com/s/chains-reaperin. - Voor EMEA, voer
h.eu.wdesk.com/s/chains-reaperin. - Voor de Verenigde Staten, Centraal-Amerika en Zuid-Amerika, voer
h.app.wdesk.com/s/chains-reaperin.
- Voor APAC, voer
- Als u een proxyserver gebruikt, voer dan de URL en poort in Proxy host.
(Bijvoorbeeld:http://yourproxy:3000.)
Om de proxyserver te omzeilen, voert u een door komma's gescheiden lijst met hosts in onder Geen proxyhost. - Klik op Volgende, Installeren, en Voltooien.
- Na de installatie klikt u met de rechtermuisknop op GroundRunner in Windows Service Manager en selecteert u Start.
Uw GroundRunner is nu geïnstalleerd en klaar voor activering.
Om via de opdrachtregelinterface te installeren, moet u het installatiebestand van GroundRunner downloaden naar een eigen map binnen uw programmaprogramma's (bijvoorbeeld c:\Program Files (x86)\wdata). Je kunt het installatiebestand vervolgens uitpakken en in de hoofdmap van die directory plaatsen.
Je kunt GroundRunner vervolgens installeren:
- Voer in het Windows-opdrachtvenster
in en accepteer alle standaardinstellingen.c:\Program Files (x86)\wdata\installer.exe install- Selecteer "windows" voor het init-systeem.
Je moet aangeven dat GroundRunner als een Windows-service moet werken om automatische updates te kunnen ontvangen. GroundRunners mag alleen als service worden uitgevoerd, behalve voor testdoeleinden.
- Maak voor het pad een map Files aan in de nieuwe map
(bijvoorbeeldC:\Program Files (x86)\Wdata\Files). - Voor de autorisatiehostnaam (AUTH_HOST):
- Voor APAC, voer
h.apac.wdesk.com/s/chains-reaperin. - Voor EMEA, voer
h.eu.wdesk.com/s/chains-reaperin. - Voor de Verenigde Staten, Centraal-Amerika en Zuid-Amerika, voer
h.app.wdesk.com/s/chains-reaperin.
- Voor APAC, voer
- Voer uw bedrijfstokenin.
- Selecteer "windows" voor het init-systeem.
- Verwijder alle bestanden uit de map, behalve de map waarin het GroundRunner-uitvoerbestand zich bevindt.
- Selecteer of u GroundRunner als een service of als een voorgrondproces wilt uitvoeren.
- Als de applicatie als service wordt uitgevoerd, doe dan een van de volgende dingen:
- Voer in het opdrachtdialoogvenster
sc start GroundRunner. in. - Start in Windows Service Manager de service GroundRunner.
- Voer in het opdrachtdialoogvenster
- Als het programma op de voorgrond draait, typt u in het opdrachtdialoogvenster:
cd c:\Program Files (x86)\wdata GroundRunner.exe
- Als de applicatie als service wordt uitgevoerd, doe dan een van de volgende dingen:
Uw GroundRunner is nu geïnstalleerd en klaar voor activering.
Stap 1. Installeer de GroundRunner
-
Download het installatiebestand van GroundRunner naar een eigen map, bijvoorbeeld:
/home/gebruikersnaam/wdata/.Opmerking: "/home/user_name/wdata" wordt als voorbeeld gegeven. Volg het beleid van uw organisatie met betrekking tot de locaties waar services worden geïnstalleerd.
- Pak het installatiebestand uit in een opdrachtdialoogvenster met:
unzip GroundRunner.zip - Voer de gegevens van de GroundRunner in.
- Voer
./installer installin - Voor de autorisatiehostnaam (AUTH_HOST):
- Voor APAC, voer
h.apac.wdesk.com/s/chains-reaperin. - Voor EMEA, voer
h.eu.wdesk.com/s/chains-reaperin. - Voor de Verenigde Staten, Centraal-Amerika en Zuid-Amerika, voer
h.app.wdesk.com/s/chains-reaperin.
- Voor APAC, voer
- Voer uw bedrijfstokenin.
- Voer
- Verwijder alle bestanden uit de map, behalve de map die tijdens het installatieproces is aangemaakt.
Stap 2. Stel GroundRunner in als een systemd-service (Linux)
Om ervoor te zorgen dat automatische updates van GroundRunner werken, en voor een goede werking van GroundRunner, moet GroundRunner worden geïnstalleerd als een ingeschakelde, herstartbare systemd-service. Raadpleeg de documentatie van uw besturingssysteem en het beleid van uw organisatie over het uitvoeren van GroundRunner als een systemd-service.
Voor basisconfiguraties gelden de volgende vereisten voor systemd-unitbestanden om automatische updates correct te laten werken:
- Zorg ervoor dat het uitvoerbare bestand
ExecStartverwijst naar het binaire bestandGroundRunnerMonitoren NIET naar het binaire bestand
GroundRunner. - Stel
Restart=always. - Stel
StartLimitBurstofStartLimitIntervalSecniet in, aangezien dit kan voorkomen dat GroundRunner opnieuw opstart vanwege tijdelijke fouten. Als je wilt voorkomen dat de GroundRunner in een snelle herstartlus terechtkomt, kun jeRestartSecconfigureren. - Voer
systemctl enablein om de systemd GroundRunner-service-eenheid in te schakelen, zodat GroundRunner een herstart overleeft.
Workiva biedt officieel geen ondersteuning voor het uitvoeren van GroundRunner als een proces op de voorgrond. Dit kan handig zijn voor het testen van een configuratie, maar zodra GroundRunner is geconfigureerd, moet het worden ingesteld als een langdurig achtergrondproces.
GroundRunners gebruiken op macOS (alleen testen)
Workiva ondersteunt GroundRunners op macOS alleen voor testdoeleinden. Hoewel GroundRunners voor macOS dezelfde commando's kan uitvoeren als de Linux- en Windows-versies, ondersteunt Workiva launchd officieel niet als een geldige servicemanager. Dit komt doordat Apple in 2022 de ondersteuning voor hun macOS-serversoftware heeft stopgezet. Apple-laptops en -desktopcomputers zijn niet geschikt voor het spelen van GroundRunners.
Activeer de GroundRunner
Na de installatie van je GroundRunner moet je deze activeren in Chain Builder.
- Klik in de zijbalk van Chain Builder op Verbindingen.
- Klik bovenaan op Runners en vervolgens op Pending Registration.
- Voer een korte, beschrijvende naam in voor de hardloper.
Bijvoorbeeld "<datasource> -GroundRunner".
- Klik op Activeren.
Een GroundRunner handmatig bijwerken
Hoewel dit zelden nodig is, kan het voorkomen dat u een GroundRunner handmatig moet upgraden.
Raadpleeg de Workiva-ondersteuningspagina GroundRunner-handleiding bijwerken voor instructies over hoe u dit kunt doen.
Een GroundRunner verwijderen
Als je GroundRunner niet meer nodig hebt, kun je het verwijderen.
- Stop de GroundRunner-service.
- Als het als een service draait, gebruik dan Windows Service Manager of typ
sc stop GroundRunnerin een opdrachtvenster. - Als het als een voorgrondproces draait, druk dan op Ctrl+C.
- Als het als een service draait, gebruik dan Windows Service Manager of typ
- Voer in het opdrachtdialoogvenster als beheerder het volgende in:
installer.exe uninstall. - Verwijder de map met het uitvoerbare bestand
GroundRunner.
Stop in het opdrachtdialoogvenster de GroundRunner-service en verwijder de bijbehorende uitvoerbare map (bijv. /home/).<username> /wdata/Contents).
Een aangepaste JRE installeren
Indien nodig kunt u uw eigen JRE installeren ter ondersteuning van GroundRunner. De Java-versie van deze JRE moet overeenkomen met de versie die vereist is voor Groundrunner. Met uitzondering van de Oracle Essbase enOracle Hyperion Financial Management (HFM) GroundRunners, gebruiken alle GroundRunners dezelfde JRE-versie.Voor informatie over het installeren van een aangepaste JRE, zie Workiva gedeelde bibliotheken uitschakelen.
GroundRunner-configuratie-instellingen en uitgaande domeinen
Om communicatie met de gegevensbron mogelijk te maken, moet u mogelijk firewallpoorten openen op de server waarop GroundRunner is geïnstalleerd. Om de configuratie-instellingen van sommige GroundRunners te wijzigen, kunt u het bestand GroundRunner.configbewerken in de map waar de binaire bestanden zijn geïnstalleerd.
| Configuratie | Instellingen |
|---|---|
| HAVEN |
0 tot 65535. Standaard gebruiken GroundRunners poort 8821 om met elkaar te communiceren. Een poort is echter alleen nodig als GroundRunners op verschillende servers de uitvoer van commando's binnen uw netwerk delen. |
| BEDRIJFSTOKEN | Laat dit op de standaardinstelling staan, tenzij GroundRunner is geconfigureerd voor een andere tenant. |
| LOG_LEVEL | Info of debug |
| PROTOCOL | Laat dit zoals het is. |
| HTTP_PROXY_URL |
Als u een proxyserver gebruikt, voer dan de URL en poort (indien nodig) in. Opmerking: GroundRunners kunnen gebruikmaken van proxyservers, maar niet van servers die zijn geverifieerd via New Technology LAN Manager (NTLM). Sta in plaats daarvan het IP-adres van de server toe. |
| LONG_POLL | Als u een proxyserver gebruikt, stelt u deze in op 'true' om de runner te instrueren om via long-polling opdrachten op te halen. Om optimale prestaties te garanderen, gebruik long-polling alleen als uw proxyserver of firewall geen ondersteuning biedt voor websockets. |
| GEEN_PROXY | Om de proxyserver te omzeilen, kunt u in plaats daarvan een door komma's gescheiden lijst met hosts opgeven die rechtstreeks bereikbaar moeten zijn. Om meerdere hosts op basis van een gemeenschappelijk patroon op te nemen, gebruikt u het jokerteken *. |
| GROUNDRUNNER_CERT |
Nodig als u meer dan één GroundRunner gebruikt en versleutelde informatie naar de tweede GroundRunner wilt verzenden. Dit moet worden gebruikt in combinatie met PORT. Bij het activeren van de runner moet u ook het veldPROTOCOL als HTTPS opgeven. |
| GROUNDRUNNER_CERT_KEY | Nodig als u meer dan één GroundRunner gebruikt en versleutelde informatie van een tweede GroundRunner wilt ontvangen. Dit moet ook in combinatie met PORTgebruikt worden. |
| WEBSOCKETS UITSCHAKELEN | WebSockets zijn nodig om transformaties uit te voeren. Indien uitgeschakeld, worden alle opdrachten die transformaties gebruiken volledig overgeslagen. |
Opmerking: Uw zelfondertekende certificaat moet een Subject Alternative Name (SAN) bevatten. Als dit niet het geval is, zal GroundRunner een foutmelding weergeven waarin wordt verwezen naar de ontbrekende SAN wanneer het bestanden probeert te downloaden.
Als uw netwerk uitgaande domeinen moet toestaan, gelden de volgende regels voor 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 verzamelen of aggregeren nooit gegevens; ze bewaren gegevens alleen tijdens de overdracht. Een Extended Validation (EV) certificaat versleutelt en beschermt altijd het verkeer tussen een GroundRunner en de bijbehorende gegevensbron via DigiCert®.
Opmerking: Om on-premises data te beveiligen, kunnen CloudRunners uitvoer delen met GroundRunners, maar GroundRunners kunnen geen bestandsuitvoer delen met CloudRunner.
Problemen met GroundRunner oplossen
Als je deze foutmeldingen krijgt tijdens het uitvoeren van een keten, controleer dan de GroundRunners van het commando.
Tip: Om het oplossen van problemen te vergemakkelijken, kunt u een keten maken om het logbestand van een GroundRunner automatisch naar een tabelte
downloaden .| Foutmelding | Oorzaak | Oplossing |
|---|---|---|
| Communicatie met agent mislukt - deze opdracht is niet uitgevoerd. |
Het commando kon niet communiceren met zijn GroundRunner. Als dit gebeurt, is de GroundRunner niet opgestart of is er een netwerkstoring opgetreden tussen de GroundRunner en Chain Builder. |
Verifiëren:
|
| Kan de bij de opdracht gekoppelde bronnen niet downloaden. Neem contact op met de ondersteuning als de fout zich blijft voordoen. |
De medewerkers die aan deze ketencommando's zijn gekoppeld, kunnen niet met elkaar communiceren. Dit gebeurt vaak wanneer commando's verschillende runners gebruiken en de CloudRunner probeert een bestand te gebruiken dat is gegenereerd door een GroundRunner-gebaseerd commando. |
Gebruik dezelfde runner voor alle commando's in de keten. Als de commando's van de keten meerdere runners vereisen, controleer dan of er geen commando's zijn die de uitvoer van GroundRunners doorgeven aan commando's die de CloudRunner gebruiken. |
Fout bij het starten van de opdracht: exec: \"\\[connector].exe\": bestand bestaat niet" commandExecutorId=[ID] |
Een malware- of antivirusprogramma heeft de connector onjuist geïdentificeerd en de communicatie met de GroundRunner onderschept. | Sluit de installatiemap van GroundRunner uit van de scans van de applicatie. |
| Certificaatfouten | Het gebruik van zelfondertekende certificaten |
In veel gevallen is het handig om zelfondertekende certificaten te gebruiken om de GroundRunner-communicatie te versleutelen. Als u een zelfondertekend certificaat gebruikt, zorg er dan voor dat deCommon Name van het certificaat overeenkomt met de URL waarop de server bereikbaar is. Als uw GroundRunner bijvoorbeeld luistert op poort 8821 en u de server kunt benaderen vanaf uw netwerk |
| Intermitterende ketenfout met foutmelding: "Verbinding verbroken door de tegenpartij" |
Wanneer meerdere runners op dezelfde machine zijn geïnstalleerd, moet elke runner een unieke GUID hebben. Als dezelfde GUID wordt gebruikt, kunnen de runners elkaar overlappen en in een update-loop terechtkomen, wat af en toe ketenfouten kan veroorzaken. |
We raden aan GroundRunner volledig opnieuw te installeren. |
| Commando's worden overgeslagen in GroundRunner, maar slagen wel in CloudRunner. | WebSockets zijn nodig om transformaties uit te voeren. Als websockets zijn uitgeschakeld, worden alle transformaties volledig overgeslagen. | Open je configuratiebestand en stelDISABLE_WEBSOCKETS=falsein. |
Fout bij het lezen van de socket. Verbinding opnieuw proberen: tcp lezen<IP> :<Port> -> : : wsarecv: Een verbindingspoging is mislukt omdat de verbonden partij na een bepaalde tijd niet correct heeft gereageerd, of de tot stand gebrachte verbinding is mislukt omdat de verbonden host niet heeft gereageerd. |
Intern firewall- of netwerkprobleem | Schakel uw interne IT- of netwerkteam in om de logbestanden en configuratie te controleren en de fout op te lossen. |
lezen<IP> :<Port> -> : : wsarecv: Een bestaande verbinding werd door de externe host geforceerd verbroken |
Intern firewall- of netwerkprobleem | Schakel uw interne IT- of netwerkteam in om de logbestanden en configuratie te controleren en de fout op te lossen. |