|
Метка: новое перенаправление |
(не показана 21 промежуточная версия 2 участников) |
Строка 1: |
Строка 1: |
| {{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}}
| | #REDIRECT [[Wiren_Board_Software]] |
| == Общая информация ==
| |
| {{Anchor|info}}
| |
| === Совместимость ===
| |
| {{Anchor|compatibility}}
| |
| Инструкции на этой странице подходят для контроллеров Wiren Board 6.x, 7.x.
| |
| | |
| Исключение — контроллеры Wiren Board 7.2.1A, выпущенные в декабре 2021 г — перед обновлением или возвратом заводских настроек, [[Wiren_Board_v7.2.1A_Create_Restore_Folder | переключите их на релиз]], а потом используйте инструкции на этой странице.
| |
| | |
| === Кратко о релизах ===
| |
| {{Anchor|releases}}
| |
| [[Image: WB SW Releases.png |300px|thumb|right| Релизный цикл ПО Wiren Board]]
| |
| Программное обеспечение контроллеров Wiren Board состоит из множества пакетов, которые мы объединяем в релизы:
| |
| * '''Stable''' — стабильный релиз: обновление пакетов раз в три месяца и исправления критических ошибок. Рекомендуем для инсталляций, которые делает интегратор и которые работают сейчас.
| |
| * '''Testing''' — тестовый релиз: свежие версии пакетов с новыми функциями и исправлениями, но возможно и с новыми ошибками. Рекомендуем для активных пользователей (DIY), для инсталляций на стадии стройки и проектирования.
| |
| | |
| Стабильные релизы имеют номер вида ''wb-YYMM'', где ''YY'' — год, а ''MM'' — месяц выпуска. Например, ''wb-2104'' — релиз, выпущенный в апреле 2021 года.
| |
| | |
| Мы будем рады, если вы сможете присоединиться к использованию ''testing'', ведь кроме получения новых фич вы поможете уменьшить количество ошибок в ''stable''.
| |
| | |
| {{Wbincludes:Release Log}}
| |
| | |
| === Какой релиз на вашем контроллере ===
| |
| {{Anchor|what-release}}
| |
| [[Image: System Information.png |300px|thumb|right| Версия ПО в веб-интерфейсе контроллера<br>''WebUI'' → ''Devices'' → ''System'']]
| |
| С завода на контроллерах Wiren Board установлен актуальный на момент производства стабильный релиз.
| |
| | |
| Узнать версию релиза можно в веб-интерфейсе контроллера в разделе '''Устройства''' в карточке устройства '''System''' или в консоли командой <code>wb-release</code>. Если в веб-интерфейсе нет упоминания о testing или stable или команда ''wb-release'' не найдена — у вас старая версия ПО и нужно [[New repository April 2021 | сменить репозиторий]].
| |
| | |
| === Переключение между релизами ===
| |
| {{Anchor|switching-release}}
| |
| Между релизами можно переключаться вручную. Сделайте резервную копию настроек, подключитесь к контроллеру через [[SSH]] и выполните одну из команд:
| |
| * Переход со стабильного на тестовый:
| |
| *:<syntaxhighlight lang="bash">
| |
| wb-release -t testing
| |
| </syntaxhighlight>
| |
| * Переход с тестового на стабильный:
| |
| *:<syntaxhighlight lang="bash">
| |
| wb-release -t stable
| |
| </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 — ''wb-mqtt-serial.conf''
| |
| * дашборды, виджеты и настройки веб-интерфейса — ''wb-webui.conf'';
| |
| * модулей ввода-вывода и расширения — ''wb-hardware.conf'';
| |
| * универсальных входов/выходов A1-A4 — ''wb-mqtt-adc.conf'';
| |
| * выводов GPIO контроллера — ''wb-mqtt-gpio.conf'';
| |
| * настройки архива данных — ''wb-mqtt-db.conf'';
| |
| * шлюза OPC UA — ''wb-mqtt-opcua.conf'';
| |
| * шлюза Modbus TCP/Slave — ''wb-mqtt-mbgate.conf''.
| |
| | |
| Кроме этого, по адресу <code>/mnt/data/etc/</code> хранятся:
| |
| * ''wb-rules'' — пользовательские скрипты;
| |
| * ''wb-rules-module''— модули, написанные на wb-rules;
| |
| * ''wb-mqtt-serial.conf.d/templates/'' — пользовательские шаблоны.
| |
| | |
| Где хранятся настройки установленного стороннего ПО, уточняйте в его документации.
| |
| | |
| ===Резервное копирование===
| |
| {{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 ===
| |
| {{Anchor|apt}}
| |
| [[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']]
| |
| {{note|note|Рекомендуемый способ. Если последний раз ПО контроллера обновлялось до апреля 2021 года, то сперва вам нужно перейти на релизы, для этого [[New_repository_April_2021 | смените репозиторий]].}}
| |
| Apt — это менеджер пакетов операционной системы Debian, который обновляет изменившиеся пакеты и устанавливает новые, если это необходимо. Для работы нужен интернет или [https://wiki.debian.org/ru/CreateLocalRepo локальное зеркало] apt-репозитория Wiren Board.
| |
| | |
| Обновление контроллера через apt учитывает [[#Кратко о релизах | систему релизов]] — следуя инструкции, вы полностью перейдёте на новый релиз, а не только обновите отдельные пакеты.
| |
| | |
| При обновлении сохраняются установленные программы, пользовательские файлы и настройки.
| |
| | |
| Чтобы обновить прошивку контроллера:
| |
| # Подключитесь к нему по [[SSH]].
| |
| # Выполните команды:
| |
| #:<syntaxhighlight lang="bash">
| |
| apt update; apt upgrade
| |
| </syntaxhighlight>
| |
| | |
| Важно! В релизе wb-2304 сменилась версия Debian, поэтому при переходе со старых релизов wb-21**/wb-22** надо ввести дополнительную команду ([[wb-2304|подробнее]]):
| |
| :<syntaxhighlight lang="bash">
| |
| wb-release --update-debian-release
| |
| </syntaxhighlight>
| |
| | |
| В процессе обновления может появиться запрос на действие с файлами конфигурации. Если не знаете, что выбрать — оставьте значение по умолчанию '''keep the local version currently installed''', так вы сохраните свои настройки.
| |
| | |
| Так же в консоль будут выводиться служебные сообщения и запросы на действия, которые могут повредить систему или удалить пользовательские настройки — внимательно читайте вопросы перед тем, как ввести <code>Y</code>.
| |
| | |
| === Через веб-интерфейс ===
| |
| {{Anchor|web-ui}}
| |
| {{Wbincludes:Fit Files}}
| |
| | |
| {{Wbincludes:WebUI Change Access Level}}
| |
| | |
| {{Wbincludes:Firmware Update Fit Save Data}}
| |
| | |
| Чтобы обновить прошивку контроллера:
| |
| # Скачайте fit-файл прошивки на компьютер.
| |
| # Зайдите в [[Wiren Board Web Interface | веб-интерфейс]] контроллера и перейдите в раздел '''Settings''' → '''System'''. В старых версиях WebUI кнопка ''Select file'' находится в разделе '''Settings'''.
| |
| # Нажмите кнопку '''Select File''' и выберите скачанный ранее fit-файл.
| |
| # Файл с прошивкой загрузится на контроллер и начнётся обновление, которое длится 5-10 минут. Не закрывайте страницу и не выключайте контроллер до завершения.
| |
| # После обновления контроллер перезагрузится.
| |
| | |
| После завершения обновления подключитесь к контроллеру заново и обновите страницу веб-интерфейса в браузере со сбросом кэша (Ctrl+F5 для Chrome), чтобы загрузилась обновленная версия. Проверьте версию прошивки на странице '''Devices''' → '''System'''.
| |
| <gallery mode="packed " heights="150px">
| |
| Image: Web-Configs-2.0 system.png | Нажмите кнопку '''Select file''' и выберите fit-файл
| |
| Image: Web-settings-firmware-update-messages.png | Во время обновления на страницу выводятся системные сообщения
| |
| Image: sw-release.png | Текущая версия прошивки контроллера
| |
| </gallery>
| |
| | |
| == Удаление данных и другие способы обновления==
| |
| {{Anchor|factory-reset}}
| |
| Обновление через apt или веб-интерфейс полностью покрывает задачи по обслуживанию контроллера.
| |
| | |
| Однако если эти способы не подходят, или вам нужно удалить данные с возвратом к заводским настройкам, это тоже можно сделать. Смотрите инструкции для каждой версии контроллера по ссылкам [[Wiren_Board_6_Firmware_Update | Wiren Board 6.x]] и [[Wiren_Board_7_Firmware_Update | Wiren Board 7.x]].
| |