BlogKontakt

Aktualizacja z 1.5 do 1.6

Lista kontrolna dla sterownika, który już działa na 1.5 — co zrobić przed aktualizacją, w trakcie i po niej.

Wersja 1.6 to największa jak dotąd zmiana panelu: pojawiają się konta i hasła, ustawienia są inaczej poukładane, a kilka zabezpieczeń zostaje włączonych. Twoja konfiguracja — wyjścia, wejścia, rolety, akcje — zostaje bez zmian. Przejście przez tę listę zajmuje około dziesięciu minut, plus sama aktualizacja — która może potrwać nawet godzinę.

Nie wiesz, co nowego? Zacznij od strony Co nowego w 1.6.

1. Przed aktualizacją

  1. Najpierw zaktualizuj do 1.5.6. Tylko 1.5.6 czysto przekazuje przeglądarkę nowemu panelowi. Ze starszej 1.5 stary panel może wracać po aktualizacji, dopóki nie naciśniesz Ctrl+Shift+R.
  2. Zrób kopię zapasową. W panelu 1.5 otwórz zakładkę System, znajdź sekcję Kopia Zapasowa i pobierz kopię na komputer. Sama aktualizacja jej nie robi. Jeśli możesz, skopiuj też po SSH folder /home/boneio/boneio.
  3. Zarezerwuj do godziny i nie wyłączaj zasilania. Na sterowniku z 1.5 aktualizacja uruchamia przy starcie migracje systemu. Wyświetlacz i panel mówią, co się dzieje. Nie odcinaj zasilania w trakcie — bezpiecznie jest z UPS-em.
  4. Miej fizyczny dostęp do sterownika — czytnik kart SD albo konsolę szeregową. 1.6 zmienia sposób, w jaki boneIO uzyskuje uprawnienia administratora w systemie. Przetestowaliśmy to na własnych sterownikach, ale błąd na tym etapie to taki, który wymaga naprawy na miejscu.

2. Zainstaluj aktualizację

W panelu 1.5: System → Sprawdź Aktualizacje → Aktualizuj do 1.6.0 albo zainstaluj aktualizację boneIO w Home Assistant. Poczekaj, aż sterownik się zrestartuje i skończy migracje — wyświetlacz pokazuje w tym czasie Do not power off i postęp. Zobacz Aktualizacja sterownika.

3. Otwórz panel ponownie — teraz przez HTTPS

Otwórz https://<IP sterownika>:8443 i od teraz używaj tego adresu. Stara zakładka http://…:8090 może jeszcze otwierać panel, ale bez szyfrowania — w kroku 5 to wyłączysz. Jeśli przeglądarka ostrzega o certyfikacie, tak ma być — zobacz Połączenie ze sterownikiem.

4. Utwórz konto administratora

To, co zobaczysz, zależy od tego, czy panel 1.5 miał hasło:

  • Miałeś hasło w config.yaml (web.auth) — kreatora nie będzie. To konto zostanie przeniesione automatycznie: zaloguj się starą nazwą i hasłem. Hasło SSH w tym przypadku się nie zmienia; krok 5 pokaże, jeśli wciąż jest to Black.
  • Nie miałeś hasła — panel zaczyna od krótkiego kreatora: Start → Konto → Gotowe. Wybierz nazwę użytkownika i hasło do panelu (zasady opisuje Pierwsze uruchomienie). Jeśli hasło SSH użytkownika boneio było wciąż fabrycznym Black, stanie się nim też Twoje nowe hasło.

W obu przypadkach Twoja konfiguracja zostaje nietknięta.

5. Przejrzyj listę bezpieczeństwa

Zaraz po zalogowaniu panel pokaże Zalecenia bezpieczeństwa z liczbą rzeczy do sprawdzenia. Kliknij Pokaż bezpieczeństwo (albo później: Ustawienia → Dostęp → Bezpieczeństwo). Każda pozycja ma krótkie wyjaśnienie i — tam, gdzie panel może to naprawić — przycisk, który to robi. Na sterowniku zaktualizowanym z 1.5 zwykle zobaczysz:

