I GroundRunner consentono ai comandi a catena di interagire con sistemi on-premises o fonti di dati remote non altrimenti accessibili via internet. In genere vengono installati su un server dedicato, come quello che ospita la fonte di dati collegata, da un professionista IT o da qualcuno che conosce le impostazioni di rete della tua organizzazione.
Prima di configurare un GroundRunner, ti consigliamo di consultare l'architettura di sicurezza di Chain Builder.
Requisiti
È necessario un sistema operativo compatibile e se il GroundRunner accede a risorse condivise come un percorso Windows Universal Naming Convention (UNC), è necessario un account utente con privilegi sufficienti.
Un Java Runtime Environment (JRE) non viene installato con GroundRunner durante l'installazione iniziale di GroundRunner.
Una volta completata la configurazione e avviato GroundRunner, quest'ultimo scaricherà automaticamente un JRE, se necessario, 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.
In alternativa, se hai dei requisiti organizzativi che richiedono l'uso di una particolare JRE, la variabile d'ambiente SHARED_LIBRARY_OVERRIDES può essere impostata in modo da puntare all'installazione del sistema. In questo caso, GroundRunner non scaricherà automaticamente la JRE standard di Workiva e utilizzerà l'installazione della JRE di sistema fornita.
I JRE forniti da Workiva sono concessi in licenza GPL v2 e sono coperti dall'eccezione classpath.
Nota: Per utilizzare certificati personalizzati con la tua installazione di Java, vedi Utilizzare certificati personalizzati con GroundRunners.
Requisiti del ruolo
Sulla piattaforma Workiva
Sulla piattaforma Workiva, è necessario un ruolo che garantisca l'accesso alle impostazioni del Chain Builder e la possibilità di gestire i Runner. Ce ne sono due:
- Proprietario della catena: Questo è il ruolo principale richiesto. Gli utenti con questo ruolo possono accedere alla sezione "Download" di Chain Builder per recuperare i file di installazione di GroundRunner più recenti e gestire la scheda "Runner" per attivare o monitorare il servizio.
- Org Chain Security Admin: Questo ruolo di livello organizzativo ha anche l'autorità di gestire le connessioni e i corridori in più spazi di lavoro.
Sul server
Poiché un "aggiornamento manuale" comporta l'arresto dei servizi e la sostituzione dei file eseguibili sulla macchina fisica o virtuale in cui è installato GroundRunner, l'utente deve disporre dei privilegi di amministrazione sul server host.
- Windows: È necessario poter eseguire il Prompt dei comandi come amministratore e accedere a Windows Service Manager (per arrestare e riavviare il servizio GroundRunner).
- Linux/macOS: È necessario avere accesso sudo o accesso root per spostare i file nella directory di installazione e riavviare il processo in background.
Scarica il GroundRunner
Per scaricare un GroundRunner da installare o aggiornare manualmente:
- Nella barra laterale di Workiva Home, clicca su Chains.
- Nella barra laterale del Chain Builder (questa è una nuova scheda), clicca su Connections.
In alternativa, è possibile fare clic sull'icona del profilo utente in alto a destra, selezionare Chains admin, quindi Workplace Settings. - Clicca su Downloads nella barra dei menu in alto.
- Trova il GroundRunner per il tuo sistema operativo e clicca su Download.
- Una volta che il download è andato a buon fine, seleziona le istruzioni appropriate dal set sottostante e seguile per installare GroundRunner.
Installa GroundRunner
Il programma di installazione Microsoft (MSI) richiede .NET 3.5 o superiore.
Se non potete soddisfare questo requisito, dovrete installare GroundRunner utilizzando l'interfaccia a riga di comando.
Per installare GroundRunner:
- Decomprimi GroundRunner.zip in una nuova cartella e aprila.
- Eseguire GroundRunner.msi per aprire l'installazione guidata di GroundRunner.
- Fare clic su Avanti.
- Leggi e accetta i termini dell'accordo di licenza e clicca su Avanti.
- Per la cartella di destinazione, inserire il percorso in cui verrà installato GroundRunner (ad esempio:
C:\Program Files\GroundRunner\) e fare clic su Next.
- In Piattaforma token aziendale, inserire il token aziendale .
- In Platform auth host:
- Per l'APAC, immettere
h.apac.wdesk.com/s/chains-reaper. - Per il Canada, immettere
h.ca.wdesk.com/s/chains-reaper. - Per l'area EMEA, immettere
h.eu.wdesk.com/s/chains-reaper. - Per gli Stati Uniti, l'America Centrale e il Sud America, immettere
h.app.wdesk.com/s/chains-reaper.
- Per l'APAC, immettere
- Se si utilizza un server proxy, inserire l'URL e la porta in Proxy host.
(Ad esempio,http://yourproxy:3000.)
Per bypassare il server proxy, inserire un elenco di host separato da virgole in No proxy host. - Clicca su Next, Install e Finish.
- Una volta installato, fare clic con il tasto destro del mouse su GroundRunner da Windows Service Manager e selezionare Start.
Il GroundRunner è stato installato ed è pronto per essere attivato.
Per l'installazione tramite interfaccia a riga di comando, è necessario scaricare l'installazione di GroundRunner nella propria directory all'interno dei file di programma (ad esempio c:\Program Files (x86)\wdata). È quindi possibile decomprimere il file di installazione ed estrarlo nella radice della directory.
È quindi possibile installare GroundRunner:
- Nella finestra dei comandi di Windows, immettere
e accettare tutte le impostazioni predefinite.c:\Program Files (x86)\wdata\installer.exe install- Selezionare "windows" come sistema di avvio.
È necessario specificare che GroundRunner deve funzionare come servizio di Windows per essere supportato dagli aggiornamenti automatici. GroundRunners deve essere eseguito solo come servizio, tranne che per scopi di prova.
- Per il percorso, creare una cartella Files all'interno della nuova directory
(ad esempio,C:\Program Files (x86)\Wdata\Files). - Per il nome dell'host di autorizzazione (AUTH_HOST):
- Per l'APAC, immettere
h.apac.wdesk.com/s/chains-reaper. - Per il Canada, immettere
h.ca.wdesk.com/s/chains-reaper. - Per l'area EMEA, immettere
h.eu.wdesk.com/s/chains-reaper. - Per gli Stati Uniti, l'America Centrale e il Sud America, immettere
h.app.wdesk.com/s/chains-reaper.
- Per l'APAC, immettere
- Inserite il vostro token aziendale .
- Selezionare "windows" come sistema di avvio.
- Elimina tutti i file dalla directory tranne la directory eseguibile di GroundRunner.
- Seleziona se eseguire GroundRunner come servizio o come processo in primo piano.
- Se viene eseguito come servizio, esegui una delle seguenti operazioni:
- Nella finestra di dialogo dei comandi, immettere
sc per avviare GroundRunner. - In Windows Service Manager, avviare il servizio GroundRunner.
- Nella finestra di dialogo dei comandi, immettere
- Se è in esecuzione come processo in primo piano, nella finestra di dialogo dei comandi inserire:
cd c:\Program Files (x86)\wdata GroundRunner.exe
- Se viene eseguito come servizio, esegui una delle seguenti operazioni:
Il GroundRunner è ora installato e pronto per l'attivazione.
Passo 1. Installare GroundRunner
-
Scaricare il file di installazione di GroundRunner nella propria directory, ad esempio
:/home/nome_utente/wdata/.Nota: "/home/nome_utente/wdata" è fornito come esempio. Seguire la politica dell'organizzazione per i luoghi di installazione del servizio.
- In una finestra di comando, decomprimere il file di installazione con:
unzip GroundRunner.zip - Inserire i dati del GroundRunner.
- Immettere
./installer install - Per il nome dell'host di autorizzazione (AUTH_HOST):
- Per l'APAC, immettere
h.apac.wdesk.com/s/chains-reaper. - Per il Canada, immettere
h.ca.wdesk.com/s/chains-reaper. - Per l'area EMEA, immettere
h.eu.wdesk.com/s/chains-reaper. - Per gli Stati Uniti, l'America Centrale e il Sud America, immettere
h.app.wdesk.com/s/chains-reaper.
- Per l'APAC, immettere
- Inserite il vostro token aziendale .
- Immettere
- Eliminare tutti i file dalla directory, tranne la cartella creata durante il processo di installazione.
Passo 2. Configurare GroundRunner come servizio systemd (Linux)
Per garantire il funzionamento degli aggiornamenti automatici di GroundRunner e per una buona igiene di GroundRunner, quest'ultimo deve essere installato come servizio systemd abilitato e riavviabile. Per sapere come eseguire GroundRunner come servizio systemd, consultare la documentazione e la politica organizzativa del proprio sistema operativo.
Per le configurazioni di base, abbiamo i seguenti requisiti del file unitario di systemd affinché gli aggiornamenti automatici funzionino correttamente:
- Assicurarsi che l'eseguibile
ExecStartpunti al binarioGroundRunnerMonitore NON al binario
GroundRunner. - Impostare
Restart=always. - Non impostare
StartLimitBurstoStartLimitIntervalSec, poiché potrebbero impedire il riavvio di GroundRunner a causa di errori transitori. Se si desidera che GroundRunner non entri in un ciclo di riavvio rapido, è possibile configurareRestartSec. - Digitare
systemctl enableper abilitare l'unità di servizio GroundRunner di systemd in modo che GroundRunner sopravviva a un riavvio.
Workiva non supporta ufficialmente l'esecuzione di un GroundRunner come processo in primo piano. Questo può essere utile per testare una configurazione, ma, una volta configurato GroundRunner, dovrebbe essere impostato come un processo in background di lunga durata.
Utilizzo di GroundRunners su macOS (solo per i test)
Workiva supporta GroundRunners su macOS solo a scopo di test. Mentre i GroundRunner di macOS sono in grado di eseguire gli stessi comandi delle versioni Linux e Windows, Workiva non supporta ufficialmente launchd come valido gestore di servizi. Questo perché Apple ha interrotto il supporto per il software server macOS nel 2022. I computer portatili e desktop Apple non sono adatti all'esecuzione di GroundRunners.
Attiva il GroundRunner
Dopo aver installato il GroundRunner, devi attivarlo all'interno di Chain Builder.
- Nella barra laterale di Chain Builder, clicca su Connections.
- Clicca su Runners in alto e poi su Pending Registration.
- Inserire un nome breve e descrittivo per il corridore.
Ad esempio "<datasource>-GroundRunner".
- Clicca su Attiva.
Aggiornare manualmente un GroundRunner
Sebbene sia raramente richiesto, potrebbe essere necessario aggiornare manualmente un GroundRunner.
Per istruzioni su come eseguire questa operazione, consultare la pagina di supporto Workiva GroundRunner Manual update.
Disinstallare un GroundRunner
Se non hai più bisogno di GroundRunner, puoi disinstallarlo.
- Arresta il servizio GroundRunner.
- Se è in esecuzione come servizio, utilizzare Gestione servizi di Windows o immettere
sc stop GroundRunnerin una finestra di comando. - Se è in esecuzione come processo in primo piano, premere Ctrl+C.
- Se è in esecuzione come servizio, utilizzare Gestione servizi di Windows o immettere
- Nella finestra di dialogo dei comandi, come amministratore, immettere
installer.exe uninstall. - Elimina la directory eseguibile di
GroundRunner.
Nella finestra di dialogo dei comandi, arrestate il servizio GroundRunner ed eliminate la sua directory eseguibile (ad esempio, /home/<username>/wdata/Contents).
Installare un JRE personalizzato
Se necessario, puoi installare una JRE personalizzata per supportare un GroundRunner. La versione di Java di questo JRE deve corrispondere a quella richiesta per il Groundrunner. Ad eccezione dei GroundRunner Oracle Essbase e Oracle Hyperion Financial Management (HFM), tutti i GroundRunner utilizzano la stessa versione JRE. Per informazioni su come installare una JRE personalizzata, consulta Disabilitare le librerie condivise di Workiva.
Impostazioni di configurazione di GroundRunner e domini in uscita
Per consentire la comunicazione con la fonte dei dati, potrebbe essere necessario aprire le porte del firewall sul server in cui è installato il GroundRunner. Per modificare le impostazioni di configurazione di alcuni GroundRunner, puoi modificare il file GroundRunner.config nella directory in cui sono installati i binari.
| Configurazione | Impostazioni |
|---|---|
| PORTA |
0 a 65535. Per impostazione predefinita, i GroundRunner utilizzano la porta 8821 per comunicare tra loro. Tuttavia, una porta è necessaria solo se i GroundRunner su server diversi condividono le uscite di comando all'interno della tua rete. |
| NOME_AZIENDA | Lasciare l'impostazione predefinita, a meno che GroundRunner non sia configurato per un altro tenant. |
| LOG_LEVEL | Info o debug |
| PROTOCOLLO | Lasciare l'impostazione predefinita. |
| HTTP_PROXY_URL |
Se si utilizza un server proxy, inserisci l'URL e la porta (se necessario). Nota: I GroundRunner possono utilizzare server proxy, ma non quelli autenticati tramite New Technology LAN Manager (NTLM). Consentire invece l'indirizzo IP del server. |
| LONG_POLL | Se si utilizza un server proxy, imposta true per indicare al runner di utilizzare il long-polling per recuperare i comandi. Per garantire le prestazioni, usa il long-polling solo se i web socket non sono supportati dal tuo server proxy o firewall. |
| NO_PROXY | Per bypassare il server proxy, fornisci un elenco separato da virgole di host da raggiungere direttamente. Per includere più host basati su uno schema comune, usa il carattere jolly *. |
| GROUNDRUNNER_CERT |
Necessario se si utilizza più di un GroundRunner e si desidera inviare informazioni criptate al secondo GroundRunner. Questo deve essere utilizzato insieme a PORT. Devi specificare anche il campo PROTOCOLLO come HTTPS quando attivi il runner. |
| GROUNDRUNNER_CERT_KEY | Necessario se si utilizza più di un GroundRunner e si desidera ricevere informazioni criptate da un secondo GroundRunner. Deve essere utilizzato insieme a PORT. |
| DISABLE_WEBSOCKETS | Le websocket sono necessarie per eseguire le trasformazioni. Se disabilitato, tutti i comandi che utilizzano le trasformazioni saranno completamente ignorati. |
Nota: il tuo certificato autofirmato deve avere un Subject Alternative Name (SAN). In caso contrario, quando GroundRunner tenta di scaricare i file, viene visualizzato un messaggio di errore che fa riferimento alla SAN mancante.
Se la tua rete deve consentire i domini in uscita, questi si applicano ai GroundRunner:
| Dominio | Scopo |
|---|---|
|
|
I principali sottodomini dei servizi Workiva più comuni, tra cui Wdata. |
*.wdesk.com |
Il dominio principale della piattaforma Workiva di produzione. |
*.*.wdesk.com |
I sottodomini dei componenti di supporto della piattaforma Workiva. |
Titolo
I GroundRunner non raccolgono o aggregano mai i dati; li conservano solo durante la trasmissione. Un certificato EV (Extended Validation) cripta e protegge sempre il traffico tra un GroundRunner e la sua fonte di dati tramite DigiCert®.
Nota: Per proteggere i dati on-premises, i CloudRunner possono condividere l'output con i GroundRunner, ma i GroundRunner non possono condividere gli output dei file con i CloudRunner.
Risoluzione degli errori di GroundRunner
Se ricevi questi errori durante l'esecuzione di una catena, controlla i GroundRunner del comando.
Suggerimento: Per facilitare la risoluzione dei problemi, è possibile creare una catena per scaricare automaticamente il file di registro di GroundRunner in una tabella.
| Messaggio di errore | Causa | Risoluzione |
|---|---|---|
| Comunicazione fallita con l'agente: questo comando non è stato eseguito |
Il comando non è riuscito a comunicare con il suo GroundRunner. Se questo accade, il GroundRunner non si è avviato o si è verificata un'interruzione di rete tra il GroundRunner e il Chain Builder. |
Verifica:
|
| Impossibile scaricare le risorse associate al comando. Contatta l'assistenza se l'errore persiste. |
I runner associati a questi comandi della catena non possono comunicare tra loro. Questo accade spesso quando i comandi utilizzano runner diversi e il CloudRunner sta cercando di utilizzare un file in uscita da un comando basato su GroundRunner. |
Usa lo stesso runner con tutti i comandi della catena. Se i comandi della catena richiedono più runner, verifica che nessun comando con GroundRunner passi i file in uscita ai comandi che utilizzano il CloudRunner. |
Errore nell'avvio del comando: exec: \"\\[connector].exe\": il file non esiste" commandExecutorId=[ID] |
Un'applicazione malware o antivirus ha identificato erroneamente il connettore e ha intercettato la sua comunicazione con GroundRunner. | Escludi la directory di installazione di GroundRunner dalle scansioni dell'applicazione. |
| Errori dei certificati | Usare i certificati autofirmati |
In molti casi, sarà conveniente utilizzare certificati autofirmati per criptare le comunicazioni di GroundRunner. Se utilizzi un certificato autofirmato, assicurati che il Common Name del certificato corrisponda all'URL a cui è possibile accedere al server. Ad esempio, se il GroundRunner è in ascolto sulla porta 8821 e puoi accedere al server dalla tua rete |
| Interruzione intermittente della catena con l'errore: "Connessione resettata dal peer". |
Quando più runner sono installati sullo stesso computer, devono avere ciascuno un GUID unico. Se viene utilizzato lo stesso GUID, i corridori possono sovrapporsi ed entrare in un ciclo di aggiornamento, causando occasionali fallimenti della catena. |
Si consiglia di reinstallare completamente GroundRunner. |
| I comandi vengono saltati su GroundRunner ma hanno successo su CloudRunner | I websocket sono necessari per eseguire le trasformazioni. Quando i websockets sono disabilitati, le trasformazioni vengono completamente saltate. | Aprite il vostro file di configurazione e impostateDISABLE_WEBSOCKETS=false. |
Errore di lettura dal socket. Riprova la connessione: read tcp <IP>:<Port>-><IP>:<Port>: wsarecv: Un tentativo di connessione è fallito perché l'utente connesso non ha risposto correttamente dopo un certo periodo di tempo o la connessione stabilita non è riuscita perché l'host connesso non ha risposto. |
Problema di firewall interno o di rete | Coinvolgi il team IT o di rete interno per esaminare i log e la configurazione al fine di risolvere l'errore. |
read <IP>:<Port>-><IP>:<Port>: wsarecv: Una connessione esistente è stata chiusa forzatamente dall'host remoto |
Problema di firewall interno o di rete | Coinvolgi il team IT o di rete interno per esaminare i log e la configurazione al fine di risolvere l'errore. |