Centro de suporte da Workiva

Siga estas instruções para substituir os binários do GroundRunner e do GroundRunnerMonitor em um computador host por uma versão mais recente.

Notas de planejamento importantes

• O serviço GroundRunner não é compatível com o desligamento gradual. Quando o serviço é interrompido, todas as operações em andamento são encerradas imediatamente. Os resultados dessas operações serão perdidos e os comandos precisarão ser executados novamente.
• Como a interrupção do serviço pode causar interrupções, recomendamos enfaticamente que você coordene uma janela de implementação com as partes interessadas antes de executar a atualização e certifique-se de que nenhum trabalho crítico esteja sendo executado ou programado para ser executado durante o período de manutenção.

Pré-requisitos (todas as plataformas)

• Verifique se você precisa atualizar. A versão atual (em 1º de junho de 2026) é a 9.21.1.
  Consulte . Como verifico a versão de um GroundRunner? para saber qual versão do GroundRunner você está usando.
  Se o seu GroundRunner estiver desatualizado, o seguinte banner será exibido.
• Se o seu GroundRunner estiver desatualizado, registre o número da versão mostrado no campo Version.

Para plataformas Windows

• O Windows GroundRunner.zip, obtido na Workiva.
  (Consulte Install and manage GroundRunners para obter detalhes)
• Permissões de administrador para ambos:
  • A máquina onde o GroundRunner está instalado.
  • O diretório em que os binários estão instalados. 
• Permissão para parar e iniciar o serviço GroundRunner.

Para plataformas Linux

• O Windows GroundRunner.zip, obtido na Workiva.
  (Consulte Install and manage GroundRunners para obter detalhes)
• Os utilitários do Linux unzip(1), tar(1) e gzip(1) devem ser instalados (eles são padrão na maioria das instalações).
• Permissões de propriedade de arquivos (chown).
• Permissões de administrador para ambos:
  • A máquina onde o GroundRunner está instalado.
  • O diretório em que os binários estão instalados. 
• Permissão para parar e iniciar o serviço GroundRunner.

Instalação do Windows

1. Extraia GroundRunner.zip para um diretório temporário.
2. Abra o console Services: pressione Win + R, digite services.msc e pressione Enter.
3. Localize GroundRunner na lista, clique com o botão direito do mouse e selecione Stop. 
4. Aguarde até que o status mostre Stopped.
5. Faça backup dos binários existentes.
   No Explorador de Arquivos, navegue até o diretório de instalação do GroundRunner e copie GroundRunner.exe e GroundRunnerMonitor.exe e todos os arquivos de configuração para um local de backup (por exemplo, renomeie-os para GroundRunner.exe.bak e GroundRunnerMonitor.exe.bak).
6. Substitua os binários copiando GroundRunner.exe e GroundRunnerMonitor.exe do diretório extraído para o diretório de instalação, sobrescrevendo os arquivos existentes.
7. De volta ao console Services, clique com o botão direito do mouse em GroundRunner e selecione Start. 
8. Verifique se o status mostra Running.

Instalação do Linux (systemd)

Essas instruções são para sistemas Linux padrão não aprimorados em termos de segurança. Se o host executar o SELinux, o AppArmor ou outro software de segurança, consulte Mandatory Access Control (SELinux / AppArmor) no final desta seção.

1. Extraia os artefatos do arquivo zip.

   Observação: Extrair o arquivo zip para /tmp/groundrunner-update é usado para fins de exemplo. Você pode extrair o zip onde for mais adequado às políticas de sua organização.

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

2. Interromper o processo em execução. Se estiver usando o systemd, use esse comando:

   sudo systemctl stop <service-name>

   OBSERVAÇÃO IMPORTANTE: Se você não tiver o GroundRunner configurado como um serviço systemd, configure-o como um serviço systemd antes de realizar a atualização. A documentação sobre como configurar um serviço systemd pode ser encontrada na documentação de sua distribuição Linux. Se você usa uma distribuição Linux sem systemd, consulte a documentação da sua distribuição.

3. Faça backup dos binários e das configurações no diretório do GroundRunner:

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

   Observação: Você pode fazer backup de todo o diretório de instalação (ou seja, incluindo logs e outras pastas/arquivos), mas isso pode criar um arquivo de backup extremamente grande.

