Wersja polska - procedura standardowa

Przewodnik konfiguracji RadarView Feeder

Ten przewodnik zawiera instrukcje dotyczące konfiguracji i uruchomienia zasilacza RadarView w Twoim systemie.

Wymagania wstępne

• Git: Będziesz potrzebować zainstalowanego Git, aby sklonować repozytorium w standardowej konfiguracji.
• Root Access: Musisz uruchomić skrypt konfiguracji z uprawnieniami administratora (np. za pomocą sudo).
• Python: Python 3 lub Python 2 musi być zainstalowany na Twoim systemie. Skrypt spróbuje wykryć właściwą wersję.
• Systemd: Skrypty zaprojektowano dla systemów używających systemd do zarządzania usługami.
• Internet Connection: Wymagane do klonowania repozytorium, pobierania niezbędnych plików (np. dump1090-fa, jeśli nie jest zainstalowany, lub radarview.py, jeśli skrypt pobiera go bezpośrednio w niektórych przypadkach).
• RadarView Token: Będzie potrzebny token RadarView w formacie ADS-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX. Token można uzyskać, rejestrując konto na stronie RadarView. Należy pamiętać, że aktywacja konta Feeder oraz pokazanie feedera jako online mogą potrwać do 5 minut po zakończeniu konfiguracji i uruchomieniu usługi.

Ta metoda polega na sklonowaniu repozytorium RadarView z GitHub, które zawiera skrypt radarview_setup.sh i skrypt zasilacza radarview.py.

Kroki:

1. Sklonuj repozytorium: Otwórz terminal i sklonuj repozytorium:
   
   
   

   git clone https://github.com/br3jski/radarview.git

2. Nawiguj do katalogu ze skryptem: Przejdź do katalogu utworzonego po sklonowaniu:
   
   

   cd radarview

   
   (Skrypty radarview_setup.sh i radarview.py powinny znajdować się w tym katalogu).
3. Ustaw uprawnienia wykonywania skryptu konfiguracji:
   
   

   chmod +x radarview_setup.sh

4. Uruchom skrypt konfiguracji: Wykonaj skrypt z uprawnieniami root:
   
   

   sudo ./radarview_setup.sh

5. Wprowadź swój token RadarView: Gdy pojawi się monit, wprowadź swój token RadarView. Skrypt zweryfikuje jego format.
   
   
   

   Please enter your RadarView token (format: ADS-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX): YOUR_TOKEN_HERE

6. Instalacja Dump1090 (jeśli potrzebna): Skrypt sprawdzi, czy zainstalowano dump1090-fa, dump1090-mutability, dump1090 lub readsb.
   • Jeśli żaden z nich nie zostanie znaleziony, zapyta, czy chcesz zainstalować dump1090-fa:
     
     

     Dump1090 / reADSB are not installed. Do you want to install it now? (y/n)

7. Konfiguracja i tworzenie usługi: Skrypt wykona następnie następujące czynności:
   • Będzie używać pliku radarview.py z bieżącego (sklonowanego) katalogu. Jeśli z jakiegoś powodu radarview.py nie będzie obecny w katalogu ale radarview_setup.sh zostanie uruchomiony, skrypt konfiguracji sam może spróbować pobrać go jako rozwiązanie awaryjne (zgodnie z jego wewnętrzną logiką: if [ ! -f radarview.py ]; then wget ...; fi).
   • Skopiuj radarview.py do /opt/radarview.py i nadaj mu prawa wykonywania.
   • Zaktualizuj /opt/radarview.py o podany USER_TOKEN.
   • Utwórz plik usługi systemd w /etc/systemd/system/radarview.service do zarządzania feederem.
   • Usługa będzie skonfigurowana do uruchamiania /opt/radarview.py przy użyciu wykrytego polecenia Pythona.
   • Przeładuj demona systemd, uruchom usługę radarview i włącz ją, aby uruchamiała się przy starcie systemu.
8. Zakończenie: Po ukończeniu tych kroków zobaczysz komunikat:
   
   

   Konfiguracja RadarView zakończona pomyślnie.

Co robi skrypt:

• Weryfikuje i przechowuje Twój token RadarView.
• Zapewnia, że radarview.py znajduje się w /opt/ i jest skonfigurowany z Twoim tokenem.
• Tworzy usługę systemd o nazwie radarview, która automatycznie uruchamia feeder.
• Opcjonalnie instaluje dump1090-fa, jeśli nie zostanie znaleziony dekoder ADS-B.

Kontrola po instalacji

Po instalacji możesz zweryfikować, że usługa działa poprawnie:

1. Sprawdź status usługi:
   
   

   sudo systemctl status radarview.service

   
   Powinieneś zobaczyć wynik wskazujący, że usługa jest czynna (uruchomiona). Pamiętaj, że może to zająć do 5 minut, aby Twój feeder pojawił się online w Twoim koncie RadarView.
2. Przeglądaj logi (w razie potrzeby): Jeśli napotkasz problemy, możesz sprawdzić logi usługi:
   
   
   

   sudo journalctl -u radarview.service -f

   
   To wyświetli na żywo logi. Naciśnij Ctrl+C, aby zakończyć.

Przegląd Skryptu Zasilacza (radarview.py)

Skrypt radarview.py odpowiada za:

• Łączenie z lokalnym źródłem danych (zwykle dump1090 lub podobnym dekoderem ADS-B) pod adresem 127.0.0.1:30003.
• Odbieranie danych ADS-B z tego lokalnego źródła.
• Przygotowywanie wiadomości z tokenem z użyciem Twojego USER_TOKEN.
• Przesyłanie każdego wiersza danych ADS-B, poprzedzonego wiadomością z tokenem, do serwera RadarView pod adresem feed.ads-b.pro:48581.
• Jeżeli połączenie zostanie utracone, spróbuje ponownie po krótkiej przerwie.

Rozwiązywanie problemów

• „Python not found”: Upewnij się, że Python (wersja 2 lub 3) jest zainstalowany i dostępny w ścieżce PATH systemu.
• „Failed to download radarview.py”: Sprawdź połączenie internetowe i to, czy wget jest zainstalowany. Upewnij się, że adres URL https://raw.githubusercontent.com/br3jski/radarview/main/radarview.py jest dostępny.
• „Failed to update radarview.py with token”: Może to wskazywać na problem z uprawnieniami lub nieoczekiwany format pliku /opt/radarview.py. Sprawdź plik ręcznie.
• Service not starting: Użyj sudo journalctl -u radarview.service, aby sprawdzić błędy. Typowe problemy mogą obejmować nieprawidłową ścieżkę Pythona w pliku usługi, dump1090 nie działający lub nie dostarczający danych na porcie 30003, lub problemy z łącznością sieciową do feed.ads-b.pro.
• Token Format Error: Upewnij się, że wpisujesz token dokładnie tak, jak podano, w formacie ADS- a następnie 32 znaki szesnastkowe.
• No additional functionalities available: Pozwól do 5 minut po uruchomieniu usługi, aby feeder zarejestrował się i pojawił online w naszym systemie. Upewnij się, że dump1090 (lub równoważny) działa i generuje dane na porcie 30003 lokalnie.

Jeśli nadal napotykasz problemy po sprawdzeniu tych kroków, prosimy o wysłanie e-maila na adres [email protected]. Prosimy dołączyć w e-mailu token Feeder RadarView.