Ponowne uruchomienie GroundRunnera

Aby ponownie uruchomić GroundRunner po jego zatrzymaniu, wykonaj poniższe czynności.

Ważne: W niniejszym dokumencie odniesienia do „GroundRunner” oznaczają uruchomienie procesu „GroundRunnerMonitor” (w systemie Linux jest to „GroundRunnerMonitor”, a w systemie Windows „GroundRunnerMonitor.exe”).
Nie uruchamiaj bezpośrednio programu GroundRunner (Linux) ani GroundRunner.exe (Windows) — za zarządzanie jego działaniem odpowiada monitor.

Wymagania wstępne

Dostęp do komputera hosta, na którym zainstalowany jest GroundRunner
Katalog instalacyjny, w którym znajdują się pliki binarne
Zezwolenie na uruchamianie usług lub procesów na maszynie

Zweryfikuj pliki binarne

Przed próbą uruchomienia GroundRunnera użyj następujących poleceń, aby sprawdzić, czy pliki binarne nadal znajdują się w katalogu instalacyjnym. Twój katalog instalacyjny może być inny.

Dla Linuksa

ls /ścieżka/do/groundrunner/instalacja/GroundRunner ls /ścieżka/do/groundrunner/instalacja/GroundRunnerMonitor

Dla systemu Windows

dir C:\ścieżka\do\groundrunner\install\GroundRunner.exe dir C:\ścieżka\do\groundrunner\install\GroundRunnerMonitor.exe

Jeśli brakuje któregoś z plików binarnych, musisz przywrócić go z kopii zapasowej lub zainstalować go ponownie przed kontynuacją.

Linux

Uwaga: Poniższe instrukcje dotyczą dystrybucji Linuksa opartych na systemd. Jeśli w Twoim systemie używany jest inny system init lub nadzorca procesów, zapoznaj się z dokumentacją dystrybucji, aby uzyskać informacje na temat odpowiednich poleceń zarządzania usługami.

Jeśli nie znasz nazwy usługi, możesz jej poszukać, korzystając z następującego polecenia:
sudo systemctl list-units | grep -i groundrunner

Jeśli usługa nie jest rozpoznawana lub nie można jej znaleźć, GroundRunnerMonitor może nie zostać zarejestrowany jako usługa systemd. Zobacz Jeśli nie uruchamiasz GroundRunnera jako usługi monitorowanej poniżej.

Uruchom usługę systemd

Jeżeli GroundRunnerMonitor został skonfigurowany jako usługa systemd, uruchom go za pomocą następującego polecenia. Należy pamiętać, że nazwa usługi może się różnić w zależności od sposobu jej konfiguracji.
sudo systemctl start<service-name>
Sprawdź, czy jest uruchomiony:
sudo systemctl status<service-name>
(Opcjonalne, ale zalecane) Włącz usługę, aby uruchamiała się automatycznie po ponownym uruchomieniu systemu:
sudo systemctl enable<service-name>

Okna

Korzystanie z konsoli Usługi

Otwórz konsolę Usługi:
1. Naciśnij Win+R.
2. Wpisz services.msc
3. Naciśnij Enter.
Znajdź usługę GroundRunner na liście, kliknij ją prawym przyciskiem myszy i wybierz Uruchom.Kolumna

Status powinna zostać zaktualizowana na „Uruchomiona”.

Jeśli na liście nie ma usługi „GroundRunner”, proces GroundRunnerMonitor.exe mógł zostać skonfigurowany jako proces działający na pierwszym planie.

Korzystanie z wiersza poleceń

Alternatywnie możesz skorzystać z wiersza poleceń. Jeśli nie znasz nazwy usługi:

Naciśnij Win+R.
Wpisz cmd.
Wpisz sc query, aby uzyskać listę wszystkich usług.
Znajdź nazwę swojej usługi.
Wpisz sc start<service-name>.
Wpisz zapytanie sc<service-name> aby sprawdzić, czy działa.
Wartość pola „STATE” powinna być ustawiona na „RUNNING”.
(Opcjonalne, ale zalecane) Skonfiguruj usługę tak, aby uruchamiała się automatycznie po ponownym uruchomieniu systemu.
- Korzystanie z wiersza poleceń
  1. Naciśnij Win+R.
  2. Wpisz cmd.
  3. Naciśnij Enter.
  4. Wpisz sc config<service-name> start=auto w oknie poleceń i naciśnij Enter.
- Korzystanie z konsoli Usługi
  1. Naciśnij Win+R.
  2. Wpisz services.msc.
  3. Naciśnij Enter.
  4. W konsoli Usługi:
    1. Kliknij prawym przyciskiem myszy usługę GroundRunner.
    2. Kliknij Właściwości.
    3. Ustaw Typ uruchomienia na „Automatyczny”.
    4. Kliknij OK.

Weryfikacja

