Portail de support Workiva

Suivez ces instructions pour remplacer les binaires GroundRunner et GroundRunnerMonitor sur une machine hôte par une version plus récente.

Notes importantes sur la planification

• Le service GroundRunner ne prend pas en charge l'arrêt progressif. Lorsque le service est arrêté, toutes les opérations en vol sont immédiatement interrompues. Les résultats de ces opérations seront perdus et les commandes devront être exécutées à nouveau.
• L'arrêt du service étant perturbant, nous vous recommandons vivement de coordonner une fenêtre de déploiement avec vos parties prenantes avant d'effectuer la mise à jour, et de vous assurer qu'aucun travail critique n'est en cours d'exécution ou programmé pendant la période de maintenance.

Conditions préalables (toutes les plateformes)

• Vérifiez si vous avez besoin d'une mise à jour. La version actuelle (au 1er juin 2026) est la 9.21.1.
  Voir Comment puis-je vérifier la version d'un GroundRunner ? pour savoir quelle version de GroundRunner vous utilisez.
  Si votre GroundRunner n'est pas à jour, la bannière suivante s'affichera.
• Si votre GroundRunner n'est plus à jour, enregistrez le numéro de version indiqué dans le champ Version.

Pour les plateformes Windows

• Le fichier Windows GroundRunner.zip, obtenu auprès de Workiva.
  (Voir Installer et gérer les GroundRunners pour plus de détails)
• Droits d'administrateur pour les deux :
  • La machine sur laquelle le GroundRunner est installé.
  • Le répertoire dans lequel les binaires sont installés. 
• Permission d'arrêter et de démarrer le service GroundRunner.

Pour les plateformes Linux

• Le fichier Windows GroundRunner.zip, obtenu auprès de Workiva.
  (Voir Installer et gérer les GroundRunners pour plus de détails)
• Les utilitaires Linux unzip(1), tar(1), et gzip(1) doivent être installés (ils sont standard dans la plupart des installations).
• Droits de propriété des fichiers (chown).
• Droits d'administrateur pour les deux :
  • La machine sur laquelle le GroundRunner est installé.
  • Le répertoire dans lequel les binaires sont installés. 
• Permission d'arrêter et de démarrer le service GroundRunner.

Installation sous Windows

1. Extraire GroundRunner.zip dans un répertoire temporaire.
2. Ouvrez la console Services : appuyez sur Win + R, tapez services.msc, et appuyez sur Enter.
3. Trouvez GroundRunner dans la liste, cliquez dessus avec le bouton droit de la souris et sélectionnez Stop. 
4. Attendez que l'état indique Stopped.
5. Sauvegarder les binaires existants.
   Dans l'explorateur de fichiers, naviguez jusqu'au répertoire d'installation de GroundRunner et copiez GroundRunner.exe et GroundRunnerMonitor.exe et tous les fichiers de configuration vers un emplacement de sauvegarde (par exemple, renommez-les en GroundRunner.exe.bak et GroundRunnerMonitor.exe.bak).
6. Remplacez les binaires en copiant GroundRunner.exe et GroundRunnerMonitor.exe du répertoire extrait dans le répertoire d'installation, en écrasant les fichiers existants.
7. De retour dans la console Services, cliquez avec le bouton droit de la souris sur GroundRunner et sélectionnez Start. 
8. Vérifiez que l'état indique Running.

Installation de Linux (systemd)

Ces instructions s'appliquent aux systèmes Linux standard dont la sécurité n'est pas renforcée. Si votre hôte utilise SELinux, AppArmor ou un autre logiciel de sécurité, consultez Mandatory Access Control (SELinux / AppArmor) à la fin de cette section.

1. Extraire les artefacts dans le fichier zip.

   Note : Extraction du fichier zip vers /tmp/groundrunner-update est utilisé à titre d'exemple. Vous pouvez extraire le fichier zip à l'endroit qui correspond le mieux à la politique de votre organisation.

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

2. Arrêter le processus en cours. Si vous utilisez systemd, utilisez cette commande :

   sudo systemctl stop <nom du service>

   NOTE IMPORTANTE : Si vous n'avez pas configuré votre GroundRunner en tant que service systemd, veuillez le configurer en tant que service systemd avant d'effectuer la mise à jour. Vous trouverez de la documentation sur la manière de configurer un service systemd dans la documentation de votre distribution Linux. Si vous utilisez une distribution Linux non Systemd, veuillez consulter la documentation de votre distribution.

3. Sauvegarder les binaires et les configurations dans le répertoire GroundRunner :

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

   Note : Vous pouvez sauvegarder l'intégralité du répertoire d'installation (y compris les logs et autres dossiers/fichiers) mais cela peut créer un fichier de sauvegarde extrêmement volumineux.