4. Substitua os binários:

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

5. Defina as permissões do executável:

   chmod +x GroundRunner GroundRunnerMonitor

   Observação: Se o GroundRunner for executado por um usuário específico do sistema, talvez seja necessário chown os novos executáveis.

6. Inicie o serviço:

   sudo systemctl start <nome-do-serviço&gt

7. Verifique o status do serviço para garantir que ele esteja íntegro:

   sudo systemctl status <nome do serviço&gt

8. Limpeza:

   rm -rf /tmp/groundrunner-update

Controle de acesso obrigatório (SELinux / AppArmor)

Se o host aplicar uma política de controle de acesso obrigatória (SELinux, AppArmor ou similar), a substituição de binários no disco pode causar falha no serviço. 

Consulte a documentação de sua distribuição para gerenciar as políticas de segurança dos serviços personalizados.

Observação: Outros softwares de segurança, como FAPOLICYD, IMA/EVM ou monitoramento personalizado da integridade de arquivos, também podem bloquear a execução de binários substituídos. Se o serviço não for iniciado após uma atualização e você tiver excluído o SELinux/AppArmor, verifique se alguma estrutura de segurança adicional em seu sistema exige listas de confiança ou assinaturas de arquivo atualizadas.

Verificação

Você pode confirmar se o GroundRunner está ativo e se sua versão está correta seguindo as instruções fornecidas em . Como faço para verificar o status de um GroundRunner?

Recomendamos que você crie e execute uma "cadeia piloto" que execute um conjunto de comandos de teste no GroundRunner para garantir a instalação adequada. 

Também recomendamos que você monitore o seu sistema e a atividade do GroundRunner imediatamente após a atualização e a reinicialização. Isso permite que você tenha certeza de que ele está funcionando corretamente. Você pode fazer isso usando um comando CLI para transmitir e visualizar novas entradas de registro à medida que elas ocorrem.

Para Windows

Para exibir o final do arquivo de registro usando o PowerShell, digite o seguinte:

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

Isso mantém a janela do PowerShell aberta e transmite novas entradas de registro em tempo real. -tail 10 carrega as últimas 10 linhas imediatamente.

Para Linux

Para visualizar o final do arquivo de registro e transmitir novas entradas em tempo real, digite o seguinte:

tail -f /caminho_para/output.log

Reversão

Se a nova versão não estiver funcionando corretamente, você poderá reverter para a versão anterior seguindo estas etapas:

1. Interrompa o serviço do GroundRunner conforme descrito acima.
2. Renomeie os arquivos instalados GroundRunner.exe e GroundRunnerMonitor.exe.
3. Copie GroundRunner.exe.bak e GroundRunnerMonitor.exe.bak do local de backup para o diretório de instalação. 
4. Renomeie esses arquivos removendo a extensão ".bak".
5. Reinicie o serviço GroundRunner seguindo as etapas apropriadas descritas acima.

Observação: Essas mesmas instruções se aplicam ao Linux GroundRunners, mas você precisará extrair os binários do tarball de backup.

Notas

• Não renomeie os binários. O mecanismo de atualização automática se baseia nos nomes padrão dos executáveis (GroundRunner e GroundRunnerMonitor no Linux, e GroundRunner.exe e GroundRunnerMonitor.exe no Windows) para detectar e aplicar futuras atualizações. Renomeá-los interromperá as atualizações automáticas.
• o macOS é compatível apenas para fins de desenvolvimento. Não é uma plataforma de produção suportada.
• Outros gerenciadores de serviços: Os exemplos acima usam o systemd (Linux) e o Gerenciador de Controle de Serviços do Windows. Se o seu ambiente usar um gerenciador de serviços ou supervisor de processos diferente, execute as etapas de parada, substituição e inicialização equivalentes para a sua configuração.
• Por padrão, os GroundRunners usam uma conta administrativa local sem acesso a recursos remotos, como unidades compartilhadas. Para acessar um recurso compartilhado, como um caminho UNC do Windows, inicie o GroundRunner em uma conta de usuário com privilégios adequados para o recurso. Se você estiver usando uma conta de usuário que não seja o administrador do sistema local padrão, conceda a ele permissões para gerenciar o diretório de instalação do GroundRunner para ativar as atualizações automáticas.