Centro assistenza di Workiva

Seguite queste istruzioni per sostituire i binari di GroundRunner e GroundRunnerMonitor su un computer host con una versione più recente.

Note importanti per la pianificazione

• Il servizio GroundRunner non supporta la chiusura anticipata. Quando il servizio viene arrestato, tutte le operazioni in corso vengono interrotte immediatamente. I risultati di queste operazioni andranno persi e sarà necessario rieseguire i comandi.
• Poiché l'interruzione del servizio è dannosa, si consiglia vivamente di coordinare una finestra di distribuzione con le parti interessate prima di eseguire l'aggiornamento e di assicurarsi che nessun lavoro critico sia in esecuzione o programmato per essere eseguito durante il periodo di manutenzione.

Prerequisiti (tutte le piattaforme)

• Controllare se è necessario aggiornare. La versione attuale (al 1° giugno 2026) è 9.21.1.
  Vedere Come verificare la versione di GroundRunner? per sapere quale versione di GroundRunner si sta utilizzando.
  Se il GroundRunner non è aggiornato, viene visualizzato il seguente banner.
• Se il GroundRunner non è aggiornato, registrare il numero di versione indicato nel campo Version.

Per le piattaforme Windows

• Il file Windows GroundRunner.zip, ottenuto da Workiva.
  (Per ulteriori informazioni, vedere Installare e gestire i GroundRunner )
• Autorizzazioni di amministratore per entrambi:
  • La macchina in cui è installato GroundRunner.
  • La directory in cui sono installati i binari. 
• Autorizzazione all'arresto e all'avvio del servizio GroundRunner.

Per le piattaforme Linux

• Il file Windows GroundRunner.zip, ottenuto da Workiva.
  (Per ulteriori informazioni, vedere Installare e gestire i GroundRunner )
• È necessario installare le utility Linux unzip(1), tar(1) e gzip(1) (sono standard nella maggior parte delle installazioni).
• Permessi di proprietà dei file (chown).
• Autorizzazioni di amministratore per entrambi:
  • La macchina in cui è installato GroundRunner.
  • La directory in cui sono installati i binari. 
• Autorizzazione all'arresto e all'avvio del servizio GroundRunner.

Installazione in Windows

1. Estrarre GroundRunner.zip in una directory temporanea.
2. Aprite la console dei servizi: premete Win + R, digitate services.msc, e premete Invio.
3. Individuare GroundRunner nell'elenco, fare clic con il pulsante destro del mouse e selezionare Stop. 
4. Attendere che lo stato mostri Fermato.
5. Eseguire il backup dei file binari esistenti.
   In Esplora file, spostarsi nella directory di installazione di GroundRunner e copiare GroundRunner.exe e GroundRunnerMonitor.exe e tutti i file di configurazione in una posizione di backup (ad esempio, rinominarli in GroundRunner.exe.bak e GroundRunnerMonitor.exe.bak).
6. Sostituire i file binari copiando GroundRunner.exe e GroundRunnerMonitor.exe dalla directory estratta alla directory di installazione, sovrascrivendo i file esistenti.
7. Nella console dei servizi, fare clic con il pulsante destro del mouse su GroundRunner e selezionare Avvia. 
8. Verificare che lo stato mostri Esecuzione.

Installazione di Linux (systemd)

Queste istruzioni si riferiscono a sistemi Linux standard non potenziati dal punto di vista della sicurezza. Se l'host esegue SELinux, AppArmor o altri software di sicurezza, vedere Controllo accesso obbligatorio (SELinux / AppArmor) alla fine di questa sezione.

1. Estrarre gli artefatti nel file zip.

   Nota: L'estrazione del file zip in /tmp/groundrunner-update è usata a scopo esemplare. È possibile estrarre lo zip nel punto più adatto alle politiche della propria organizzazione.

   unzip GroundRunner.zip -d /tmp/groundrunner-update

2. Arresta il processo in corso. Se si usa systemd, usare questo comando:

   sudo systemctl stop <nome-servizio>

   NOTA IMPORTANTE: Se non avete GroundRunner configurato come servizio systemd, configuratelo come servizio systemd prima di eseguire l'aggiornamento. La documentazione su come configurare un servizio systemd si trova nella documentazione della distribuzione Linux. Se si utilizza una distribuzione Linux non systemd, consultare la documentazione della distribuzione.

3. Eseguire il backup dei file binari e delle configurazioni nella directory di GroundRunner:

   cd /path_to_groundrunner_install_dir tar czvf groundrunner.bak.tar.gz GroundRunner* *config config* monitor.version

   Nota: È possibile eseguire il backup dell'intera directory di installazione (compresi i log e altre cartelle/file), ma ciò può creare un file di backup estremamente grande.

