Dentro de las Cadenas, una "biblioteca compartida" es cualquier biblioteca o dependencia externa necesaria para la correcta función de un conector. These shared libraries are maintained, updated, and distributed by Workiva directly (with a few exceptions, noted below). En este momento, Java 21 es nuestra única biblioteca compartida, pero pueden añadirse dependencias adicionales según sea necesario.
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=/ruta/hacia/java21/home,java-24=/ruta/hacia/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.
Ejemplo
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
No se ha instalado un entorno de ejecución de Java (JRE) con GroundRunner durante la instalación inicial de GroundRunner. Una vez que se haya completado la instalación y el GroundRunner se esté ejecutando, descargará automáticamente una JRE según sea necesario para ejecutar comandos que dependan de Java. No se requiere instalación ni intervención del administrador, y el JRE recuperado no afectará a las instalaciones JRE existentes si existen en el servidor.
Learn more about GroundRunner requirements.
Conectores excluidos
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.