Документация: ПО Факел — разрабатываемая версия
Образы системы¶
Обзор¶
ПО Факел распространяется в виде образа системы — ISO-файла, с которого устройство можно загрузить с внешнего носителя (USB-носителя или ISO-образа, подключенного к виртуальной машине). Система, загруженная с такого носителя, работает в режиме реального времени (live): ее изменения не сохраняются после перезагрузки. Чтобы маршрутизатор работал с постоянного накопителя, образ нужно установить на диск командой install image. Порядок установки на аппаратную платформу и виртуальную машину описан в разделе Установка ПО Факел.
Команда install image запускает программу установки, которая задает вопросы и устанавливает систему по ответам администратора. Программа установки:
выводит найденные диски и предлагает выбрать диск для установки или настроить зеркалирование RAID-1 на двух дисках (см. Дисковый массив);
предупреждает, что все данные на выбранном диске будут удалены, и запрашивает подтверждение;
запрашивает размер корневого раздела (не меньше 1,5 ГБ) или предлагает занять все свободное место на диске;
запрашивает имя образа, пароль пользователя
fakel, тип консоли по умолчанию (KVM или последовательная) и предлагает выбрать файл конфигурации для загрузки.
Подробное описание вопросов программы установки и рекомендуемых ответов приведено в разделе Диалог программы установки. Для установки нужен диск размером не меньше 2 ГБ; если такого диска нет, команда выводит сообщение No suitable disk was found. There must be at least one disk of 2GB or greater size. После успешной установки команда выводит сообщение The image installed successfully; please reboot now. Извлеките установочный носитель и перезагрузите устройство командой reboot (см. Перезагрузка и выключение). Если в начале установки отказаться продолжать (вопрос Would you like to continue?), команда завершается с сообщением Exiting from Fakel installation.
Команда работает только в системе, загруженной с установочного носителя. В уже установленной системе она выводит сообщение The system is already installed. Please use "add system image" instead.
На устройство можно установить несколько образов ПО Факел. Список установленных образов выводят команды show system image и show system image details (см. Общие сведения). Образ, который загружается по умолчанию, и тип консоли загрузчика задаются, а установленные образы переименовываются командами, описанными в разделе Образ и консоль по умолчанию. Журнал другого установленного образа выводят команды show log image <image> … (см. Журналы системы).
Команда install image доступна только пользователю уровня «Администратор» (см. Уровни пользователей).
В уже установленную систему образ добавляет команда add system image <image>. Аргумент <image> — путь к файлу образа ISO на маршрутизаторе или URL образа. В URL используются схемы http, https, ftp, ftps, sftp, scp и tftp, например http://192.0.2.10/fakel-image.iso или scp://192.0.2.10/images/fakel-image.iso. Для загрузки образа через экземпляр VRF задайте аргумент vrf <vrf>, для загрузки с сервера, который требует аутентификации, — аргументы username <username> password <password>. Если образ задан адресом URL, команда загружает образ вместе с подписью, когда подпись доступна, и проверяет подпись. Если подпись недоступна, команда запрашивает подтверждение (Signature is not available. Do you want to continue with installation?). Если образ не удалось получить, команда выводит сообщение The image cannot be fetched from: <image> и причину ошибки.
Перед добавлением образа команда проверяет, что на накопителе есть не менее 2 ГБ свободного места (иначе выводит сообщение Image upgrade requires at least 2GB of free drive space.), что образ совместим с работающей системой по архитектуре и варианту образа (иначе выводит сообщение Image compatibility check failed, aborting installation.) и что контрольные суммы файлов образа верны (иначе выводит сообщение Image checksum verification failed.). Затем команда запрашивает у администратора:
имя нового образа (
What would you like to name this image?); по умолчанию предлагается версия из образа. Имя содержит от 1 до 64 символов: латинские буквы, цифры и знаки.+-_. Если образ с таким именем уже установлен, команда просит выбрать другое имя;нужно ли назначить новый образ загружаемым по умолчанию (
Would you like to set the new image as the default one for boot?); по умолчанию — да;нужно ли скопировать активную конфигурацию в новый образ (
An active configuration was found. Would you like to copy it to the new image?); по умолчанию — да. Если ответить «нет», новый образ получает пустую конфигурацию;нужно ли скопировать в новый образ ключи SSH узла (
Would you like to copy SSH host keys?); по умолчанию — да;нужно ли настроить сервер ZTP (
Would you like to configure ZTP server?); по умолчанию — нет. Если ответить «да», команда запрашивает IP-адрес сервера ZTP (Please enter IP address of ZTP server:). Сервер ZTP (ZTP Hub) служит для автоматического подключения маршрутизатора к сети SD-WAN: после загрузки нового образа маршрутизатор передает серверу свой серийный номер и, если устройство зарегистрировано на сервере, подключается к контроллеру SD-WAN (см. также Диалог программы установки).
Затем команда копирует файлы образа на накопитель и завершает работу. Новый образ появляется в выводе команды show system image.
Команда не работает в системе, загруженной с установочного носителя: в ней выводится сообщение The system is in live-boot mode. Please use "install image" instead. Команда add system image доступна только пользователю уровня «Администратор».
Установленный образ, который больше не нужен, удаляет команда delete system image. Команда удаляет файлы образа с накопителя и пункт образа из меню загрузчика. Без аргумента команда выводит список установленных образов (The following images are installed:) и предлагает выбрать образ (Select an image to delete:). Перед удалением команда запрашивает подтверждение (Do you really want to delete the image <image>?). После удаления команда выводит сообщение The image "<image>" was successfully deleted.
Работающий образ и образ, который загружается по умолчанию, удалить нельзя. В этих случаях команда выводит сообщения Currently running image cannot be deleted; reboot into another image first и Default image cannot be deleted; set another image as default first. Чтобы удалить такой образ, назначьте образом по умолчанию другой образ (см. Образ и консоль по умолчанию) и перезагрузите устройство. Если образ не найден, команда выводит сообщение The image "<image>" cannot be found. Команда delete system image доступна только пользователю уровня «Администратор».
Если после установки накопитель устройства увеличили (например, расширили виртуальный диск виртуальной машины), корневой раздел ПО Факел не занимает новое место сам. Команда force root-partition-auto-resize расширяет корневой раздел до конца диска и увеличивает его файловую систему. Если корневой раздел уже занимает весь диск, раздел не меняется, и команда ничего не выводит. Размер корневого раздела проверяют командой show system storage (см. Общие сведения). Чтобы раздел расширялся при каждой загрузке системы, задайте параметр system option root-partition-auto-resize. Команда force root-partition-auto-resize доступна пользователю уровня «Оператор».
Список команд¶
Режим «Администрирование»¶
install image¶
fakel.Синтаксис:
install image
Режим: «Администрирование».
Уровень привилегий: «Администратор».
add system image <image>¶
Синтаксис:
add system image
<image>add system image
<image>vrf<vrf>
Аргументы:
<image>— путь к файлу образа ISO или URL образа, например/path/to/fakel-image.isoилиhttp://example.com/fakel-image.iso. Формат: строка;<vrf>— имя экземпляра VRF, через который загружается образ. Формат: строка. Необязательный аргумент; если он не указан, образ загружается без использования экземпляра VRF.
Режим: «Администрирование».
Уровень привилегий: «Администратор».
add system image <image> username <username> password <password>¶
Синтаксис:
add system image
<image>username<username>password<password>add system image
<image>vrf<vrf>username<username>password<password>
Аргументы:
<image>— путь к файлу образа ISO или URL образа, например/path/to/fakel-image.isoилиhttp://example.com/fakel-image.iso. Формат: строка;<vrf>— имя экземпляра VRF, через который загружается образ. Формат: строка. Необязательный аргумент; если он не указан, образ загружается без использования экземпляра VRF;<username>— логин для аутентификации на сервере. Формат: строка;<password>— пароль для аутентификации на сервере. Формат: строка.
Режим: «Администрирование».
Уровень привилегий: «Администратор».
delete system image¶
Синтаксис:
delete system image
delete system image
<image>
Аргументы:
<image>— имя установленного образа из вывода командыshow system image. Необязательный аргумент; если он не указан, команда выводит список установленных образов и предлагает выбрать образ.
Режим: «Администрирование».
Уровень привилегий: «Администратор».
force root-partition-auto-resize¶
Синтаксис:
force root-partition-auto-resize
Режим: «Администрирование».