PozycjaCo zrobić
Stare dane logowania w config.yamlKliknij Usuń i potwierdź — stary blok z hasłem zostanie usunięty (wcześniej zapisuje się kopia config.yaml). Logujesz się dalej tak samo.
Hasło brokera MQTTSterownik łączy się ze swoim brokerem hasłem fabrycznym. Kliknij Napraw, ustaw nowe hasło użytkownika boneio i zostaw włączone Zaktualizuj też konfigurację boneIO — sterownik sam połączy się ponownie.
Hasło logowania SSHJeśli wciąż jest fabryczne, zmień je w Ustawienia → Dostęp → Konta użytkowników → Hasło logowania SSH, podając hasło fabryczne jako obecne. Albo zaloguj się po SSH jako boneio i uruchom passwd.
Panel serwowany otwartym tekstemKliknij Schowaj za proxy i potwierdź. Po najbliższym restarcie panel odpowiada tylko pod https://…:8443 (i nadal pod http://192.168.7.2:8090 po kablu USB). Zmiana zostanie odrzucona, jeśli HTTPS jeszcze nie działa, więc nie odetniesz się od sterownika.
Certyfikat HTTPSOpcjonalnie — jak pozbyć się ostrzeżenia przeglądarki, opisuje Certyfikat HTTPS.

Nie teraz? Odłóż do jutra przesunie przypomnienie o dzień. Szczegóły: Bezpieczeństwo.

6. Sprawdź Home Assistant

  • Encje działają dalej — sterownik rozmawia z Home Assistant przez MQTT, a aktualizacja tego nie zmienia.
  • Zmiana hasła brokera dla boneio (krok 5) nie dotyczy Home Assistant — Home Assistant loguje się własnym kontem, zwykle homeassistant.
  • Warto zrobić: konta homeassistant i mqtt na sterowniku sprzed 1.6 też mają hasło fabryczne. Zmień je w Ustawienia → Usługi na sterowniku → Broker MQTT (lokalny), a potem wpisz nowe hasło w Home Assistant: Ustawienia → Urządzenia i usługi → MQTT → Konfiguruj. Dopóki tego nie zrobisz, Home Assistant pokazuje encje boneIO jako niedostępne.
  • Dodatek boneIO Black działa bez zmian.
  • Wyświetlasz panel w karcie dashboardu (iframe)? Dodaj adres Home Assistanta w Ustawienia → Dostęp → Bezpieczeństwo → Osadzanie panelu w innych stronach → Dodatkowy adres, któremu ufasz. Bez tego karta zostanie pusta.

7. Node-RED pyta teraz o hasło

Jeśli używasz Node-RED, poprosi on teraz o zalogowanie się kontem administratora boneIO. Twoje flow się nie zmieniają. Zaczyna to działać po restarcie Node-RED — po najbliższym restarcie sterownika albo zrestartuj go w Ustawienia → Usługi na sterowniku → Node-RED.

8. Co się przeniosło

Zakładki System już nie ma. Aktualizacja, kopie zapasowe, restart i reset fabryczny są w Ustawienia → Konserwacja; logi i narzędzia magistral są w Diagnostyce; edytor YAML jest w Ustawienia → Zaawansowane. Pełną mapę znajdziesz w Nawigacji po interfejsie.

9. Opcjonalnie: czytelne nazwy w YAML

W 1.6 wpisy w konfiguracji mogą mieć name: zamiast id: — identyfikator powstaje z nazwy. Stare pliki z id: działają dalej, więc nie musisz niczego zmieniać. Jeśli edytujesz YAML ręcznie i chcesz przejść na nazwy, zobacz Co nowego w 1.6.

Coś poszło nie tak?

  • Nie mogę się zalogować / zapomniałem hasła — zresetuj je po SSH: Konta i dostęp.
  • Sterownik nie startuje po aktualizacji — panel otworzy się w trybie ratunkowym; zobacz Rozwiązywanie problemów.
  • Chcesz wrócić do starszej wersji — Ustawienia → Konserwacja → Aktualizacja oprogramowania → Dostępne Wersje pozwala zainstalować starszą wersję. Najpierw napisz do nas na Discordzie: zmiany systemowe z 1.6 (np. zabezpieczenia SSH) zostają na miejscu.

Na tej stronie

1. Przed aktualizacją2. Zainstaluj aktualizację3. Otwórz panel ponownie — teraz przez HTTPS4. Utwórz konto administratora5. Przejrzyj listę bezpieczeństwa6. Sprawdź Home Assistant7. Node-RED pyta teraz o hasło8. Co się przeniosło9. Opcjonalnie: czytelne nazwy w YAMLCoś poszło nie tak?