Nas cadeias, uma "biblioteca compartilhada" é qualquer biblioteca ou dependência externa necessária para o funcionamento adequado de um conector. These shared libraries are maintained, updated, and distributed by Workiva directly (with a few exceptions, noted below). No momento, o Java 21 é a nossa única biblioteca compartilhada, mas dependências adicionais podem ser adicionadas conforme necessário.
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.
Exemplo
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
Um Java Runtime Environment (JRE) não é instalado com o GroundRunner durante a instalação inicial do GroundRunner. Depois que a configuração for concluída e o GroundRunner estiver sendo executado, ele baixará automaticamente um JRE, conforme necessário, para executar comandos que dependem do Java. Não é necessária nenhuma instalação ou intervenção do administrador, e o JRE recuperado não afetará as instalações de JRE existentes, se elas existirem no host.
Learn more about GroundRunner requirements.
Conectores excluídos
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.