Workiva supportcenter

GroundRunners gör det möjligt för kommandokedjor att interagera med lokala system eller fjärrdatakällor som annars inte har åtkomst via internet. 

Om du vill använda ett anpassat certifikat måste en IT-proffs eller någon annan som känner till din organisations nätverksinställningar importera certifikatet till systemets certifikatarkiv och inaktivera Workivas standardiserade aktier.

Krav

• Vi rekommenderar att du anlitar en IT-expert när du använder ett anpassat certifikat. Workiva Support kommer inte att kunna hjälpa till med denna installation.
• Ett operativsystem med support krävs.
• En Java Runtime Environment (JRE) installeras inte med GroundRunner under den första GroundRunner-installationen.När installationen är klar och GroundRunner körs, laddar den automatiskt ner en JRE efter behov för att köra kommandon som är beroende av Java. Ingen installation eller administrativ åtgärd krävs, och den hämtade JRE:n kommer inte att påverka befintliga JRE-installationer om de finns på värden.Läs mer om GroundRunner-kraven.
• Vissa kontakter är inte kompatibla med Workivas aktier och måste använda GroundRunners system Java-installation. Se listan över undantag.

Importera det anpassade certifikatet

När du använder ett självsignerat certifikat eller ett certifikat som inte utfärdats av en certifikatutfärdare måste GroundRunners använda systemets certifikatarkiv.

Så här importerar du ett certifikat:

1. Kontakta din IT-administratör för att få en kopia av det certifikat som används för att säkra din webbplats, eller exportera det från din webbläsare.
2. Importera certifikatet till systemets nyckelarkiv för certifikat. Giltiga platser listas nedan.

Giltiga platser

I tidigare GroundRunner-versioner lästes anpassade certifikat in från filen cacerts i installationskatalogen för JRE/JDK. Denna funktion har ändrats så att anpassade certifikat endast kan läsas från följande platser.

Inaktivera Workivas aktierelaterade bibliotek

Inom kedjor är ett "aktie-bibliotek" ett externt bibliotek eller beroende som krävs för att en anslutning ska fungera korrekt. Dessa aktiebibliotek underhålls, uppdateras och distribueras av Workiva direkt (med några få undantag). För närvarande är Java 21 vårt enda delade bibliotek, men ytterligare beroenden kan läggas till vid behov.

Om du vill inaktivera aktiebibliotek och ersätta dem med ditt eget självinstallerade bibliotek lägger du till ett nytt konfigurationsalternativ i filen GroundRunner.config:

SHARED_LIBRARY_OVERRIDES=java-21=/sökväg/till/java21/home,java-24=/sökväg/till/java24/home

Sökvägen som anges i denna åsidosättning måste vara giltig och innehålla en mapp med namnet bin som innehåller de relevanta körbara programmen. Själva sökvägen bör dock inte innehålla bin-katalogen.

Exempel

Betrakta mappstrukturen för ett exempel på en Java-installation: ~/.asdf/installs/java/corretto-21.0.6.10.1 ❯ tree -L 1

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

Du kommer att märka bin-mappen i vår filstruktur. Det är viktigt att denna underkatalog inte ingår i vår angivna sökväg.

Istället ser åsidosättandet i vår GroundRunner.config arkivering ut så här:

 SHARED_LIBRARY_OVERRIDES=java-21=/Användare/användarnamn/.asdf/installs/java/corretto-21.0.6.10.1

Och på en Windows-maskin skulle det se ut ungefär så här:

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

Obs: Se till att din Windows-installation använder bakåtsnedstreck i den angivna sökvägen.

Felsökning

GroundRunner startar inte om:

• Någon av sökvägarna som anges i din konfigurationsfil finns inte
• Sökvägarna innehåller inte en bin underkatalog

Exkluderade kontakter

Dessa kontakter är inte kompatibla med Workivas aktiebibliotek och måste använda GroundRunners system Java-installation:

• Oracle Essbase
• Oracle Hyperion Financial Management (HFM)

Dessa anslutningar använder fortfarande anpassade certifikat som läses från filen cacerts.

Obs: När "supported" connectors körs på samma GroundRunner som en exkluderad connector, kommer de "supported" connectors fortfarande att använda Workivas aktier som standard. Du kan åsidosätta detta genom att konfigurera alternativet SHARED_LIBRARY_OVERRIDES som beskrivs i den här artikeln.