Software Releases

Введение

В апреле 2021 года мы переделали систему обновления ПО контроллеров. Теперь обновления будут доступны через новый репозиторий (http://deb.wirenboard.com/).

Можно настроить одну из двух веток обновлений:

• тестовую (testing), в которой новые версии ПО будут публиковаться сразу после выпуска;
• стабильную (stable), которая будет обновляться раз в три месяца в формате больших релизов после тестирования.

Рекомендуем переключаться на testing всем тем, кому интересно пробовать новые функции.

Переключиться на новый репозиторий могут все пользователи Wiren Board версии 5.5 и новее.

В следующих разделах подробнее рассказано о том, как это работает и как можно начать использовать новый репозиторий на вашем Wiren Board.

Ветки обновления

testing

Новые версии пакетов в этой ветке публикуются практически сразу после появления. Перед публикацией проводится автотестирование обновления, чтобы не допустить попадания заведомо сломанных пакетов в репозиторий. Поэтому testing является лучшим способом быстро получить доступ к новым возможностям.

Раз в три месяца testing "замораживается" на месяц: команда Wiren Board начинает работу по исправлению ошибок в опубликованных версиях ПО, не добавляя при этом новые функции. Так мы готовим новые пакеты к выпуску нового стабильного релиза. После выпуска нового стабильного релиза testing "размораживается" и в нём снова начинают публиковаться новые версии пакетов.

Нам очень нужны пользователи, которые могут дать обратную связь по ошибкам и недостаткам в обновлениях. Обо всех проблемах с testing можно писать в техподдержку (https://support.wirenboard.com/), так мы сможем быстрее выпустить исправления.

stable

Пакеты в стабильных релизах уже прошли тестирование силами команды Wiren Board и пользователей ветки testing, поэтому мы рекомендуем использовать ветку stable в ответственных инсталляциях.

Эта ветка по умолчанию настроена на новых контроллерах Wiren Board.

Обновления в этой ветке публикуются в формате релизов раз в три месяца, подобно релизам Ubuntu или других программных продуктов. Каждый релиз имеет номер, например, wb-2104 - релиз, выпущенный в апреле 2021 года.

Если в уже опубликованном релизе обнаруживаются серьёзные ошибки, исправления публикуются сразу после их выхода.

Как начать пользоваться

Перейти на использование нового репозитория можно одним из следующих способов:

Прошивка fit-образа

Вы можете обновить прошивку контроллера целиком, для этого загрузите и прошейте fit-образ программного обеспечения.

Инструкцию по прошивке и ссылки на загрузку смотрите в статье Обновление прошивки контроллера Wiren Board.

Контроллер будет настроен на использование стабильной ветки (stable).

Обновление через Apt

Для тех, кому не подходит обновление прошивки с помощью fit-образа (например, есть важные установленные пакеты, которые потеряются при обновлении), мы подготовили альтернативный способ обновления с помощью Apt.

1. Добавьте вспомогательный репозиторий:

   echo "deb http://releases.contactless.ru/release-transitional stretch main" > /etc/apt/sources.list.d/wb-release-transitional.list
   

2. Обновите систему с новым репозиторием:

   apt update && apt dist-upgrade
   

   В систему будет установлен пакет wb-configs с новыми настройками Apt.

3. После завершения обновления обновите систему ещё раз:

   apt update && apt dist-upgrade
   

   Программное обеспечение контроллера переключится на один из релизов и обновится:

   • если у вас раскомментирована запись в файле /etc/apt/sources.list.d/wb-unstable.list, то контроллер переключится на ветку testing.
   • в остальных случаях контроллер переключится на ветку stable.

4. Теперь можно отключить вспомогательный репозиторий, он больше не потребуется:

   rm /etc/apt/sources.list.d/wb-release-transitional.list
   

Как узнать версию установленного ПО

Версия ПО в веб-интерфейсе для stable

Версия ПО в веб-интерфейсе для testing

Консоль

При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза:

__      _(_)_ __ ___ _ __ | |__   ___   __ _ _ __ __| |
\ \ /\ / / | '__/ _ \ '_ \| '_ \ / _ \ / _` | '__/ _` |
 \ V  V /| | | |  __/ | | | |_) | (_) | (_| | | | (_| |
  \_/\_/ |_|_|  \___|_| |_|_.__/ \___/ \__,_|_|  \__,_|
                                                       
Welcome to Wirenboard 6.7.2 (s/n A6XXXXXX), release wb-2104 (as stable)
Linux wirenboard-A6XXXXXX 4.9.22-wb1 #2 SMP Sun Apr 18 18:12:58 UTC 2021 armv7l GNU/Linux

~#

Также можно использовать команду wb-release, пример для stable-ветки:

~# wb-release
Wirenboard release wb-2104 (as stable), target wb6/stretch

You can get this info in scripts from /usr/lib/wb-release.

Веб-интерфейс

Чтобы посмотреть текущую версию ПО в веб-интерфейсе:

1. Перейдите в раздел Devices
2. Найдите устройство System. Название текущего релиза в поле Release suite, а версия ПО в поле wb-2104.

Переключение между релизами

Для переключения между релизами используйте утилиту wb-release с флагом -t. При переключении утилита автоматически обновит текущий релиз до актуального состояния, а потом переключит релизы и обновит систему еще раз.

Если в процессе работы утилиты произошел сбой, то она постарается вернуть настройки apt.

После смены репозитория мы рекомендуем перезагрузить контроллер на случай, если обновилось ядро.

Testing

Для переключения на testing-релиз выполните команду:

wb-release -t testing

Stable

Для переключения на stable-релиз выполните команду:

wb-release -t stable

Заморозить релиз

Вы можете заморозить состояние ПО контроллера на текущем стабильном релизе, но мы не рекомендуем это делать — вы останетесь без обновлений. Заморозка релиза может быть нужна в особо ответственных применениях.

Для заморозки укажите в параметрах wb-release текущую версию stable-релиза:

wb-release -t wb-2104