All'interno delle catene, per "libreria condivisa" si intende qualsiasi libreria o dipendenza esterna necessaria per il corretto funzionamento di un connettore. These shared libraries are maintained, updated, and distributed by Workiva directly (with a few exceptions, noted below). Al momento, Java 21 è l'unica libreria condivisa, ma altre dipendenze possono essere aggiunte se necessario.
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.
Esempio
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
Un Java Runtime Environment (JRE) non viene installato con GroundRunner durante l'installazione iniziale di GroundRunner. Al termine dell'installazione e quando GroundRunner è in funzione, scaricherà automaticamente un JRE per eseguire i comandi che dipendono da Java. Non è richiesta alcuna installazione o intervento dell'amministratore e il JRE recuperato non influisce sulle installazioni JRE esistenti se presenti sull'host.
Learn more about GroundRunner requirements.
Connettori esclusi
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.