Enable autoupdate – опция позволяет использовать автоматическое обновление программного обеспечения и конфигурацию шлюза, а так же проверку их актуальности через заданные промежутки времени.
Алгоритм работы функции автоматического конфигурирования КОРАЛЛ-РА 32 и проверки актуальности файла конфигурации
Для каждого КОРАЛЛ-РА 32 создается файл конфигурации, который считается эталонным, в файле конфигурации /etc/config/cfg.yaml нужно записать его текущую версию #ConfigFileVersion=ГГГГММДДЧЧММ:
!version 1.0
coralRA32 YAML config file
Tree hierarchy:
node1:
node2:
param1: value1
param2: value2
NOTE: use spaces ' ' instead of tab '/t'
NOTE: Don't del/add nodes
NOTE: Use ':' after param names
Remember, that quantity of spaces must be multiply to 8
ConfigFileVersion=201302010905
Network:
network:
HOSTNAME: CoralRA32m
При загрузке КОРАЛЛ-РА 32 выполняется проверка на наличие файла конфигурации на FTP/TFTP/HTTP/HTTPS–сервере (при необходимости – авторизуется на сервере) по заданному пути,. Если файл конфигурации присутствует, то КОРАЛЛ-РА 32 его загружает, сохраняет в своей файловой системе и применяет как текущий. По истечении периода «Configuration update interval» производится повторная загрузка файла конфигурации с сервера, после чего сравниваются версии текущего и загруженного файлов конфигурации (ConfigFileVersion). Если у загруженного файла версия оказывается выше, чем у текущего, то КОРАЛЛ-РА 32 сохраняет и применяет новую конфигурацию, иначе активной остается текущая конфигурация.
Таким образом, если оператору необходимо внести изменения в конфигурацию шлюза, достаточно выложить на сервер измененный файл конфигурации с увеличенным значением номера версии «ConfigFileVersion», при этом конфигурация обновится автоматически по истечении времени «Configuration update interval». После перезагрузки шлюз КОРАЛЛ-РА 32 загружает файл конфигурации с сервера, что защищает шлюз от неверной настройки. В случае если при настройке через WEB-конфигуратор возникли проблемы, достаточно перезапустить устройство для загрузки эталонной конфигурации.
На рисунке ниже приведен алгоритм работы функции автоматического конфигурирования КОРАЛЛ-РА 32 и проверки актуальности файла конфигурации:
Рисунок. Алгоритм работы функции автоматического конфигурирования КОРАЛЛ-РА 32 и проверки актуальности файла конфигурации.
Алгоритм работы функции автоматического обновления и проверки актуальности ПО
При загрузке КОРАЛЛ-РА 32, а также по истечении таймера «Firmware update interval» происходит проверка наличия файла описания версий (coralRA.versions) на TFTP-сервере по заданному пути. Если файл конфигурации присутствует, то КОРАЛЛ-РА 32 его загружает. В этом файле присутствуют сведения о версиях файлов ПО, которые присутствуют на TFTP-сервере, а также пути к ним и их имена. Если версии ПО на сервере отличаются от текущих (работающих на шлюзе), происходит проверка на наличие активных разговорных сессий. Если таковых нет, КОРАЛЛ-РА 32 загружает файлы с версиями ПО, указанными в файле coralRA.versions, после загрузки происходит обновление встроенного ПО шлюза, иначе включается таймер 10 секунд. По истечении таймера вновь проверяется наличие активных разговорных сессий.
Рисунок. Алгоритм работы функции автоматического обновления и проверки актуальности ПО.
Способы получения конфигурации параметров автоматического конфигурирования и проверки актуальности ПО
Способ 1: используя опцию 43 протокола DHCP или опции 66 и 67, при включенном DHCP в сетевых настройках либо на одной из VLAN.
Шлюз имеет следующие настройки по умолчанию:
Режим обновления | при помощи протокола TFTP |
TFTP сервер | update.local |
Путь к файлу с версиями ПО и конфигурации | coralRA.versions |
Путь к файлу конфигурации | Коралл-РА<MAC>.dat_ |
Коралл-РА<MAC>.dat_ – имя файла конфигурации. При получении такого имени шлюз вместо <MAC> подставляет свой MAC-адрес.
Пример: передаваемое имя файла конфигурации Коралл-РА_<MAC>.dat, при получении его шлюз формирует запрос на наличие файла Коралл-РА_ A8F94B887D27.dat на TFTP сервере.
Через WEB-интерфейс на компьютер файл конфигурации загружается в формате Коралл-РА_cfg.tar.gz, для использования в процедуре автоконфигурирования его необходимо переименовать в Коралл-РА_<MAC>.dat.
Для редактирования файла на компьютере архив необходимо распаковать, изменить данные в файле и заархивировать в том же формате с учетом пути к файлу /etc/config, после чего переименовать в Коралл-РА_<MAC>.dat.
При необходимости авторизоваться на сервере автообновления, настраиваются параметры: Autoupdate auth, Username, Password.
Если шлюз получает от DHCP сервера одновременно опции 43, 66 и 67, то опция 43 является приоритетной к применению, если 43 опции нет, то обрабатываютя 66 и 67 опции. Заводские настройки автоматической загрузки ПО и конфигурации, приведённые выше, в данном случае не действуют.
Описание синтаксиса опций Option 43, 66, 67 и файла с версиями ПО и конфигурации: coralRA.versions
Синтаксис опции 43:
<номер подопции><длина подопции><значение подопции>,
где
- номер и длина подопции передаются в числовом (Hex) формате;
- значение подопции передается в коде ASCII.
Подопции, необходимые для процедуры автообновления:
- адрес сервера автообновления;
Адрес должен быть принят в формате *<proto>://<address>\[:<port>\]{*}, где <proto> - протокол (ftp, tftp, http, https), <address> – IP-адрес или доменное имя сервера автообновления, <port> – порт сервера автообновления (параметр необязательный);
- имя файла конфигурации для автообновления;
- имя файла ПО для автообновления;
Пример записи опции:
05:11:68:74:74:70:3A:2F:2F:61:75:74:6F:2E:72:75:3A:38:30:06:09:61:75:74:6F:2E:63:6F:6E:66:07:08:61:75:74:6F:2E:6B:6D:67
где
05 – номер подопции адреса сервера автообновления;
11 – длина, 17 байт (0х11 = 17 dec);
68:74:74:70:3A:2F:2F:61:75:74:6F:2E:72:75:3A:38:30 – значение подопции (http://auto.ru:80);
06– номер подопции имени файла конфигурации;
09 – длина, 9 байт;
61:75:74:6F:2E:63:6F:6E:66 – значение подопции (auto.conf);
07 – номер подопции имени файла ПО;
08 – длина, 8 байт;
61:75:74:6F:2E:6B:6D:67 – значение подопции (auto.img).
Синтаксис опции 66:
FQDN или IP-адрес TFTP сервера
Примеры настройки DHCP сервера:
Option tftp-server-name "update.local"
Option tftp-server-name "192.168.1.3"
Синтаксис опции 67:
"Путь к файлу coralRA.versions; Путь и имя файла конфигурации"
Синтаксис Путь к файлу coralRA.versions: conf-path/coralRA.versions
Синтаксис Путь и имя файла конфигурации: conf-path/Коралл-РА<MAC>.dat_
где сonf-path – путь к файлу конфигурации;
Пример синтаксиса опций 66, 67, пути и имени файлов ПО и конфигураций для шлюза, имеющего МАС-адрес A8F94B887D27
Передаваемые параметры:
Option tftp-server-name "update.local";
Option bootfile-name "/Коралл-РАip/firmware/coralRA.versions;/Коралл-РАip/conf/Коралл-РА_<MAC>.dat"
Способ 2: используя конфигурацию параметров автоматического обновления, прописанную в разделе Autoupdate Settings, при назначенном статическом адресе в сетевых настройка, либо при выбранном протоколе PPPoE.
В данном случае используяются параметры Autoupdate protocol, Autoupdate server, Configuration file и Firmware versions file прописанные в разделе Autoupdate Settings. Если существует необходимость автороизации на сервере автообновления, настраиваются параметры: Autoupdate auth, Username, Password.
Формат и синтаксис файла coralRA.versions:
FS={FSversion} firmware-pathFS/filenameFS
CSP={CSPversion} firmware-pathCSP/filenameCSP
MSP={MSPversion} firmware-pathMSP/filenameMSP
IMG={IMGversion} firmware-pathIMG/filenameIMG
ARM={ARMversion} firmware-pathARM/filenameARM
где FSversion/CSPversion/MSPversion/ARMversion – номер версии соответствующего ПО:
firmware-pathFS,CSP,MSP,ARM – путь к файлу с соответствующим ПО;
filenameFS,CSP,MSP,ARM – имя файла соответствующего ПО.
Типы файлов ПО:
- FS – файловая система с рабочим приложением В текущей версии ПО не используются;
- CSP – операционная система шлюза1;
- MSP – программное обеспечение медиапроцессора1;
- IMG – образ всего ПО, включающий в себя FS, CSP, MSP и ARM;
- ARM – программное обеспечение аппаратной платформы1.
Формат имен файлов ПО:
- filenameFS – CoralRA32.fs.{номер версии ПО};
- filenameCSP – CoralRA32.csp.{номер версии ПО};
- filenameMSP – CoralRA32.msp.{номер версии ПО};
- filenameIMG – CoralRA32.img.{номер версии ПО};
- filenameARM – CoralRA32.arm.{номер версии ПО}.
Пример содержимого файла coralRA.versions:
FS=1.8.0 fs/CoralRA32.fs.1.8.0
CSP=209 csp/CoralRA32.csp.209
MSP=GA_10_23_02_03 msp/CoralRA32.msp. GA_10_23_02_03
IMG=2.1.0 Коралл-РАip/firmware/img/CoralRA32.img.2.1.0
ARM=20111117 arm/CoralRA32.arm.20111117