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

Материал из Wiren Board
м
м
Строка 4: Строка 4:
С апреля 2021 года мы начали выпускать программное обеспечение контроллера Wiren Board в формате периодических релизов.
С апреля 2021 года мы начали выпускать программное обеспечение контроллера Wiren Board в формате периодических релизов.


Пользователям доступны два репозитория:  
Пользователям доступны два релиза:  
* testing — свежие версии пакетов с новыми функциями, исправленными ошибками и с возможными новыми.
* testing — свежие версии пакетов с новыми функциями, исправленными ошибками и с возможными новыми.
* stable — стабильные версии пакетов.
* stable — стабильные версии пакетов.
Строка 14: Строка 14:
* 6.7
* 6.7


Репозиторий stable каждые три месяца синхронизируется с testing.
Релиз stable каждые три месяца синхронизируется с testing.


== Как начать пользоваться ==
== Как начать пользоваться ==
Если вы используете стандартный репозиторий Wiren Board и хотите перейти на stable или testing, выполните несколько шагов.
Если вы используете стандартный репозиторий Wiren Board и хотите перейти на работу с релизами, выполните несколько шагов.


=== Прошивка fit-образа ===
=== Прошивка fit-образа ===
Строка 23: Строка 23:


Инструкцию о прошивке и ссылки на загрузку смотрите в статье [[Wiren Board Firmware Update#Обновление прошивки целиком | Обновление прошивки контроллера Wiren Board]].
Инструкцию о прошивке и ссылки на загрузку смотрите в статье [[Wiren Board Firmware Update#Обновление прошивки целиком | Обновление прошивки контроллера Wiren Board]].
В контроллер будет зашит последний стабильный релиз (stable).


=== Переходной пакет wb-configs ===
=== Переходной пакет wb-configs ===
Строка 44: Строка 46:
apt update && apt dist-upgrade
apt update && apt dist-upgrade
</syntaxhighlight>
</syntaxhighlight>
#: программное обеспечение контроллера переключится на одну из веток из нового репозитория и обновится:
#: программное обеспечение контроллера переключится на один из релизов и обновится:
#:* если у вас раскомментирована запись в файле <code>/etc/apt/sources.list.d/wb-unstable.list</code>, то контроллер переключится на ветку '''testing'''.
#:* если у вас раскомментирована запись в файле <code>/etc/apt/sources.list.d/wb-unstable.list</code>, то контроллер переключится на релиз '''testing'''.
#:* в остальных случаях контроллер переключится на ветку '''stable'''.
#:* в остальных случаях контроллер переключится на релиз '''stable'''.


== Как узнать версию установленного ПО ==
== Как узнать версию установленного ПО ==
Строка 75: Строка 77:
Чтобы посмотреть текущую версию ПО в веб-интерфейсе:
Чтобы посмотреть текущую версию ПО в веб-интерфейсе:
# Перейдите в раздел '''Devices'''
# Перейдите в раздел '''Devices'''
# Найдите устройство '''System'''. Название текущей ветки в поле '''Release suite''', а версия ПО в поле '''wb-2104'''.
# Найдите устройство '''System'''. Название текущего релиза в поле '''Release suite''', а версия ПО в поле '''wb-2104'''.
 
== Переключение между релизами ==
Для переключения между релизами также используйте утилиту <code>wb-release</code> с флагом <code>-t</code>. При переключении система автоматически обновит текущий релиз до актуального состояния, а потом переключит релизы и обновит систему еще раз.
 
Если в процессе работы утилиты произошел сбой, то она постарается вернуть настройки apt.
 
После смены репозитория мы рекомендуем перезагрузить контроллер на случай, если обновилось ядро.
 
=== Testing ===
Для переключения на testing выполните команду:
<syntaxhighlight lang="bash">
wb-release -t testing
</syntaxhighlight>
 
=== Stable ===
Для переключения на stable выполните команду:
<syntaxhighlight lang="bash">
wb-release -t stable
</syntaxhighlight>
 
=== Заморозить релиз ===
Если у вас ответственная инсталляция и вы не планируете получать новые версии ПО и обновления безопасности системы, то вы можете заморозить ПО контроллера на текущем релизе.
 
При запуске утилиты не название релиза, а его имя, например, заморозим ПО контроллера на релизе wb-2104:
<syntaxhighlight lang="bash">
wb-release -t wb-2104
</syntaxhighlight>

Версия 18:59, 4 мая 2021

Это черновик страницы. Последняя правка сделана 04.05.2021 пользователем A.Degtyarev.

Описание

С апреля 2021 года мы начали выпускать программное обеспечение контроллера Wiren Board в формате периодических релизов.

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

  • testing — свежие версии пакетов с новыми функциями, исправленными ошибками и с возможными новыми.
  • stable — стабильные версии пакетов.

Новые репозитории содержат ПО для контроллеров Wiren Board версий:

  • 5.5
  • 5.8
  • 6.x
  • 6.7

Релиз stable каждые три месяца синхронизируется с testing.

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

Если вы используете стандартный репозиторий Wiren Board и хотите перейти на работу с релизами, выполните несколько шагов.

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

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

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

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

Переходной пакет wb-configs

Для тех, кому не подходит обновление прошивки с помощью fit-образа мы подготовили переходной пакет wb-configs:

  1. Добавьте новый репозиторий:
    • Создайте новый файл:
    nano /etc/apt/sources.list.d/wb-release-transitional.list
    
    • Добавьте в него строку:
    deb http://releases.contactless.ru/release-transitional stretch main
    
  2. Выполните команды:
    apt update && apt dist-upgrade
    
    в систему будет установлен пакет wb-configs
  3. После завершения обновления выполните эти команды еще раз:
    apt update && apt dist-upgrade
    
    программное обеспечение контроллера переключится на один из релизов и обновится:
    • если у вас раскомментирована запись в файле /etc/apt/sources.list.d/wb-unstable.list, то контроллер переключится на релиз testing.
    • в остальных случаях контроллер переключится на релиз stable.

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

Консоль

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

__      _(_)_ __ ___ _ __ | |__   ___   __ _ _ __ __| |
\ \ /\ / / | '__/ _ \ '_ \| '_ \ / _ \ / _` | '__/ _` |
 \ 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-2104:

wb-release -t wb-2104