Po uruchomieniu GroundRunnera sprawdź, czy oczekiwana wersja (9.21.1) jest zgłaszana w aplikacji Workiva Chains i wyświetlana jako „Uruchomiona”.

Uwagi

Zawsze uruchamiaj GroundRunnerMonitor, a nie GroundRunner bezpośrednio —Proces GroundRunnerMonitor odpowiada za zarządzanie cyklem życia GroundRunner, w tym za stosowanie automatycznych aktualizacji. Bezpośrednie uruchomienie pliku binarnego GroundRunner omija to zarządzanie, co spowoduje pominięcie aktualizacji i nieoczekiwane zachowanie.
Konfiguracje niestandardowe — Jeśli w Twoim środowisku używany jest menedżer usług inny niż systemd lub Menedżer kontroli usług systemu Windows, wykonaj odpowiednią kontrolę uruchomienia i stanu dla swojej konfiguracji.
Nie zmieniaj nazw plików binarnych —Mechanizm automatycznej aktualizacji opiera się na domyślnych nazwach plików wykonywalnych (GroundRunner, GroundRunnerMonitor i GroundRunner.exe, GroundRunnerMonitor.exe) w celu wykrywania i stosowania przyszłych aktualizacji.
Regeneracja dotacji API —Nie trzeba regenerować dotacji API po ponownym uruchomieniu serwera GroundRunner. Dopóki usługa GroundRunner zostanie poprawnie zrestartowana po ponownym uruchomieniu i nawiąże ponowne połączenie z Workiva, istniejące zezwolenie API pozostanie ważne.
Skanowanie antywirusowe i GroundRunners —Uważamy, że najlepszym rozwiązaniem jest wykluczenie całego katalogu instalacyjnego GroundRunner i jego podfolderu tmp ze skanowania antywirusowego, zamiast wykluczania pojedynczych plików .exe. Zapobiega to podobnym blokadom w innych plikach wykonywalnych wtyczek.

Konfigurowanie GroundRunnera jako usługi monitorowanej

Linux (systemd)

Skonfiguruj GroundRunnerMonitor jako usługę systemd. Jeśli plik jednostki dla GroundRunnerMonitor jeszcze nie istnieje, należy go utworzyć. Przydatnym źródłem informacji na temat tego procesu jest podręcznik firmySUSE dotyczący konfigurowania usługi systemd. Jest to jednak źródło zewnętrzne i może wymagać dostosowania w konkretnym środowisku.

W pliku jednostki systemd upewnij się, że w obszarze [Service] znajdują się następujące ustawienia, aby proces automatycznie uruchamiał się ponownie po zakończeniu lub wystąpieniu błędu:

[Usługa] Restart=zawsze RestartSec=10

Po utworzeniu lub zaktualizowaniu pliku jednostki użyj następujących poleceń, aby przeładować systemd i włączyć usługę:

sudo systemctl daemon-reload sudo systemctl enable<service-name> sudo systemctl start

Okna

Zarejestruj GroundRunnerMonitor jako usługę systemu Windows. Po zarejestrowaniu skonfiguruj usługę tak, aby uruchamiała się ponownie w przypadku awarii. Albo:

Korzystanie z konsoli Usługi

Naciśnij Win+R.
Wpisz services.msc.
Naciśnij Enter.
W konsoli Usługi kliknij prawym przyciskiem myszy usługę GroundRunner.
Kliknij Właściwości.
Wybierz kartę Odzyskiwanie.
Ustaw wartości Pierwsza awaria, Druga awariai Kolejne awarie na „Uruchom ponownie usługę”.
Kliknij OK.

Korzystanie z wiersza poleceń

Naciśnij Win+R.
Wpisz cmd.
Naciśnij Enter.
Wprowadź następujące polecenie i naciśnij Enter:
sc failure<service-name> reset=0 actions=restart/10000/restart/10000/restart/10000
Polecenie to informuje system Windows, że usługa ma zostać ponownie uruchomiona po 10 sekundach od wystąpienia błędu.

Jeśli nie uruchomisz GroundRunnera jako usługi monitorowanej

Zalecamy, aby GroundRunnerMonitor był uruchamiany jako usługa z możliwością ponownego uruchomienia w systemie operacyjnym hosta, a nie jako proces pierwszego planu, ponieważ proces pierwszego planu nie przetrwa rozłączenia terminala, ponownego uruchomienia komputera ani automatycznych aktualizacji — a wszystkie te zdarzenia będą wymagały ręcznej interwencji w celu ponownego uruchomienia GroundRunner. Informacje na temat instalacji GroundRunners można znaleźć na stronie pomocy technicznej Workiva: Zainstaluj i zarządzaj GroundRunners.

Demonstracje wideo

Filmy te ilustrują procesy opisane powyżej.

Dla Linuksa

Dla systemu Windows

Wsparcie

Wspólnota

Centrum wsparcia Workiva