Centro assistenza di Workiva

I GroundRunner consentono ai comandi a catena di interagire con sistemi in sede o con fonti di dati remote non altrimenti accessibili via internet. 

Per utilizzare un certificato personalizzato, un professionista IT o una persona che conosca le impostazioni di rete della tua organizzazione deve importare il certificato nell'archivio dei certificati del sistema e disattivare le librerie condivise predefinite di Workiva.

Requisiti

• Quando si utilizza un certificato personalizzato, si consiglia di rivolgersi a un professionista dell'IT. L'assistenza di Workiva non è in grado di fornire assistenza per questa installazione.
• È necessario un sistema operativo supportato.
• 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. Per saperne di più sui requisiti di GroundRunner.
• Alcuni connettori non sono compatibili con le librerie condivise di Workiva e devono utilizzare l'installazione Java di sistema di GroundRunner. Consulta l'elenco delle esclusioni.

Importa il certificato personalizzato

Se utilizzi un certificato autofirmato o non rilasciato da un'autorità di certificazione, i tuoi GroundRunner devono utilizzare l'archivio dei certificati del sistema.

Per importare un certificato:

1. Contatta il tuo amministratore IT per ottenere una copia del certificato utilizzato per proteggere il tuo sito o esportalo dal tuo browser.
2. Importa il certificato nel keystore dei certificati del sistema. Le posizioni valide sono elencate di seguito.

Posizioni valide

Nelle versioni precedenti di GroundRunner, i certificati personalizzati venivano letti dal file cacerts nella directory di installazione di JRE/JDK. Questa funzionalità è stata modificata in modo che i certificati personalizzati possano essere letti solo dalle seguenti posizioni.

Disabilita le librerie condivise di Workiva

All'interno delle catene, per "libreria condivisa" si intende qualsiasi libreria o dipendenza esterna necessaria per il corretto funzionamento di un connettore. Queste librerie condivise sono mantenute, aggiornate e distribuite direttamente da Workiva (con alcune eccezioni). Al momento, Java 21 è l'unica libreria condivisa, ma altre dipendenze possono essere aggiunte se necessario.

Per disabilitare le librerie condivise e sostituire le librerie autoinstallate, aggiungi una nuova opzione di configurazione al tuo file GroundRunner.config:

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

Il percorso fornito in questo override deve essere valido e deve contenere una cartella denominata bin che contenga i relativi eseguibili. Tuttavia, il percorso stesso non deve includere la cartella bin.

Esempio

Consideriamo la struttura delle cartelle di un'installazione Java di esempio: ~/.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

Noterai la cartella bin nella nostra struttura di file. È importante notare che questa sottodirectory non è inclusa nel percorso fornito.

Invece, l'override nel nostro file GroundRunner.config ha il seguente aspetto:

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

Su un computer Windows, il percorso dovrebbe essere simile a questo:

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

Nota: Assicurati che l'installazione di Windows utilizzi i backslash nel percorso fornito.

Risoluzione dei problemi

GroundRunner non si avvia se:

• Uno qualsiasi dei percorsi indicati nel tuo file di configurazione non esiste
• I percorsi non contengono una sottodirectory bin

Connettori esclusi

Questi connettori non sono compatibili con le librerie condivise di Workiva e devono essere installati nel sistema Java di GroundRunner:

• Oracle Essbase
• Oracle Hyperion Financial Management (HFM)

Questi connettori utilizzano ancora i certificati personalizzati letti dal file cacerts.

Nota: Quando i connettori "supportati" vengono eseguiti sullo stesso GroundRunner di un connettore escluso, i connettori supportati continueranno a utilizzare le librerie condivise di Workiva per impostazione predefinita. Puoi escluderlo configurando l'opzione SHARED_LIBRARY_OVERRIDES descritta in questo articolo.