4. Remplacer les binaires :

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

5. Définir les autorisations d'exécution :

   chmod +x GroundRunner GroundRunnerMonitor

   Note : Si votre GroundRunner est exécuté par un utilisateur système spécifique, vous devrez peut-être chown les nouveaux exécutables.

6. Démarrer le service :

   sudo systemctl start <nom du service&gt

7. Vérifier l'état du service pour s'assurer qu'il est sain :

   sudo systemctl status <nom du service&gt

8. Nettoyage :

   rm -rf /tmp/groundrunner-update

Contrôle d'accès obligatoire (SELinux / AppArmor)

Si l'hôte applique une politique de contrôle d'accès obligatoire (SELinux, AppArmor ou similaire), le remplacement des binaires sur le disque peut entraîner l'échec du service. 

Reportez-vous à la documentation de votre distribution pour gérer les politiques de sécurité relatives aux services personnalisés.

Note : D'autres logiciels de sécurité - tels que FAPOLICYD, IMA/EVM ou un contrôle personnalisé de l'intégrité des fichiers - peuvent également bloquer l'exécution des binaires remplacés. Si le service ne démarre pas après une mise à jour et que vous avez exclu SELinux/AppArmor, vérifiez si d'autres cadres de sécurité sur votre système nécessitent une mise à jour des listes de confiance ou des signatures de fichiers.

Vérification

Vous pouvez confirmer que le GroundRunner est actif et que sa version est correcte en suivant les instructions fournies dans Comment puis-je vérifier l'état d'un GroundRunner?

Nous vous encourageons à créer et à lancer une "chaîne pilote" qui exécute un ensemble de commandes de test sur le GroundRunner pour s'assurer que l'installation est correcte. 

Nous vous encourageons également à surveiller votre système et l'activité du GroundRunner immédiatement après la mise à jour et le redémarrage. Cela vous permet de vous assurer qu'il fonctionne correctement. Vous pouvez le faire à l'aide d'une commande de l'interface de communication, qui vous permet d'afficher les nouvelles entrées du journal au fur et à mesure qu'elles se produisent.

Pour Windows

Pour afficher la fin du fichier journal à l'aide de PowerShell, entrez ce qui suit :

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

La fenêtre PowerShell reste ainsi ouverte et les nouvelles entrées du journal sont affichées en temps réel. -tail 10 charge immédiatement les 10 dernières lignes.

Pour Linux

Pour afficher la fin du fichier journal et les nouvelles entrées en temps réel, entrez ce qui suit :

tail -f /path_to/output.log

Retour en arrière

Si la nouvelle version ne fonctionne pas correctement, vous pouvez revenir à la version précédente en suivant les étapes suivantes :

1. Arrêtez le service GroundRunner comme décrit ci-dessus.
2. Renommez les fichiers installés GroundRunner.exe et GroundRunnerMonitor.exe.
3. Copiez GroundRunner.exe.bak et GroundRunnerMonitor.exe.bak de l'emplacement de sauvegarde vers le répertoire d'installation. 
4. Renommez ces fichiers en supprimant l'extension ".bak".
5. Redémarrez le service GroundRunner en suivant les étapes appropriées décrites ci-dessus.

Note : Ces mêmes instructions s'appliquent aux GroundRunners Linux, mais vous devrez extraire les binaires de l'archive de sauvegarde.

Notes

• Ne pas renommer les binaires. Le mécanisme de mise à niveau automatique s'appuie sur les noms d'exécutables par défaut (GroundRunner et GroundRunnerMonitor sous Linux, et GroundRunner.exe et GroundRunnerMonitor.exe sous Windows) pour détecter et appliquer les futures mises à jour. Si vous les renommez, les mises à jour automatiques seront interrompues.
• macOS est pris en charge à des fins de développement uniquement. Il ne s'agit pas d'une plateforme de production prise en charge.
• Autres gestionnaires de services : Les exemples ci-dessus utilisent systemd (Linux) et le Service Control Manager de Windows. Si votre environnement utilise un gestionnaire de services ou un superviseur de processus différent, effectuez les étapes d'arrêt, de remplacement et de démarrage équivalentes pour votre configuration.
• Par défaut, les GroundRunners utilisent un compte administratif local sans accès aux ressources distantes telles que les lecteurs partagés. Pour accéder à une ressource partagée telle qu'un chemin UNC Windows, démarrez le GroundRunner sous un compte d'utilisateur disposant des privilèges adéquats pour la ressource. Si vous utilisez un compte d'utilisateur autre que l'administrateur du système local par défaut, accordez-lui des autorisations pour gérer le répertoire d'installation du GroundRunner afin d'activer les mises à jour automatiques.