Software Releases: различия между версиями

Материал из Wiren Board
(→‎Как начать пользоваться: Стандартный → старый)
(Убрал лишнее, теперь нужно поправить)
Строка 1: Строка 1:
{{DISPLAYTITLE: Релизы ПО Wiren Board}}
{{DISPLAYTITLE: Релизы ПО Wiren Board}}
== Изменения ==
== Описание ==
С апреля 2021 года программное обеспечение контроллера Wiren Board выпускается в формате периодических релизов, также изменился путь к основному репозиторию.
Все контроллеры, отгружаемые с мая 2021 года прошиты одним из стабильных релизов. Если вы покупали контроллер раньше — проверьте установленную на нём версию программного обеспечения.  


Новые релизы доступны для контроллеров Wiren Board версии 5.5 и новее.
Если у вас строк Release name и Release suite, то вам нужно перейти на новый репозиторий ПО Wiren Board. Как это сделать читайте в статье  [[Software Releases Old | Новый репозиторий Wiren Board]].
 
=== Старый репозиторий ===
Старый репозиторий находится по адресу http://releases.contactless.ru/. Обновления в него перестанут публиковаться [[#Автоматический переход | в скором времени]].
 
=== Новый репозиторий ===
Новый репозиторий находится по адресу http://deb.wirenboard.com/.


== Ветки релизов ==
== Ветки релизов ==
Строка 29: Строка 23:


Если в релизе будут обнаружены критические ошибки — мы опубликуем исправления сразу после их выхода, не дожидаясь очередной даты релиза.
Если в релизе будут обнаружены критические ошибки — мы опубликуем исправления сразу после их выхода, не дожидаясь очередной даты релиза.
== Как начать пользоваться ==
Если вы используете [[#Старый репозиторий |старый репозиторий]] Wiren Board и хотите перейти на работу с релизами, выполните несколько шагов.
=== Прошивка fit-образа ===
Вы можете обновить прошивку контроллера целиком, для этого загрузите и прошейте fit-образ программного обеспечения.
Инструкцию по прошивке и ссылки на загрузку смотрите в статье [[Wiren Board Firmware Update#Обновление прошивки целиком | Обновление прошивки контроллера Wiren Board]].
В контроллер будет зашит последний стабильный релиз (stable).
=== Обновление через Apt ===
Для тех, кому не подходит обновление прошивки с помощью fit-образа мы подготовили способ обновления с помощью стандартного менеджера пакетов Apt:
# Добавьте вспомогательный репозиторий:
#::<syntaxhighlight lang="bash">
echo "deb http://releases.contactless.ru/release-transitional stretch main" > /etc/apt/sources.list.d/wb-release-transitional.list
</syntaxhighlight>
# Выполните команды:
#:<syntaxhighlight lang="bash">
apt update && apt dist-upgrade
</syntaxhighlight>
#: в систему будет установлен пакет <code>wb-configs</code>
# После завершения обновления выполните эти команды еще раз:
#:<syntaxhighlight lang="bash">
apt update && apt dist-upgrade
</syntaxhighlight>
#: программное обеспечение контроллера переключится на один из релизов и обновится:
#:* если у вас раскомментирована запись в файле <code>/etc/apt/sources.list.d/wb-unstable.list</code>, то контроллер переключится на релиз '''testing'''.
#:* в остальных случаях контроллер переключится на релиз '''stable'''.
# Удалите вспомогательный репозиторий, он больше не потребуется:
#:<syntaxhighlight lang="bash">
rm /etc/apt/sources.list.d/wb-release-transitional.list
</syntaxhighlight>
=== Автоматический переход ===
После отладки системы релизов мы планируем автоматически перевести всех пользователей на новую систему релизов в момент обновления ПО контроллера.
'''Переход запланирован на <s>1 июля</s> 31 августа 2021 года''', следите за новостями.
Для перехода просто обновите ПО контроллера после этой даты:
# Выполните команды:
#:<syntaxhighlight lang="bash">
apt update && apt dist-upgrade
</syntaxhighlight>
#: в систему будет установлен пакет <code>wb-configs</code>
# После завершения обновления выполните эти команды еще раз:
#:<syntaxhighlight lang="bash">
apt update && apt dist-upgrade
</syntaxhighlight>
#: программное обеспечение контроллера переключится на один из релизов и обновится:
#:* если у вас раскомментирована запись в файле <code>/etc/apt/sources.list.d/wb-unstable.list</code>, то контроллер переключится на релиз '''testing'''.
#:* в остальных случаях контроллер переключится на релиз '''stable'''.


== Как узнать версию установленного ПО ==
== Как узнать версию установленного ПО ==
=== Консоль ===
=== Консоль ===
При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза:
При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="console">
__      _(_)_ __ ___ _ __ | |__  ___  __ _ _ __ __| |
__      _(_)_ __ ___ _ __ | |__  ___  __ _ _ __ __| |
\ \ /\ / / | '__/ _ \ '_ \| '_ \ / _ \ / _` | '__/ _` |
\ \ /\ / / | '__/ _ \ '_ \| '_ \ / _ \ / _` | '__/ _` |
Строка 94: Строка 36:
Linux wirenboard-A6XXXXXX 4.9.22-wb1 #2 SMP Sun Apr 18 18:12:58 UTC 2021 armv7l GNU/Linux
Linux wirenboard-A6XXXXXX 4.9.22-wb1 #2 SMP Sun Apr 18 18:12:58 UTC 2021 armv7l GNU/Linux


~#  
#  
</syntaxhighlight>
</syntaxhighlight>


Также можно использовать команду '''wb-release''', пример для stable-ветки:
Также можно использовать команду '''wb-release''', пример для stable-ветки:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="console">
~# wb-release
# wb-release
Wirenboard release wb-2104 (as stable), target wb6/stretch
Wirenboard release wb-2104 (as stable), target wb6/stretch


Версия 13:08, 27 августа 2021

Описание

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

Если у вас строк Release name и Release suite, то вам нужно перейти на новый репозиторий ПО Wiren Board. Как это сделать читайте в статье Новый репозиторий Wiren Board.

Ветки релизов

Testing

Testing — ветка со свежими версиями пакетов: новые функции и возможные ошибки.

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

На третий месяц testing-ветка «замораживается», команда Wiren Board исправляет найденные в testing ошибки и сливает её со stable. После слияния мы продолжаем публикацию пакетов с новыми функциями в testing.

Будем рады помощи сообщества в тестировании пакетов — переключайтесь на testing-ветку на неответственных инсталляциях.

Stable

Stable — стабильная ветка: обновление пакетов раз в три месяца и исправления критических ошибок.

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

Каждый релиз имеет номер, например wb-2104 — релиз, выпущенный в апреле 2021 года.

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

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

Консоль

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

__      _(_)_ __ ___ _ __ | |__   ___   __ _ _ __ __| |
\ \ /\ / / | '__/ _ \ '_ \| '_ \ / _ \ / _` | '__/ _` |
 \ V  V /| | | |  __/ | | | |_) | (_) | (_| | | | (_| |
  \_/\_/ |_|_|  \___|_| |_|_.__/ \___/ \__,_|_|  \__,_|
                                                       
Welcome to Wiren Board 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.

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

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

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

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

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

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

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

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

Testing

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

wb-release -t testing

Stable

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

wb-release -t stable

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

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

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

wb-release -t wb-2104

Как обновлять систему

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

Источник — https://wirenboard.com/wiki/index.php?title=Software_Releases&oldid=53997