Aktualizacja przez SSH

Ta instrukcja opisuje ręczną aktualizację sterownika przez SSH. Jest przydatna gdy:

• Chcesz zainstalować konkretną wersję oprogramowania
• Aktualizacja przez interfejs webowy nie działa
• Potrzebujesz większej kontroli nad procesem aktualizacji

Wymagania

• Połączenie SSH ze sterownikiem (zobacz instrukcję połączenia SSH)
• Dostęp do internetu na sterowniku

Proces aktualizacji

Krok 1: Zatrzymaj usługę boneIO

sudo systemctl stop boneio

Podaj hasło SSH użytkownika boneio. Na sterowniku skonfigurowanym z wersją 1.6 lub nowszą to hasło, które wybrałeś w pierwszym uruchomieniu.

Krok 2: Aktywuj środowisko wirtualne

source ~/boneio/venv/bin/activate

Krok 3: Zaktualizuj pip

pip3 install --upgrade pip

Krok 4: Zaktualizuj boneIO

pip3 install --upgrade boneio

Krok 5: Uruchom usługę boneIO

sudo systemctl start boneio

Uproszczona wersja

Możesz wykonać wszystkie komendy w trzech sekwencjach:

sudo systemctl stop boneio

source ~/boneio/venv/bin/activate && pip3 install --upgrade pip && pip3 install --upgrade boneio

sudo systemctl start boneio

Instalacja konkretnej wersji

Aby zainstalować konkretną wersję:

pip3 install boneio==1.6.0

Zamień 1.6.0 na żądaną wersję.

Sprawdzenie wersji

Aby sprawdzić aktualnie zainstalowaną wersję:

pip3 show boneio | grep Version

Ważne zmiany

W przypadku wprowadzania ważnych zmian w aplikacji, zawsze informujemy o nich w informacjach o wydaniu. Prosimy o uważne czytanie tych informacji przed aktualizacją.

Rozwiązywanie problemów

Błąd podczas instalacji pip

Jeśli pojawi się błąd związany z pip, spróbuj:

python3 -m pip install --upgrade pip

Aplikacja nie uruchamia się po aktualizacji

Sprawdź logi:

journalctl -u boneio -f

Jeśli występują błędy konfiguracji, może być konieczne dostosowanie pliku config.yaml do nowej wersji. Od 1.6 sterownik z uszkodzoną konfiguracją nie restartuje się w kółko — zamiast tego panel otwiera się w trybie ratunkowym, gdzie zobaczysz błąd i go poprawisz. Zobacz Rozwiązywanie problemów.

Aktualizacja z 1.5 przez SSH

Po pierwszym starcie 1.6 otwórz panel pod https://<IP sterownika>:8443 — poprosi o utworzenie konta administratora (jeśli panel 1.5 miał hasło w web.auth, zaloguj się nim). Migracje systemowe wykonają się same przy tym pierwszym starcie. Zobacz Aktualizacja z 1.5 do 1.6.