4. Sostituire i file binari:

   cd /path_to_groundrunner_install_dir cp /tmp/groundrunner-update/GroundRunner . cp /tmp/groundrunner-update/GroundRunnerMonitor .

5. Impostare le autorizzazioni per l'esecuzione:

   chmod +x GroundRunner GroundRunnerMonitor

   Nota: Se GroundRunner viene eseguito da un utente di sistema specifico, potrebbe essere necessario chown i nuovi eseguibili.

6. Avviare il servizio:

   sudo systemctl start <nome-servizio&gt

7. Verificare lo stato del servizio per assicurarsi che sia sano:

   sudo systemctl status <nome servizio&gt

8. Pulire:

   rm -rf /tmp/groundrunner-update

Controllo degli accessi obbligatorio (SELinux / AppArmor)

Se l'host applica una politica di controllo degli accessi obbligatoria (SELinux, AppArmor o simili), la sostituzione dei binari su disco può causare il fallimento del servizio. 

Per la gestione dei criteri di sicurezza dei servizi personalizzati, consultare la documentazione della distribuzione.

Nota: Anche altri software di sicurezza, come FAPOLICYD, IMA/EVM o il monitoraggio personalizzato dell'integrità dei file, possono bloccare l'esecuzione dei binari sostituiti. Se il servizio non si avvia dopo un aggiornamento e avete escluso SELinux/AppArmor, verificate se eventuali framework di sicurezza aggiuntivi sul vostro sistema richiedono liste di fiducia o firme di file aggiornate.

Verifica

È possibile verificare che GroundRunner sia attivo e che la sua versione sia corretta seguendo le istruzioni fornite in Come verificare lo stato di un GroundRunner?

Si consiglia di creare ed eseguire una "catena pilota" che esegua una serie di comandi di prova sul GroundRunner per garantire la corretta installazione. 

Si consiglia inoltre di monitorare il sistema e l'attività di GroundRunner subito dopo l'aggiornamento e il riavvio. In questo modo si può essere certi che il funzionamento sia corretto. È possibile utilizzare un comando della CLI per trasmettere e visualizzare le nuove voci di registro man mano che si verificano.

Per Windows

Per visualizzare la fine del file di registro utilizzando PowerShell, immettere quanto segue:

Get-Content -Path "C:\path_to_output.log" -Tail 10 -Wait

In questo modo si mantiene aperta la finestra di PowerShell e si trasmettono le nuove voci di registro in tempo reale. -tail 10 carica immediatamente le ultime 10 righe.

Per Linux

Per visualizzare la fine del file di log e lo streaming delle nuove voci in tempo reale, immettere quanto segue:

tail -f /path_to/output.log

Rollback

Se la nuova versione non funziona correttamente, è possibile tornare alla versione precedente seguendo i seguenti passaggi:

1. Arrestare il servizio GroundRunner come descritto sopra.
2. Rinominare i file GroundRunner.exe e GroundRunnerMonitor.exe.
3. Copiare GroundRunner.exe.bak e GroundRunnerMonitor.exe.bak dalla posizione di backup alla directory di installazione. 
4. Rinominare questi file eliminando l'estensione ".bak".
5. Riavviare il servizio GroundRunner seguendo i passi appropriati descritti sopra.

Nota: Queste istruzioni sono valide anche per i GroundRunner Linux, ma è necessario estrarre i file binari dal tarball di backup.

Note

• Non rinominare i file binari. Il meccanismo di aggiornamento automatico si basa sui nomi predefiniti degli eseguibili (GroundRunner e GroundRunnerMonitor su Linux, e GroundRunner.exe e GroundRunnerMonitor.exe su Windows) per rilevare e applicare gli aggiornamenti futuri. Rinominandoli si interromperanno gli aggiornamenti automatici.
• macOS è supportato solo per scopi di sviluppo. Non è una piattaforma di produzione supportata.
• Altri gestori di servizi: Gli esempi precedenti utilizzano systemd (Linux) e il Service Control Manager di Windows. Se l'ambiente utilizza un gestore di servizi o un supervisore di processi diverso, eseguire i passaggi di arresto, sostituzione e avvio equivalenti per la propria configurazione.
• Per impostazione predefinita, i GroundRunner utilizzano un account amministrativo locale senza accedere a risorse remote come i drive condivisi. Per accedere a una risorsa condivisa come un percorso UNC di Windows, avvia il GroundRunner con un account utente con privilegi adeguati alla risorsa. Se utilizzi un account utente diverso dall'amministratore di sistema locale predefinito, concedigli i permessi per gestire la directory di installazione di GroundRunner per abilitare gli aggiornamenti automatici.