16 187
правок
Wiren Board Firmware Update: различия между версиями
→В консоли через apt
| (не показано 35 промежуточных версий 6 участников) | |||
| Строка 1: | Строка 1: | ||
{{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}} | {{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}} | ||
== Общая информация == | == Общая информация == | ||
{{Anchor|info}} | |||
=== Совместимость === | === Совместимость === | ||
Инструкции на этой странице подходят для контроллеров Wiren Board 5.x, 6.x, 7.x. | {{Anchor|compatibility}} | ||
Инструкции на этой странице подходят для контроллеров Wiren Board 5.x, 6.x, 7.x. | |||
Исключения: | Исключения: | ||
* Контроллеры Wiren Board 5.x с версией прошивки 0.46-20190613 — их можно обновить только через | * Контроллеры Wiren Board 5.x с версией прошивки 0.46-20190613 — их можно обновить только через [[Wiren_Board_5:_Восстановление_прошивки |восстановление прошивки]]. | ||
* Контроллеры Wiren Board 7.2.1A, выпущенные в декабре 2021 г — перед обновлением или возвратом заводских настроек, [[Wiren_Board_v7.2.1A_Create_Restore_Folder | переключите их на релиз]], а потом используйте инструкции на этой странице. | * Контроллеры Wiren Board 7.2.1A, выпущенные в декабре 2021 г — перед обновлением или возвратом заводских настроек, [[Wiren_Board_v7.2.1A_Create_Restore_Folder | переключите их на релиз]], а потом используйте инструкции на этой странице. | ||
Для обновления контроллеров Wiren Board 4 и старее нужно [[Создание microSD-карты с образом | записать новый образ на карту microSD]]. | |||
=== Кратко о релизах === | === Кратко о релизах === | ||
[[Image: | {{Anchor|releases}} | ||
[[Image: WB SW Releases.png |300px|thumb|right| Релизный цикл ПО Wiren Board]] | |||
Программное обеспечение контроллеров Wiren Board состоит из множества пакетов, которые мы объединяем в релизы: | Программное обеспечение контроллеров Wiren Board состоит из множества пакетов, которые мы объединяем в релизы: | ||
* '''Stable''' — стабильный релиз: обновление пакетов раз в три месяца и исправления критических ошибок. | * '''Stable''' — стабильный релиз: обновление пакетов раз в три месяца и исправления критических ошибок. Рекомендуем для инсталляций, которые делает интегратор и которые работают сейчас. | ||
* '''Testing''' — тестовый релиз: свежие версии пакетов с новыми функциями, | * '''Testing''' — тестовый релиз: свежие версии пакетов с новыми функциями и исправлениями, но возможно и с новыми ошибками. Рекомендуем для активных пользователей (DIY), для инсталляций на стадии стройки и пусконаладки. | ||
Стабильные релизы имеют номер вида ''wb-YYMM'', где ''YY'' — год, а ''MM'' — месяц выпуска. Например, ''wb-2104'' — релиз, выпущенный в апреле 2021 года. | Стабильные релизы имеют номер вида ''wb-YYMM'', где ''YY'' — год, а ''MM'' — месяц выпуска. Например, ''wb-2104'' — релиз, выпущенный в апреле 2021 года. | ||
Мы будем рады, если вы сможете присоединиться к использованию ''testing'', ведь кроме получения новых фич вы поможете уменьшить количество ошибок в ''stable''. | |||
{{Wbincludes:Release Log}} | {{Wbincludes:Release Log}} | ||
=== Какой релиз на вашем контроллере === | === Какой релиз на вашем контроллере === | ||
{{Anchor|what-release}} | |||
[[Image: System Information.png |300px|thumb|right| Версия ПО в веб-интерфейсе контроллера<br>''WebUI'' → ''Devices'' → ''System'']] | |||
С завода на контроллерах Wiren Board установлен актуальный на момент производства стабильный релиз. | С завода на контроллерах Wiren Board установлен актуальный на момент производства стабильный релиз. | ||
Узнать версию релиза можно в веб-интерфейсе контроллера в разделе ''Devices'' в карточке устройства ''System'' или в консоли командой <code>wb-release</code>. Если в веб-интерфейсе нет упоминания о testing или stable или команда ''wb-release'' не найдена — у вас старая версия ПО и нужно сменить репозиторий. | Узнать версию релиза можно в веб-интерфейсе контроллера в разделе ''Devices'' в карточке устройства ''System'' или в консоли командой <code>wb-release</code>. Если в веб-интерфейсе нет упоминания о testing или stable или команда ''wb-release'' не найдена — у вас старая версия ПО и нужно [[New repository April 2021 | сменить репозиторий]]. | ||
=== Переключение между релизами === | === Переключение между релизами === | ||
Между релизами можно переключаться | {{Anchor|switching-release}} | ||
Между релизами можно переключаться вручную. Сделайте резервную копию настроек и выполните одну из команд: | |||
Сделайте резервную копию настроек и выполните одну из команд: | |||
* Переход со стабильного на тестовый: | * Переход со стабильного на тестовый: | ||
*:<syntaxhighlight lang="bash"> | *:<syntaxhighlight lang="bash"> | ||
| Строка 36: | Строка 42: | ||
*:<syntaxhighlight lang="bash"> | *:<syntaxhighlight lang="bash"> | ||
wb-release -t stable | wb-release -t stable | ||
</syntaxhighlight> | </syntaxhighlight> | ||
После смены релиза рекомендуем перезагрузить контроллер на случай, если обновилось ядро. | После смены релиза рекомендуем перезагрузить контроллер на случай, если обновилось ядро, а также обновить страницу веб-интерфейса в браузере со сбросом кэша (Ctrl+F5 для Chrome), чтобы загрузилась обновленная версия. | ||
== Пользовательские настройки и файлы == | == Пользовательские настройки и файлы == | ||
{{ | {{Anchor|user-files}} | ||
===Где хранятся настройки=== | |||
[[Image: Etc-wbconfigs.png |400px|thumb|right| Файлы настроек, которые сохраняются при обновлении через fit-файл]] | |||
В контроллере Wiren Board есть отдельный раздел, который монтируется в каталог <code>/mnt/data</code>, в котором по адресу <code>/mnt/data/etc</code> находятся настройки: | |||
* системные: сеть, часовой пояс, пароль к веб-интерфейсу, mosquitto, nginx; | |||
* устройств, подключенных по RS-485 — <code>wb-mqtt-serial.conf</code>; | |||
* модулей ввода-вывода и расширения — <code>wb-hardware.conf</code>; | |||
* универсальных входов/выходов A1-A4 — <code>wb-mqtt-adc.conf</code>; | |||
* выводов GPIO контроллера — <code>wb-mqtt-gpio.conf</code>; | |||
* настройки архива данных — <code>wb-mqtt-db.conf</code>; | |||
* шлюза OPC UA — <code>wb-mqtt-opcua.conf</code>; | |||
* шлюза Modbus TCP/Slave — <code>wb-mqtt-mbgate.conf</code>. | |||
Кроме этого, по адресу <code>/mnt/data/etc/</code> хранятся: | |||
* <code>wb-rules</code> — пользовательские скрипты; | |||
* <code>wb-rules-module</code> — модули, написанные на wb-rules; | |||
* <code>wb-mqtt-serial.conf.d/templates/</code> — пользовательские шаблоны. | |||
Где хранятся настройки установленного стороннего ПО, уточняйте в его документации. | |||
===Резервное копирование=== | |||
{{Anchor|backup}} | |||
Чтобы сделать резервную копию настроек контроллера, скопируйте содержимое <code>/mnt/data/etc</code> на [[Просмотр_файлов_контроллера_с_компьютера|компьютер]]. Программы, установленные в <code>/mnt/data</code> также нужно сохранить на компьютер. | |||
Если вы устанавливали на контроллер сторонние программы, или хранили файлы вне папки <code>/mnt/data</code> — их нужно сохранить отдельно. | |||
== Проверка обновлений == | == Проверка обновлений == | ||
{{ | {{Anchor|checking-updates}} | ||
В контроллере нет механизма, который сообщит пользователю о доступном обновлении, поэтому о выходе новых версий вы можете узнать из новостей в [https://wirenboard.com/ru/pages/contacts/ наших социальных сетях] или в консоли контроллера: | |||
# Подключитесь к контроллеру через [[SSH]]. | |||
# Выполните команду: | |||
#:<syntaxhighlight lang="bash" > | |||
apt update | |||
</syntaxhighlight> | |||
# Если есть пакеты для обновления, то можете посмотреть их список: | |||
#:<syntaxhighlight lang="bash"> | |||
apt list --upgradable | |||
</syntaxhighlight> | |||
== Обновление == | == Обновление == | ||
{{Anchor|update}} | |||
=== В консоли через apt === | === В консоли через apt === | ||
{{Anchor|apt}} | |||
[[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']] | [[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']] | ||
Apt — это менеджер пакетов операционной системы Debian, который обновляет изменившиеся пакеты и устанавливает новые, если это необходимо. | {{note|note|Рекомендуемый способ. Если последний раз ПО контроллера обновлялось до апреля 2021 года, то сперва вам нужно перейти на релизы, для этого [[New_repository_April_2021 | смените репозиторий]].}} | ||
Apt — это менеджер пакетов операционной системы Debian, который обновляет изменившиеся пакеты и устанавливает новые, если это необходимо. Для работы нужен интернет или [https://wiki.debian.org/ru/CreateLocalRepo локальное зеркало] apt-репозитория Wiren Board. | |||
Обновление контроллера через apt учитывает [[#Кратко о релизах | систему релизов]] — следуя инструкции, вы полностью перейдёте на новый релиз, а не только обновите отдельные пакеты. | |||
При обновлении сохраняются установленные программы, пользовательские файлы и настройки. | При обновлении сохраняются установленные программы, пользовательские файлы и настройки. | ||
| Строка 71: | Строка 110: | ||
=== Через веб-интерфейс === | === Через веб-интерфейс === | ||
{{Anchor|web-ui}} | |||
{{Wbincludes:Fit Files}} | {{Wbincludes:Fit Files}} | ||
| Строка 84: | Строка 124: | ||
# После обновления контроллер перезагрузится и на странице появится надпись '''Firmware update complete''' — обновление завершено. | # После обновления контроллер перезагрузится и на странице появится надпись '''Firmware update complete''' — обновление завершено. | ||
# Закройте страницу. | # Закройте страницу. | ||
После завершения обновления перезагрузите контроллер на случай, если обновилось ядро, а также обновите страницу веб-интерфейса в браузере со сбросом кэша (Ctrl+F5 для Chrome), чтобы загрузилась обновленная версия. | |||
<gallery mode="packed " heights="150px"> | <gallery mode="packed " heights="150px"> | ||
Image: web-settings.png | Нажмите кнопку '''Select file''' и выберите fit-файл | Image: web-settings.png | Нажмите кнопку '''Select file''' и выберите fit-файл | ||
| Строка 91: | Строка 133: | ||
== Удаление данных и другие способы обновления== | == Удаление данных и другие способы обновления== | ||
Обновление через apt или веб-интерфейс полностью | {{Anchor|factory-reset}} | ||
Обновление через apt или веб-интерфейс полностью покрывает задачи по обслуживанию контроллера. | |||
Однако | Однако если эти способы не подходят, или вам нужно удалить данные с возвратом к заводским настройкам, это тоже можно сделать. Смотрите инструкции для каждой версии контроллера по ссылкам [[Wiren_Board_5_Firmware_Update | Wiren Board 5.x]], [[Wiren_Board_6_Firmware_Update | Wiren Board 6.x]] и [[Wiren_Board_7_Firmware_Update | Wiren Board 7.x]]. | ||