Software Releases: различия между версиями
м (Форматирование) |
м (Вернул свою версию и дополнил.) |
||
Строка 1: | Строка 1: | ||
{{Draft}} | |||
{{DISPLAYTITLE: Релизы ПО Wiren Board}} | {{DISPLAYTITLE: Релизы ПО Wiren Board}} | ||
== Введение == | == Введение == | ||
С апреля 2021 года программное обеспечение контроллера Wiren Board выпускается в формате периодических релизов и изменился путь к основному репозиторию. | |||
Новые релизы доступны для контроллеров Wiren Board 5 и Wiren Board 6. | |||
=== Ссылки на репозиторий === | |||
Мы переехали на новый репозиторий по адресу http://deb.wirenboard.com/, поэтому обновления ПО в старый репозиторий http://releases.contactless.ru/ в скором времени перестанут публиковаться. | |||
=== Testing === | |||
Testing — нестабильная ветка со свежими версиями пакетов: новые функции и неизвестные ошибки. | |||
Новые версии пакетов публикуются сразу после появления и предварительного автоматического тестирования — это позволит исключить попадания сломанных пакетов. | |||
Раз в три месяца testing-ветка «замораживается», команда Wiren Board исправляет найденные ошибки и сливает её со stable. После слияния мы продолжаем обновление пакетов в testing. | |||
Будем рады помощи сообщества в тестировании пакетов — переключайтесь на testing-ветку на неответственных инсталляциях. | |||
== | === Stable === | ||
Stable — стабильная ветка: обновление пакетов раз в три месяца и исправления критических ошибок. | |||
Публикуемые в ней пакеты прошли тестирование пользователями testing-ветки, поэтому мы рекомендуем использовать stable в ответственных инсталляциях. | |||
Каждый релиз имеет номер, например wb-2104 — релиз, выпущенный в апреле 2021 года. | |||
Если в опубликованном релизе будут обнаружены критические ошибки — мы опубликуем исправления сразу после их выхода. | |||
Если в | |||
== Как начать пользоваться == | == Как начать пользоваться == | ||
Если вы используете стандартный репозиторий Wiren Board и хотите перейти на работу с релизами, выполните несколько шагов. | |||
=== Прошивка fit-образа === | === Прошивка fit-образа === | ||
Строка 45: | Строка 35: | ||
Инструкцию по прошивке и ссылки на загрузку смотрите в статье [[Wiren Board Firmware Update#Обновление прошивки целиком | Обновление прошивки контроллера Wiren Board]]. | Инструкцию по прошивке и ссылки на загрузку смотрите в статье [[Wiren Board Firmware Update#Обновление прошивки целиком | Обновление прошивки контроллера Wiren Board]]. | ||
В контроллер будет зашит последний стабильный релиз (stable). | |||
=== | === Переходной пакет wb-configs === | ||
Для тех, кому не подходит обновление прошивки с помощью fit-образа | Для тех, кому не подходит обновление прошивки с помощью fit-образа мы подготовили переходной пакет <code>wb-configs</code>: | ||
# Добавьте новый репозиторий: | |||
# Добавьте | #:* Создайте новый файл: | ||
#:<syntaxhighlight lang="bash"> | #::<syntaxhighlight lang="bash"> | ||
nano /etc/apt/sources.list.d/wb-release-transitional.list | |||
</syntaxhighlight> | |||
#:* Добавьте в него строку и сохраните: | |||
#::<syntaxhighlight lang="bash"> | |||
deb http://releases.contactless.ru/release-transitional stretch main | |||
</syntaxhighlight> | </syntaxhighlight> | ||
# | # Выполните команды: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
apt update && apt dist-upgrade | apt update && apt dist-upgrade | ||
</syntaxhighlight> | </syntaxhighlight> | ||
#: | #: в систему будет установлен пакет <code>wb-configs</code> | ||
# После завершения обновления | # После завершения обновления выполните эти команды еще раз: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
apt update && apt dist-upgrade | apt update && apt dist-upgrade | ||
</syntaxhighlight> | </syntaxhighlight> | ||
#: | #: программное обеспечение контроллера переключится на один из релизов и обновится: | ||
#:* если у вас раскомментирована запись в файле <code>/etc/apt/sources.list.d/wb-unstable.list</code>, то контроллер переключится на | #:* если у вас раскомментирована запись в файле <code>/etc/apt/sources.list.d/wb-unstable.list</code>, то контроллер переключится на релиз '''testing'''. | ||
#:* в остальных случаях контроллер переключится на | #:* в остальных случаях контроллер переключится на релиз '''stable'''. | ||
=== Автоматический переход === | |||
После отладки системы релизов мы планируем автоматически перевести всех пользователей на новую систему релизов в момент обновления ПО контроллера. Переход запланировал на это лето, точную дату автоматического перехода сообщим позже — вы сможете подготовиться. | |||
== Как узнать версию установленного ПО == | == Как узнать версию установленного ПО == | ||
=== Консоль === | === Консоль === | ||
При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза: | При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза: | ||
Строка 99: | Строка 88: | ||
=== Веб-интерфейс === | === Веб-интерфейс === | ||
[[Image: System Information.png|300px|thumb|right| Версия ПО в веб-интерфейсе]] | |||
Чтобы посмотреть текущую версию ПО в веб-интерфейсе: | Чтобы посмотреть текущую версию ПО в веб-интерфейсе: | ||
# Перейдите в раздел '''Devices''' | # Перейдите в раздел '''Devices''' | ||
Строка 125: | Строка 114: | ||
=== Заморозить релиз === | === Заморозить релиз === | ||
Вы можете заморозить состояние ПО контроллера на текущем стабильном релизе, но мы не рекомендуем это делать — вы останетесь без обновлений. | Вы можете заморозить состояние ПО контроллера на текущем стабильном релизе, но мы не рекомендуем это делать — вы останетесь без обновлений. | ||
Для заморозки укажите в параметрах | Для заморозки укажите в параметрах wb-release текущую версию stable-релиза: | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
wb-release -t wb-2104 | wb-release -t wb-2104 | ||
</syntaxhighlight> | </syntaxhighlight> |
Версия 11:25, 14 мая 2021
Это черновик страницы. Последняя правка сделана 14.05.2021 пользователем A.Degtyarev.
Введение
С апреля 2021 года программное обеспечение контроллера Wiren Board выпускается в формате периодических релизов и изменился путь к основному репозиторию.
Новые релизы доступны для контроллеров Wiren Board 5 и Wiren Board 6.
Ссылки на репозиторий
Мы переехали на новый репозиторий по адресу http://deb.wirenboard.com/, поэтому обновления ПО в старый репозиторий http://releases.contactless.ru/ в скором времени перестанут публиковаться.
Testing
Testing — нестабильная ветка со свежими версиями пакетов: новые функции и неизвестные ошибки.
Новые версии пакетов публикуются сразу после появления и предварительного автоматического тестирования — это позволит исключить попадания сломанных пакетов.
Раз в три месяца testing-ветка «замораживается», команда Wiren Board исправляет найденные ошибки и сливает её со stable. После слияния мы продолжаем обновление пакетов в testing.
Будем рады помощи сообщества в тестировании пакетов — переключайтесь на testing-ветку на неответственных инсталляциях.
Stable
Stable — стабильная ветка: обновление пакетов раз в три месяца и исправления критических ошибок.
Публикуемые в ней пакеты прошли тестирование пользователями testing-ветки, поэтому мы рекомендуем использовать stable в ответственных инсталляциях.
Каждый релиз имеет номер, например wb-2104 — релиз, выпущенный в апреле 2021 года.
Если в опубликованном релизе будут обнаружены критические ошибки — мы опубликуем исправления сразу после их выхода.
Как начать пользоваться
Если вы используете стандартный репозиторий Wiren Board и хотите перейти на работу с релизами, выполните несколько шагов.
Прошивка fit-образа
Вы можете обновить прошивку контроллера целиком, для этого загрузите и прошейте fit-образ программного обеспечения.
Инструкцию по прошивке и ссылки на загрузку смотрите в статье Обновление прошивки контроллера Wiren Board.
В контроллер будет зашит последний стабильный релиз (stable).
Переходной пакет wb-configs
Для тех, кому не подходит обновление прошивки с помощью fit-образа мы подготовили переходной пакет wb-configs
:
- Добавьте новый репозиторий:
- Создайте новый файл:
nano /etc/apt/sources.list.d/wb-release-transitional.list
- Добавьте в него строку и сохраните:
deb http://releases.contactless.ru/release-transitional stretch main
- Выполните команды:
apt update && apt dist-upgrade
- в систему будет установлен пакет
wb-configs
- После завершения обновления выполните эти команды еще раз:
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.
Веб-интерфейс
Чтобы посмотреть текущую версию ПО в веб-интерфейсе:
- Перейдите в раздел Devices
- Найдите устройство 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