Ручное обновление UGOS с использованием PMC

ID статьи: 1334
Последнее обновление: 22 апр, 2024
Documentation:
Product: UserGate NGFW
Version: 7.x

Для программно-аппаратных комплексов (ПАК) UserGate доступен интерфейс PMC CLI, предназначенный для мониторинга и управления платформой UserGate. В случае, когда устройство недоступно, есть возможность подключения по отдельному перенастроенному MGMT-интерфейсу в режиме PMC CLI или через консольный порт (USB Type-C). Структура команд PMC CLI идентична структуре команд CLI основного продукта. Через PMC могут быть обновлены все программные компоненты кроме NGFW-image.

  • pmc — основная прошивка PMC. Используется для удаленного мониторинга и управления платформой. Имеет CLI интерфейс доступный через консольный порт(USB с CON) или через SSH при подключении к MGMT интерфейсу.

  • pmc-backup — резервная прошивка PMC. Может быть запущена из loader при помощи команды autoboot backup. Для обновления использует образ pmc-main.

  • boot — начальный загрузчик хост процессора платформы.

  • sys-recovery — минимальный образ UGOS используемый для первичной установки основного образа или для аварийного восстановления работоспособности устройства

  • ncpmc — прошивка pmc расположенного на сетевой плате. Есть только на UserGate FG. При обновлении отключаются все вторичные источники питания платформы.

Обновление может быть произведено через SCP. 
Подробнее о PMC CLI смотрите в разделе данного руководства Platform Management Controller Command Line Interface — UserGate

Подготовка

  1. Настроить Tftp сервер, в той же сети что и MGMT интерфейс.

  2. Настроить minicom или Putty (с активной клавиатурой), для подключение к PMC по ssh через MGMT интерфейс. При первичной инициализации адрес по умолчанию 192.168.1.2 

Примечание В случае получения ошибки при подключении, по ssh через MGMT интерфейс, требуется загрузить сертификат. Загрузка сертификата осуществляется только при подключение через COM-порт.
  1.  Сгенерировать сертификат для ssh. 

openssl ecparam -genkey -name prime256v1 -noout -outform DER -out privatekey.der

  1. Подключится через COM-порт. Перейти в режим PMC CLI. Во время загрузки устройства при появлении записи "(pmc) Hit 'Enter'  key to stop autoboot:"  нажмите Enter.

PMC> update key ssh tftp 192.168.1.7 privatekey.der
TFTP from server 192.168.1.7; our IP address is 192.168.1.2
Filename 'privatekey.der'.
Update at QSPI offset: 0x07100000.
Updating...
Bytes transferred = 121 (0x79) in 9 ms (13 KiB/s)
TFTP update OK
 
PMC> reset
Device will be reset. Continue? (y/n): y
  1. После перезагрузки подключится через MGMT интерфейс по SSH.
PMC login: admin
Password: 
PMC> 
  1. Загрузить на TFTP сервер прошивки :
    • pmc-main-<model>-7.x.x.xxx.img

    • ugos-ugls-Model-C-recovery-7.x.x.xxx.img

    • ugos-ugls-Model-C-boot-7.x.x.xxx.img

Примечание Версии прошивок ugos-ugls-Model-C-recovery и ugos-ugls-Model-C-boot  и версия операционной системы UGOS  должны совпадать.

Обновление программных компонентов через PMC с использованием утилиты TFTP

  1. Подключиться к PMC CLI через консоль (CON) или по SSH и войти в CLI с использованием заведенного ранее пользователя и пароля (по умолчанию admin/password)
Примечание  Различая между версиями 7.0.x и 7.1.x заключается в том, что обновление программных компонентов возможно в режим configure. Пункт 2 требуется выполнять для версии старше 7.1.0.
  1. Войти в режим конфигурирования устройства
PMC> configure
PMC#
  1. Остановить процессор.
PMC> set platform soc stop
SoC stoped
  1. Настроить сеть на MGMT интерфейсе при необходимости.
PMC# set network ip 192.168.1.2/24
Set ip address complete
PMC# set network gateway 192.168.1.1
Set gateway complete
PMC# 
  1. Можно указать статическую запись для Tftp сервера, в случае если у вас сервер находится в другой подсети.
PMC# set network arp 192.168.1.7 d8:50:e6:54:b9:fc
  1. Посмотреть версию образа контроллера и сравнить с последней доступной версией.

