ПО МКА-3/en: различия между версиями

Материал из Wiren Board
(Новая страница: «* Via the web interface in the Back relays section * With the command '''dbic_invoke_pcycle.sh''' in the console * By sending a command via MQT <pre> mosquitto_pu…»)
(Новая страница: «Other configuration files must be added to the autoconfiguration system through WB-dbic package upgrade (with version increase). In this case, if the desired file…»)
 
(не показано 7 промежуточных версий этого же участника)
Строка 20: Строка 20:




=== Механизм конфигурирования ===
=== Configuration mechanism ===
==== Конфигурация ====
==== Configuration====


Пакет wb-dbic устанавливает и хранит темплейты конфигурационных файлов в директории /etc/wb-dbic/templates/.
Package wb-dbic establishes and maintains templates of the configuration files in the directory /etc/wb-dbic/templates/.
Например темплейт для файла /etc/network/interfaces хранится в файле /etc/wb-dbic/templates/etc/network/interfaces.template.
For example the template for the file /etc/network/interfaces is stored in the file /etc/wb-dbic/templates/etc/network/interfaces.template.


Конфигурационные файлы генерируются посредством вызова скрипта dbic_gen_conf.
Configuration files are generated by calling the dbic_gen_conf script.
Скрипт получает переменные для конфигурирования от SCU, после чего обрабатывает файлы из директории /etc/wb-dbic/templates.
The script gets the variables for the configuration from the SCU, and then processes the files in the directory /etc/wb-dbic/templates.
Обрабатываются только файлы с расширением .template.
Only files with the .template extension are processed.


Если для заданного файла становится невозможно получить все необходимые переменные для подстановки, то файл не обновляется.
If it becomes impossible to get all necessary variables for substitution for a given file, the file is not updated.


Изменения в конфигурационных файлах не сохраняются. Изменения в темплейтах в директории /etc/wb-dbic/templates обрабатываются
Changes to configuration files are not saved. Changes in templates in /etc/wb-dbic/templates directory are processed
стандартным механизмом conffiles в dpkg: при установке обновлённого пакета
the standard conffiles mechanism in dpkg: when installing an updated package
и при наличии локальных правок пользователю будут предложены варианты дальнейших действий.
and if there are local edits, the user will be offered options for further action.




==== Настройка сети ====
==== Network setup ====
Т.к. получение переменных для подстановки в темплейты происходит по сети,
Since getting variables for substituting in templates is happening on the network,
то отдельно предоставляется первоначальный файл с настройками сети - /etc/network/interfaces.
the initial file with network settings - /etc/network/interfaces is provided separately.




==== Добавление конфигурационных файлов в систему ====
==== Adding configuration files to the system ====


Добавление других конфигурационных файлов в систему автоконфигурирования должно производиться
Other configuration files must be added to the autoconfiguration system
через обновление пакета wb-dbic (с увеличением версии). При этом, если нужный файл предоставляется каким-либо пакетом, то
through WB-dbic package upgrade (with version increase). In this case, if the desired file is provided by any package, then
необходимо пользоваться функционалом dpkg-divert или dpkg-divert в сочетании с ucf, чтобы предотвратить перезаписывание файла при обновлении
you must use the dpkg-divert or dpkg-divert functionality in conjunction with ucf to prevent overwriting of the file when upgrading
исходного пакета.
source package.

Текущая версия на 17:45, 18 июля 2019

Другие языки:

Main article Wiren Board NETMON-1

Restart SCU (rear relays)

The daemon dbic-pcycle.py is responsible for controlling the rear relays.

Start/stop daemon:

/etc/init.d/wb-dbic-pcycle start
/etc/init.d/wb-dbic-pcycle stop

The daemon listens to commands on the bus MQTT. There are three different ways to trigger a SCU reboot, i.e. send an MQTT command to the daemon:

  • Via the web interface in the Back relays section
  • With the command dbic_invoke_pcycle.sh in the console
  • By sending a command via MQT
mosquitto_pub -h <ip-адрес МКА> -t "/devices/dbic-power-cycle/controls/power/on" -m "0" -q 2


Configuration mechanism

Configuration

Package wb-dbic establishes and maintains templates of the configuration files in the directory /etc/wb-dbic/templates/. For example the template for the file /etc/network/interfaces is stored in the file /etc/wb-dbic/templates/etc/network/interfaces.template.

Configuration files are generated by calling the dbic_gen_conf script. The script gets the variables for the configuration from the SCU, and then processes the files in the directory /etc/wb-dbic/templates. Only files with the .template extension are processed.

If it becomes impossible to get all necessary variables for substitution for a given file, the file is not updated.

Changes to configuration files are not saved. Changes in templates in /etc/wb-dbic/templates directory are processed the standard conffiles mechanism in dpkg: when installing an updated package and if there are local edits, the user will be offered options for further action.


Network setup

Since getting variables for substituting in templates is happening on the network, the initial file with network settings - /etc/network/interfaces is provided separately.


Adding configuration files to the system

Other configuration files must be added to the autoconfiguration system through WB-dbic package upgrade (with version increase). In this case, if the desired file is provided by any package, then you must use the dpkg-divert or dpkg-divert functionality in conjunction with ucf to prevent overwriting of the file when upgrading source package.