Workiva-ondersteuningscentrum

GroundRunners maken interactie mogelijk tussen kettingcommando's en systemen op locatie of gegevensbronnen op afstand die anders niet toegankelijk zijn via het internet. 

Om een aangepast certificaat te gebruiken, moet een IT-professional of iemand anders die bekend is met de netwerkinstellingen van uw organisatie het certificaat importeren in de certificatenopslag van uw systeem en de standaard gedeelde bibliotheken van Workiva uitschakelen.

Vereisten

• Een IT-professional wordt aanbevolen bij het gebruik van een aangepast certificaat. Workiva Support kan niet helpen met deze installatie.
• Een ondersteund besturingssysteem is vereist.
• Een Java Runtime Environment (JRE) wordt niet met de GroundRunner geïnstalleerd tijdens de initiële GroundRunner installatie. Nadat de setup voltooid is en GroundRunner draait, zal het automatisch een JRE downloaden indien nodig 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 als die bestaan op de host. Meer informatie over de vereisten voor GroundRunner.
• Sommige connectoren zijn niet compatibel met Workiva's gedeelde bibliotheken en moeten de GroundRunner systeem Java installatie gebruiken. Zie de uitsluitingenlijst.

Het aangepaste certificaat importeren

Bij gebruik van een zelfondertekend certificaat of een certificaat dat niet is uitgegeven door de Certificate Authority, moeten uw GroundRunners de certificatenopslag van het systeem gebruiken.

Om een certificaat te importeren:

1. Neem contact op met uw IT-beheerder om een kopie te krijgen van het certificaat dat wordt gebruikt om uw site te beveiligen, of exporteer het vanuit uw browser.
2. Importeer het certificaat in de certificaatbewaarplaats van het systeem. Hieronder vindt u de geldige locaties.

Geldige locaties

In vorige GroundRunner versies werden aangepaste certificaten gelezen uit het cacerts bestand in de JRE/JDK installatiedirectory. Deze functionaliteit is gewijzigd, zodat aangepaste certificaten alleen van de volgende locaties kunnen worden gelezen.

Workiva gedeelde bibliotheken uitschakelen

Binnen ketens is een "gedeelde bibliotheek" elke externe bibliotheek of afhankelijkheid die nodig is voor de goede werking van een connector. Deze gedeelde bibliotheken worden rechtstreeks door Workiva onderhouden, bijgewerkt en gedistribueerd (met enkele uitzonderingen). Op dit moment is Java 21 onze enige gedeelde bibliotheek, maar aanvullende afhankelijkheden kunnen indien nodig worden toegevoegd.

Om gedeelde bibliotheken uit te schakelen en uw eigen zelfgeïnstalleerde bibliotheek te vervangen, voegt u een nieuwe configuratieoptie toe aan uw GroundRunner.config bestand:

SHARED_LIBRARY_OVERRIDES=java-21=/path/to/java21/home,java-24=/path/to/java24/home

Het pad dat in deze override wordt opgegeven, moet geldig zijn, en het moet een map bevatten met de naam bin die de relevante uitvoerbare bestanden bevat. Het pad zelf mag echter niet de bin directory bevatten.

Voorbeeld

Beschouw de mapstructuur van een voorbeeld van een Java-installatie: ~/.asdf/installs/java/corretto-21.0.6.10.1 ❯ tree -L 1

. ├── ADDITIONAL_LICENSE_INFO ├── ASSEMBLY_EXCEPTION ├ LICENSE── README.md ├── bin ├── commitId.txt ├── conf ├────── jmods ├── legal ├── lib ├── man ├── release └── version.txt

U ziet de map bin in onze bestandsstructuur. Belangrijk is dat deze subdirectory niet is opgenomen in ons opgegeven pad.

In plaats daarvan ziet de override in ons GroundRunner.config bestand er als volgt uit:

 SHARED_LIBRARY_OVERRIDES=java-21=/Users/username/.asdf/installs/java/corretto-21.0.6.10.1

En op een Windows-machine zou het er ongeveer zo uitzien:

SHARED_LIBRARY_OVERRIDES=java-21=C:\Program Files\Java=jre-21 Opmerking

: Zorg ervoor dat uw Windows-installatie backslashes gebruikt in het opgegeven pad.

Probleemoplossing

De GroundRunner start niet als:

• Een van de paden in uw configuratiebestand bestaat niet
• De paden bevatten geen subdirectory bin

Uitgesloten connectoren

Deze connectoren zijn niet compatibel met Workiva's gedeelde bibliotheken en moeten de GroundRunner systeem Java installatie gebruiken:

• Oracle Essbase
• Oracle Hyperion Financieel Beheer (HFM)

Deze connectors gebruiken nog steeds aangepaste certificaten die uit het bestand cacerts worden gelezen.

Opmerking: Wanneer "ondersteunde" connectoren op dezelfde GroundRunner worden uitgevoerd als een uitgesloten connector, zullen de ondersteunde connectoren nog steeds standaard Workiva's gedeelde bibliotheken gebruiken. U kunt dit opheffen door de optie SHARED_LIBRARY_OVERRIDES te configureren, zoals beschreven in dit artikel.