Centrum wsparcia Workiva

Aby zastąpić pliki binarne GroundRunner i GroundRunnerMonitor na komputerze hosta nowszą wersją, należy wykonać poniższe czynności.

Ważne uwagi dotyczące planowania

• Usługa GroundRunner nie obsługuje funkcji łagodnego wyłączania. Po zatrzymaniu lotu wszelkie operacje wykonywane w trakcie lotu zostają natychmiast przerwane. Wyniki tych operacji zostaną utracone i konieczne będzie ponowne uruchomienie poleceń.
• Ponieważ zatrzymanie usługi może powodować zakłócenia, zdecydowanie zalecamy uzgodnienie z interesariuszami okna wdrożenia przed wykonaniem aktualizacji i upewnienie się, że żadne krytyczne zadania nie są uruchomione ani zaplanowane do uruchomienia w okresie konserwacji.

Wymagania wstępne (wszystkie platformy)

• Sprawdź, czy konieczna jest aktualizacja. Aktualna wersja (stan na 1 czerwca 2026 r.) to 9.21.1.
  Zobacz Jak sprawdzić wersję GroundRunnera?, aby dowiedzieć się, której wersji GroundRunnera używasz.
  Jeśli Twoja wersja GroundRunner jest nieaktualna, zostanie wyświetlony poniższy baner.
• Jeśli Twój GroundRunner jest nieaktualny, zapisz numer wersji wyświetlany w polu Wersja.

Dla platform Windows

• Plik Windows GroundRunner.zip, pobrany z Workiva.
  (Szczegóły można znaleźć w Instalacja i zarządzanie GroundRunners ).
• Uprawnienia administratora dla obu:
  • Maszyna, na której zainstalowano GroundRunner.
  • Katalog, w którym instalowane są pliki binarne. 
• Zezwolenie na zatrzymywanie i uruchamianie usługi GroundRunner.

Dla platform Linux

• Plik Windows GroundRunner.zip, pobrany z Workiva.
  (Szczegóły można znaleźć w Instalacja i zarządzanie GroundRunners ).
• Należy zainstalować narzędzia systemu Linux unzip(1), tar(1)igzip(1) (są one standardem w większości instalacji).
• Uprawnienia właściciela pliku (chown).
• Uprawnienia administratora dla obu:
  • Maszyna, na której zainstalowano GroundRunner.
  • Katalog, w którym instalowane są pliki binarne. 
• Zezwolenie na zatrzymywanie i uruchamianie usługi GroundRunner.

Instalacja systemu Windows

1. Wypakuj GroundRunner.zip do katalogu tymczasowego.
2. Otwórz konsolę Usługi: naciśnij Win + R, wpisz services.msci naciśnij Enter.
3. Znajdź GroundRunner na liście, kliknij go prawym przyciskiem myszy i wybierz Zatrzymaj. 
4. Poczekaj, aż wyświetli się status Zatrzymano.
5. Utwórz kopię zapasową istniejących plików binarnych.
   W Eksploratorze plików przejdź do katalogu instalacyjnego GroundRunner i skopiuj GroundRunner.exe i GroundRunnerMonitor.exe oraz wszelkie pliki konfiguracyjne do lokalizacji zapasowej (np. zmień ich nazwy na GroundRunner.exe.bak i GroundRunnerMonitor.exe.bak).
6. Zastąp pliki binarne, kopiując GroundRunner.exe i GroundRunnerMonitor.exe z wyodrębnionego katalogu do katalogu instalacyjnego, nadpisując istniejące pliki.
7. Wróć do konsoli Usługi, kliknij prawym przyciskiem myszy GroundRunner i wybierz Uruchom. 
8. Sprawdź, czy status pokazuje Uruchomiono.

Instalacja Linuksa (systemd)

Niniejsze instrukcje dotyczą standardowych systemów Linux bez rozszerzonych zabezpieczeń. Jeśli na Twoim hoście działa SELinux, AppArmor lub inne oprogramowanie zabezpieczające, zapoznaj się z sekcją Obowiązkowa kontrola dostępu (SELinux / AppArmor) na końcu tej sekcji.

1. Wypakuj artefakty do pliku zip.

   Uwaga: Wypakowanie pliku zip do /tmp/groundrunner-update jest użyte w celach przykładowych. Możesz rozpakować plik ZIP w miejscu, które najlepiej odpowiada polityce Twojej organizacji.

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

2. Zatrzymaj działający proces. Jeśli używasz systemd, użyj tego polecenia:

   sudo systemctl stop<service-name>

   WAŻNA UWAGA : Jeśli nie masz skonfigurowanego GroundRunnera jako usługi systemd , skonfiguruj go jako usługę systemd przed wykonaniem aktualizacji. Dokumentację dotyczącą konfiguracji usługi systemd można znaleźć w dokumentacji dystrybucji Linuksa. Jeśli używasz dystrybucji Linuksa innej niż systemd, zapoznaj się z dokumentacją dystrybucji.

3. Wykonaj kopię zapasową plików binarnych i konfiguracji w katalogu GroundRunner:

   cd /ścieżka_do_katalogu_instalacyjnego_groundrunner tar czvf groundrunner.bak.tar.gz GroundRunner* *config config* monitor.version

   Uwaga: Można wykonać kopię zapasową całego katalogu instalacyjnego (tj. łącznie z dziennikami i innymi folderami/plikami), ale może to spowodować utworzenie bardzo dużego pliku kopii zapasowej.

