Innerhalb von Ketten ist eine "gemeinsam genutzte Bibliothek" jede externe Bibliothek oder Abhängigkeit, die für die ordnungsgemäße Funktion eines Verbinders erforderlich ist. These shared libraries are maintained, updated, and distributed by Workiva directly (with a few exceptions, noted below). Zur Zeit ist Java 21 unsere einzige gemeinsam genutzte Bibliothek, aber weitere Abhängigkeiten können bei Bedarf hinzugefügt werden.
To disable shared libraries and substitute your own self-installed library, add a new configuration option to your GroundRunner.config file:
SHARED_LIBRARY_OVERRIDES=java-21=/path/to/java21/home,java-24=/path/to/java24/homeThe path provided in this override must be valid, and it must contain a folder named "bin" that contains the relevant executables. However, the path itself should not include the bin directory.
Beispiel
Consider the folder structure of a sample Java installation: ~/.asdf/installs/java/corretto-21.0.6.10.1 ❯ tree -L 1
This structure will look like this:
. ├── ADDITIONAL_LICENSE_INFO ├── ASSEMBLY_EXCEPTION ├── LICENSE ├── README.md ├── bin ├── commitId.txt ├── conf ├── include ├── jmods ├── legal ├── lib ├── man ├── release └── version.txtYou'll notice the bin folder in this file structure. This folder is not included in our provided path.
Instead, the override in the GroundRunner.config file looks like this on a Mac: SHARED_LIBRARY_OVERRIDES=java-21=/Users/username/.asdf/installs/java/corretto-21.0.6.10.1
On a Windows machine, it would look something like this: SHARED_LIBRARY_OVERRIDES=java-21=C:\Program Files\Java\jre-21
Note: Make sure your Windows install uses backslashes (\) in the provided path.
JRE installation
Eine Java-Laufzeitumgebung (JRE) wird bei der Erstinstallation des GroundRunners nicht mit installiert. Nachdem die Einrichtung abgeschlossen ist und der GroundRunner läuft, lädt er bei Bedarf automatisch eine JRE herunter, um Befehle auszuführen, die von Java abhängig sind. Eine Installation oder ein Eingriff des Administrators ist nicht erforderlich und die abgerufene JRE hat keine Auswirkungen auf bestehende JRE-Installationen, sofern diese auf dem Host vorhanden sind.
Learn more about GroundRunner requirements.
Ausgeschlossene Anschlüsse
The following connectors are not compatible with Workiva's shared libraries and must use the GroundRunner's system Java installation, as these connectors still use custom certificates that are read from the cacerts file.