PMC> version
PMC(Main) Firmware 7.0.1 build 20R (2023-03-22 — 10:18:23)

  1. Если версия не совпадает, требуется обновить контроллер до последней доступной. Указать настроенный ранее Tftp сервер и файл для обновления.
PMC# update firmware pmc tftp 192.168.1.1 pmc-main-<model>-7.x.x.xxx.img
TFTP from server 192.168.1.1; our IP address is 192.168.1.2
Filename 'pmc-main-<model>-7.x.x.xxx.img'.
Update at QSPI offset: 0x07080000.
Updating...
        
Bytes transferred = 319280 (0x4DF30) in 3 seconds (103 KiB/s)
TFTP update OK
PMC# 
  1. Перезапустить устройство.
PMC# reset 
Device will be reset. Continue? (y/n): y

PMC(Loader) Firmware 7.0.1 build 20R (2023-03-22 — 10:18:23)
  1.  Войти в PMC CLI.  (по умолчанию admin/password)
PMC login: admin
Password: 
PMC> 
  1. Войти в режим конфигурирования устройства
PMC> configure
PMC#
  1. Остановить процессор.
PMC# set platform soc stop
  1. Обновить образ загрузчика UGOS до последней доступной версии.
PMC# update firmware boot tftp 192.168.1.7 ugos-ugls-Model-C-boot-7.x.x.xxx.img
TFTP from server 192.168.1.7; our IP address is 192.168.1.2
Filename ugos-ugls-Model-C-boot-7.x.x.xxx.img.
Update at QSPI offset: 0x00000000.
Updating...

Bytes transferred = 5312345 (0x510F59) in 33 seconds (157 KiB/s)
TFTP update OK
  1. Обновить образ sys-recovery до последней доступной версии.
PMC# update firmware sys-recovery tftp 192.168.1.7 ugos-ugls-Model-C-recovery-7.x.x.xxx.img
TFTP from server 192.168.1.7; our IP address is 192.168.1.2
Filename 'ugos-ugls-Model-C-recovery--7.x.x.xxx.img'.
Update at QSPI offset: 0x01000000.
Updating...

Bytes transferred = 52895516 (0x3271F1C) in 262 seconds (197 KiB/s)
TFTP update OK

PMC> reset

Обновление программных компонентов через PMC с использованием утилиты SCP

  1. Включить устройство и дождаться его полной загрузки или остановить запуск на этапе запуска PMC. В процессе запуска устройства обновление ПО не доступно
(pmc) Hit 'Enter' key to stop autoboot:  2 

Press '^]' for autoboot and connect to aux
PMC login: 
  1. Подключиться к PMC CLI через консоль (CON) или по SSH и войти в CLI с использованием заведенного ранее пользователя и пароля (по умолчанию admin/password)
PMC login: admin
Password: 
PMC> 
  1. Войти в режим конфигурирования устройства
PMC> configure
PMC#
  1. Настроить сеть в PMC выставив адрес и шлюз по умолчанию вручную или включив DHCP
PMC# set network dhcp on
DHCP client start complete
PMC# 
  1. Если используете DHCP убедитесь, что настройки были получены в автоматическом режиме.
PMC# show network status 
------------------------------------
Network status:
IP address type: dhcp
IP address: 192.168.1.2
Gateway address: 192.168.1.1
Netmask: 255.255.255.0
------------------------------------
PMC# 
  1. Если версия не совпадает, требуется обновить контроллер до последней доступной. Указать настроенный ранее на устройстве ip адрес или полученный в автоматическом режиме.
scp pmc-main-<model>-7.x.x.xxx.img admin@192.168.1.2:/firmware/pmc
admin@192.168.1.2's password: 
pmc-main-<model>-7.x.x.xxx.img                                                                                                                                                                                                                 100% 6144KB 249.3KB/s   00:24    
Connection to 192.168.1.2 
  1. Перезапустить устройство.
PMC# reset 
Device will be reset. Continue? (y/n): y

PMC(Loader) Firmware 7.0.1 build 20R (2023-03-22 — 10:18:23)
  1.  Войти в PMC CLI.  (по умолчанию admin/password)
PMC login: admin
Password: 
PMC> 
  1. Остановить процессор.
PMC> set platform soc stop
  1. Обновить образ загрузчика UGOS до последней доступной версии.
