Workiva kundestøttesenter

GroundRunners gjør det mulig for kjedekommandoer å samhandle med lokale systemer eller eksterne datakilder som ellers ikke er tilgjengelige via Internett. 

Hvis du vil bruke et egendefinert sertifikat, må en IT-profesjonell eller noen som på annen måte er kjent med organisasjonens nettverksinnstillinger, importere sertifikatet til systemets sertifikatlager og deaktivere Workivas standard delte biblioteker.

Krav

• Det anbefales å kontakte en IT-profesjonell ved bruk av et tilpasset sertifikat. Workiva Support kan ikke hjelpe deg med denne installasjonen.
• Det kreves et operativsystem som støttes.
• Et Java Runtime Environment (JRE) installeres ikke sammen med GroundRunner under den første installasjonen av GroundRunner. 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. Det kreves ingen installasjon eller inngripen fra administratoren, og den hentede JRE-en vil ikke påvirke eksisterende JRE-installasjoner hvis de finnes på verten. Finn ut mer om kravene til GroundRunner.
• Noen koblinger er ikke kompatible med Workivas delte biblioteker og må bruke GroundRunners system-Java-installasjon. Se ekskluderingslisten.

Importer det egendefinerte sertifikatet

Når du bruker et selvsignert sertifikat eller et sertifikat som ikke er utstedt av en sertifikatmyndighet, må GroundRunners bruke systemets sertifikatlager.

Slik importerer du et sertifikat:

1. Kontakt IT-administratoren din for å få en kopi av sertifikatet som brukes til å sikre nettstedet ditt, eller eksporter det fra nettleseren din.
2. Importer sertifikatet til systemets sertifikatnøkkelmagasin. Gyldige steder er oppført nedenfor.

Gyldige steder

I tidligere GroundRunner-versjoner ble egendefinerte sertifikater lest fra filen cacerts i JRE/JDK-installasjonskatalogen. Denne funksjonaliteten er endret slik at egendefinerte sertifikater bare kan leses fra følgende steder.

Deaktiver delte Workiva-biblioteker

Innenfor kjeder er et "delt bibliotek" et eksternt bibliotek eller en ekstern avhengighet som er nødvendig for at en kobling skal fungere korrekt. Disse delte bibliotekene vedlikeholdes, oppdateres og distribueres direkte av Workiva (med noen få unntak). For øyeblikket er Java 21 vårt eneste delte bibliotek, men flere avhengigheter kan bli lagt til etter behov.

Hvis du vil deaktivere delte biblioteker og erstatte dem med ditt eget egeninstallerte bibliotek, legger du til et nytt konfigurasjonsalternativ i filen GroundRunner.config:

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

Stien som oppgis i denne overstyringen, må være gyldig, og den må inneholde en mappe med navnet bin som inneholder de relevante kjørbare filene. Selve stien skal imidlertid ikke inneholde bin-katalogen.

Eksempel

Se på mappestrukturen i et eksempel på en Java-installasjon: ~/.asdf/installs/java/corretto-21.0.6.10.1 ❯ tree -L 1

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

Du vil legge merke til bin-mappen i filstrukturen vår. Det er viktig å merke seg at denne underkatalogen ikke er inkludert i den oppgitte stien.

I stedet ser overstyringen i GroundRunner.config-filen vår slik ut:

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

På en Windows-maskin vil det se omtrent slik ut:

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

Merknad: Kontroller at Windows-installasjonen din bruker bindestreker i den angitte banen.

Feilsøking

GroundRunner starter ikke hvis:

• Noen av stiene som er oppgitt i konfigurasjonsfilen din, eksisterer ikke
• Stiene inneholder ikke en bin underkatalog

Ekskluderte kontakter

Disse kontaktene er ikke kompatible med Workivas delte biblioteker og må bruke GroundRunners systeminstallasjon av Java:

• Oracle Essbase
• Oracle Hyperion Financial Management (HFM)

Disse kontaktene bruker fortsatt egendefinerte sertifikater som leses fra cacerts -filen.

Merk: Når "støttede" koblinger kjøres på samme GroundRunner som en ekskludert kobling, vil de støttede koblingene fortsatt bruke Workivas delte biblioteker som standard. Du kan overstyre dette ved å konfigurere SHARED_LIBRARY_OVERRIDES-alternativet som er beskrevet i denne artikkelen.