4. Zastąp pliki binarne:

   cd /ścieżka_do_katalogu_instalacyjnego_groundrunner cp /tmp/groundrunner-update/GroundRunner . cp /tmp/groundrunner-update/GroundRunnerMonitor .

5. Ustaw uprawnienia wykonywalne:

   chmod +x GroundRunner GroundRunnerMonitor

   Uwaga: Jeśli GroundRunner jest uruchamiany przez konkretnego użytkownika systemu, może być konieczne zmiana nowych plików wykonywalnych.

6. Uruchom usługę:

   sudo systemctl start<service-name>

7. Sprawdź stan usługi, aby upewnić się, że jest ona prawidłowa:

   sudo systemctl status<service-name>

8. Posprzątać:

   rm -rf /tmp/groundrunner-update

Obowiązkowa kontrola dostępu (SELinux / AppArmor)

Jeśli host wymusza obowiązkową politykę kontroli dostępu (SELinux, AppArmor lub podobne), zastąpienie plików binarnych na dysku może spowodować awarię usługi. 

Aby uzyskać informacje na temat zarządzania zasadami bezpieczeństwa dotyczącymi usług niestandardowych, zapoznaj się z dokumentacją dystrybucji.

Uwaga: Inne oprogramowanie zabezpieczające — takie jak FAPOLICYD, IMA/EVM lub niestandardowe monitorowanie integralności plików — może również blokować wykonywanie zastąpionych plików binarnych. Jeśli usługa nie uruchomi się po aktualizacji i wykluczyłeś SELinux/AppArmor, sprawdź, czy jakieś dodatkowe struktury zabezpieczeń w systemie wymagają zaktualizowania list zaufanych lub podpisów plików.

Weryfikacja

Możesz sprawdzić, czy GroundRunner jest aktywny i czy jego wersja jest poprawna, postępując zgodnie z instrukcjami podanymi w Jak sprawdzić status GroundRunnera?

Zachęcamy do utworzenia i uruchomienia „łańcucha pilotażowego”, który uruchomi zestaw testowy poleceń w GroundRunnerze, aby mieć pewność, że instalacja przebiegnie prawidłowo. 

Zachęcamy również do monitorowania systemu i aktywności GroundRunnera bezpośrednio po jego aktualizacji i ponownym uruchomieniu. Dzięki temu masz pewność, że wszystko działa prawidłowo. Można to zrobić za pomocą polecenia CLI, aby przesyłać strumieniowo i przeglądać nowe wpisy w dzienniku na bieżąco.

Dla systemu Windows

Aby wyświetlić koniec pliku dziennika za pomocą programu PowerShell, wprowadź następujące polecenie:

Get-Content -Path "C:\ścieżka_do_\output.log" -Tail 10 -Wait

Dzięki temu okno programu PowerShell pozostaje otwarte, a nowe wpisy dziennika są przesyłane w czasie rzeczywistym. -tail 10 ładuje ostatnie 10 wierszy natychmiast.

Dla Linuksa

Aby wyświetlić koniec pliku dziennika i przesyłać strumieniowo nowe wpisy w czasie rzeczywistym, wprowadź następujące polecenie:

tail -f /ścieżka_do/wyjścia.log

Cofnij

Jeśli nowa wersja nie działa prawidłowo, możesz przywrócić poprzednią wersję, wykonując następujące czynności:

1. Zatrzymaj usługę GroundRunner w sposób opisany powyżej.
2. Zmień nazwę zainstalowanych plików GroundRunner.exe i GroundRunnerMonitor.exe.
3. Skopiuj GroundRunner.exe.bak i GroundRunnerMonitor.exe.bak z lokalizacji kopii zapasowej do katalogu instalacyjnego. 
4. Zmień nazwę tych plików, usuwając rozszerzenie „.bak”.
5. Uruchom ponownie usługę GroundRunner, wykonując odpowiednie kroki opisane powyżej.

Uwaga: Te same instrukcje dotyczą systemu Linux GroundRunners, ale konieczne będzie wyodrębnienie plików binarnych z archiwum tarball.

Uwagi

• Nie zmieniaj nazw plików binarnych. Mechanizm automatycznej aktualizacji opiera się na domyślnych nazwach plików wykonywalnych (GroundRunner i GroundRunnerMonitor w systemie Linux oraz GroundRunner.exe i GroundRunnerMonitor.exew systemie Windows) w celu wykrywania i stosowania przyszłych aktualizacji. Zmiana nazwy spowoduje przerwanie automatycznych aktualizacji.
• macOS jest obsługiwany wyłącznie w celach programistycznych. Nie jest to obsługiwana platforma produkcyjna.
• Inni menedżerowie usług: Powyższe przykłady wykorzystują systemd (Linux) i Menedżera kontroli usług systemu Windows. Jeśli w Twoim środowisku używany jest inny menedżer usług lub nadzorca procesów, wykonaj odpowiednie kroki zatrzymania, zastąpienia i uruchomienia dla swojej konfiguracji.
• Domyślnie GroundRunners korzysta z lokalnego konta administracyjnego i nie ma dostępu do zasobów zdalnych, takich jak dyski współdzielone. Aby uzyskać dostęp do współdzielonego zasobu, takiego jak ścieżka UNC systemu Windows, należy uruchomić GroundRunner na koncie użytkownika mającego odpowiednie uprawnienia do zasobu. Jeśli używasz konta innego użytkownika niż domyślny lokalny administrator systemu, przyznaj mu uprawnienia do zarządzania katalogiem instalacyjnym GroundRunner, aby umożliwić automatyczne aktualizacje.