scp ugos-ugls-Model-C-boot-7.x.x.xxx.img admin@192.168.1.2:/firmware/boot
admin@192.168.1.2's password: 
ugos-ugls-Model-C-boot-7.x.x.xxx.img                                                                                                                                                                                                                   100% 6144KB 249.3KB/s   00:24    
Connection to 192.168.1.2 
  1. Обновить образ sys-recovery до последней доступной версии.
scp ugos-ugls-Model-C-recovery-7.x.x.xxx.img admin@192.168.1.2:/firmware/sys-recovery
admin@192.168.1.2's password: 
ugos-ugls-Model-C-recovery-7.x.x.xxx.img                                                                                                                                                                                                                   100% 6144KB 249.3KB/s   00:24    
Connection to 192.168.1.2 
PMC> reset​​​​
  1. Подключится к устройству и перезапустить его.
PMC# reset 
Device will be reset. Continue? (y/n): y

PMC(Loader) Firmware 7.0.1 build 20R (2023-03-22 — 10:18:23)

Обновление UGOS через sys-recovery (с использованием внешнего TFTP/FTP/HTTP/SSH-сервера)

Данная инструкция подходит для следующих случаев:

  • Необходимо в первый раз установить UGOS на устройство.

  • Необходимо полностью перезаписать образ UGOS.

Обязательные условия:

  • К устройству имеется доступ по сети Ethernet.

  • На устройстве установлен образ sys-recovery.

  1. Загрузить версию UGOS на свой ПК с портала my.usergate.com:
  • ngfw-ugls-7.x.x.xxx-public.ssd.gz — Для моделей C150, X10, D250, FG. 

  • ngfw-ugrc-7.x.x.xxx-public.ssd.gz — Для модели В50.

  1. Загрузить образ UGOS на TFTP сервер.

  2. Подключится к PMC через консольный интерфейс (USB Type-C) или по SSH через MGMT интерфейс.

  3. Войти в CLI с использованием заведенного ранее пользователя и пароля (по умолчанию admin password)

PMC login: admin
Password: 
PMC> 
  1. Войти в режим конфигурирования устройства
PMC> configure
PMC#
  1. Остановить работу CPU и запустить образ sys-recovery.
PMC# set platform soc stop
SoC stoped
PMC# autoboot recovery 
Connected to CPU at speed 115200.
...
UGOS login:
  1. Для входа используем логин пароль (root/root)
UGOS login: root
Password: root
  1. Подключить устройство к локальной сети через интерфейс port0 и настроить IP-адрес на интерфейсе (DHCP или static):
root@UGOS:~# dhclient port0
root@UGOS:~# ip ro
default via 192.168.75.1 dev port0 
192.168.75.0/24 dev port0 proto kernel scope link src 192.168.75.217 
root@UGOS:~#
  1. Загрузить обновление с настроенного ранее Tftp сервер
root@UGOS:~# curl tftp://192.168.1.2/ugos/ngfw-ugls-7.x.x.xxx-public.ssd.gz -o /ugos.ssd.gz
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  766M  100  766M    0     0  2322k      0  0:05:37  0:05:37 --:--:-- 2329k
100  766M  100  766M    0     0  2322k      0  0:05:37  0:05:37 --:--:-- 2322k
root@UGOS:~#
  1.  Провести запись образа на SSD-накопитель с помощью одной из следующих команд:
- Для моделей C150, X10, B50: curl file:///ugos.ssd.gz | gzip -d | dd of=/public/sda
- Для моделей D250, FG: curl file:///ugos.ssd.gz | gzip -d | dd of=/public/nvme0n1

Пример выполнения команды на Model FG:
root@UGOS:~# curl file:///ugos.ssd.gz | gzip -d | dd of=/public/nvme0n1
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  766M  100  766M    0     0  2015k      0  0:06:29  0:06:29 --:--:--  507k
100  766M  100  766M    0     0  2015k      0  0:06:29  0:06:29 --:--:-- 2015k
41943040+0 records in
41943040+0 records out
21474836480 bytes (20 G) copied, 395.429293 s, 52 M/s 
root@UGOS:~#
  1. Выйти обратно в PMC-CLI с помощью нажатия Ctrl + ].
root@UGOS:~# ^]
Disconnected from CPU

PMC#

  1. Остановить работу CPU и запустить основной образ UGOS
PMC# set platform soc stop
SoC stoped
PMC# autoboot
...
UGOS login:
Эта статья была:   Полезна | Не полезна
Сообщить об ошибке
ID статьи: 1334
Последнее обновление: 22 апр, 2024
Ревизия: 117
Просмотры: 2712
Комментарии: 0
Теги