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, il programma scaricherà automaticamente un JRE, se necessario, per eseguire i comandi che richiedono 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 per il ruolo
Sulla piattaforma Workiva
Sulla piattaforma Workiva, è necessario disporre di un ruolo che garantisca l'accesso alle impostazioni di 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" in Chain Builder per scaricare i file di installazione più recenti di GroundRunner e gestire la scheda "Runners" per attivare o monitorare il servizio.
- Amministratore della sicurezza della catena organizzativa: Questo ruolo a livello organizzativo ha anche l'autorità di gestire le connessioni e i runner in più aree di lavoro.
Sul server
Poiché un "aggiornamento manuale" comporta l'arresto dei servizi e la sostituzione dei file eseguibili sulla macchina fisica o virtuale su cui è installato GroundRunner, l'utente deve disporre dei privilegi di amministratore sul server host.
- Windows: È necessario poter eseguire il Prompt dei comandi come amministratore e accedere al Gestore dei servizi di Windows (per arrestare e riavviare il servizio GroundRunner).
- Linux/macOS: È necessario disporre di sudo oppure 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, puoi cliccare sull'icona del profilo utente in alto a destra, selezionare " " (Gestione catene), quindi " " (Impostazioni Workplace). - 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 è possibile soddisfare questo requisito, sarà necessario installare GroundRunner utilizzando invece l'interfaccia della riga di comando.
Per installare GroundRunner:
- Decomprimi GroundRunner.zip in una nuova cartella e aprila.
- Eseguire il file “ ” GroundRunner.msi per aprire la procedura guidata di installazione di GroundRunner.
- Fare clic su Avanti.
- Leggi e accetta i termini dell'accordo di licenza e clicca su Avanti.
- Nel campo "Cartella di destinazione", inserisci il percorso in cui verrà installato GroundRunner (ad esempio:
C:\Program Files\GroundRunner\) e fai clic su " " (Avanti). - Nella piattaforma , inserisci il token della tua azienda .
- In Platform auth host:
- Per l'area APAC, inserire
h.apac.wdesk.com/s/chains-reaper. - Per il Canada, inserire
h.ca.wdesk.com/s/chains-reaper. - Per l'area EMEA, inserire
h.eu.wdesk.com/s/chains-reaper. - Per gli Stati Uniti, l'America Centrale e l'America del Sud, inserire
h.app.wdesk.com/s/chains-reaper.
- Per l'area APAC, inserire
- 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, inserisci un elenco di host separati da virgole alla voce “ ” (Nessun host proxy). - Clicca su Next, Install e Finish.
- Una volta installato, fare clic con il tasto destro del mouse su GroundRunner dal Gestore dei servizi di Windows e selezionare “ ” (Avvia).
Il GroundRunner è stato installato ed è pronto per essere attivato.
Per eseguire l'installazione tramite l'interfaccia della riga di comando, è necessario scaricare il file di installazione di GroundRunner in una cartella dedicata all'interno della cartella "Programmi" (ad esempio c:\Program Files (x86)\wdata). A questo punto è possibile decomprimere il file di installazione ed estrarlo nella directory principale di quella cartella.
A questo punto è possibile installare GroundRunner:
-
Nella finestra dei comandi di Windows, digitare
c:\Program Files (x86)\wdata\installer.exe installe accettare tutte le impostazioni predefinite.
-
Selezionare "Windows" come sistema di avvio.
È necessario specificare che GroundRunner deve funzionare come servizio di Windows affinché sia supportato dagli aggiornamenti automatici. GroundRunners deve essere eseguito esclusivamente come servizio, salvo che a scopo di test.
- 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'area APAC, inserire
h.apac.wdesk.com/s/chains-reaper. - Per il Canada, inserire
h.ca.wdesk.com/s/chains-reaper. - Per l'area EMEA, inserire
h.eu.wdesk.com/s/chains-reaper. - Per gli Stati Uniti, l'America Centrale e l'America del Sud, inserire
h.app.wdesk.com/s/chains-reaper.
- Per l'area APAC, inserire
- Inserisci il token della tua azienda .
-
- 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, digita
sc start GroundRunner. - In Windows Service Manager, avviare il servizio " GroundRunner".
- Nella finestra di dialogo dei comandi, digita
-
Se il processo viene eseguito in primo piano, nella finestra di dialogo dei comandi digitare:
cd c:\Program Files (x86)\wdata GroundRunner.exe
- Se viene eseguito come servizio, esegui una delle seguenti operazioni:
Il tuo GroundRunner è ora installato e pronto per l'attivazione.
Passo 1. Installare GroundRunner
-
Scaricare il file di installazione di GroundRunner in una directory dedicata, ad esempio
:/home/user_name/wdata/.Nota: "/home/user_name/wdata" è riportato a titolo di esempio. Attenersi alle linee guida della propria organizzazione relative ai luoghi di installazione dei servizi.
-
In una finestra di dialogo di comando, decomprimere il file di installazione utilizzando il comando:
decomprimere il file GroundRunner.zip - Inserisci i dati del GroundRunner.
- Digita
./installer install - Per il nome dell'host di autorizzazione (AUTH_HOST):
- Per l'area APAC, inserire
h.apac.wdesk.com/s/chains-reaper. - Per il Canada, inserire
h.ca.wdesk.com/s/chains-reaper. - Per l'area EMEA, inserire
h.eu.wdesk.com/s/chains-reaper. - Per gli Stati Uniti, l'America Centrale e il Sudamerica, inserire
h.app.wdesk.com/s/chains-reaper.
- Per l'area APAC, inserire
- Inserisci il token aziendale di .
- Digita
- Elimina tutti i file dalla directory, ad eccezione della cartella creata durante il processo di installazione.
Passaggio 2. Configurare GroundRunner come servizio systemd (Linux)
Per garantire il corretto funzionamento degli aggiornamenti automatici di GroundRunner e per una corretta gestione di GroundRunner, è necessario che GroundRunner sia installato come servizio systemd abilitato e riavviabile. Per informazioni su come eseguire GroundRunner come servizio systemd, consultare la documentazione del proprio sistema operativo e le politiche aziendali.
Per le configurazioni di base, affinché gli aggiornamenti automatici funzionino correttamente, sono necessari i seguenti file di unità systemd:
- Assicurarsi che l'eseguibile ExecStart di
punti al binario GroundRunnerMonitordie NON al binario GroundRunnerdi. - Imposta
Restart=always. - Non impostare
StartLimitBurstoStartLimitIntervalSec, poiché tali impostazioni potrebbero impedire il riavvio di GroundRunner a causa di errori transitori. Se si desidera evitare che GroundRunner entri in un ciclo di riavvio rapido, è possibile configurare `RestartSec` su ``. - Digita `
` e poi `systemctl enable` per abilitare l'unità di servizio GroundRunner di systemd, in modo che GroundRunner rimanga attivo anche dopo un riavvio.
Workiva non supporta ufficialmente l'esecuzione di GroundRunner come processo in primo piano. Questo può essere utile per testare una configurazione, ma, una volta configurato un GroundRunner, è opportuno impostarlo come processo in background a lunga durata.
Utilizzo di GroundRunners su macOS (solo a scopo di test)
Workiva supporta GroundRunners su macOS esclusivamente a scopo di test. Sebbene i GroundRunners per macOS siano in grado di eseguire gli stessi comandi delle versioni per Linux e Windows, Workiva non supporta ufficialmente launchd come gestore di servizi valido. Questo perché Apple ha interrotto il supporto per il proprio software server macOS nel 2022. I portatili e i computer fissi Apple non sono compatibili con 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.
- Inserisci un nome breve e descrittivo per il runner.
Ad esempio "<datasource>-GroundRunner". - Clicca su Attiva.
Lista di controllo per la configurazione di GR
- Stai eseguendo l'eseguibile GroundRunnerMonitor di
(anziché l'eseguibile GroundRunner di)? - Hai configurato il tuo GroundRunnerMonitor di
come servizio a livello di sistema, riavviabile?- Per Linux:
Systemd. - Per Windows:
Servizi di Windows.
- Per Linux:
- Il vostro servizio si riavvia al riavvio del sistema?
- Su Linux:
systemctl enable. - Su Windows: tipo di avvio impostato su “
” (Automatico).
- Su Linux:
- Stai utilizzando un sistema operativo server supportato?
- Hai attivato le notifiche di GroundRunner?
Aggiornare manualmente un GroundRunner
Sebbene sia raramente richiesto, potrebbe essere necessario aggiornare manualmente un GroundRunner.
Per istruzioni su come procedere, consultare la pagina di assistenza di Workiva all’indirizzo e l’aggiornamento del manuale di GroundRunner all’indirizzo.
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 oppure digitare
sc stop GroundRunnerin una finestra di comando. - Se il processo è in esecuzione in primo piano, premi Ctrl+C.
- Se è in esecuzione come servizio, utilizzare Gestione servizi di Windows oppure digitare
- Nella finestra di dialogo dei comandi, come amministratore, digita
installer.exe uninstall. - Elimina la directory eseguibile di
GroundRunner.
Nella finestra di dialogo dei comandi, arrestare il servizio GroundRunner ed eliminare la directory contenente il suo 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 un JRE personalizzato, consultare . Disattivare 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). Consenti 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 il 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 gli output con i GroundRunner, ma i GroundRunner non possono condividere gli output dei file con 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, puoi creare una catena per scaricare automaticamente il file di log di un 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 |
| Catena intermittente con 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 runner possono sovrapporsi e creare un ciclo di aggiornamento, causando occasionali malfunzionamenti 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. | Apri il tuo file di configurazione e impostaDISABLE_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. |