Документация: ПО Факел — разрабатываемая версия

Параметры системы

Обзор

Параметры раздела system option определяют общее поведение системы: реакцию на нажатие клавиш и на критические ошибки, параметры загрузки ядра, настройки клиентов HTTP и SSH, профиль производительности и режим приема пакетов интерфейсами, которые обслуживает FVE. Раздел system sysctl позволяет изменить параметры ядра операционной системы, раздел system time-zone задает часовой пояс.

Параметры раздела system option делятся на группы:

  • Поведение системы. Параметр ctrl-alt-delete задает действие при нажатии Ctrl-Alt-Delete (игнорировать, перезагрузить или выключить систему); если параметр не задан, нажатие игнорируется. Параметр reboot-on-panic включает перезагрузку через 60 секунд после критической ошибки ядра. Параметр startup-beep включает звуковой сигнал, когда в систему можно войти. Параметр keyboard-layout задает раскладку клавиатуры (по умолчанию us), параметр time-format — 12-часовой или 24-часовой формат времени (по умолчанию 12-часовой). Параметр disable-usb-autosuspend отключает автоматическое приостановление питания устройств USB. Параметр trace включает или отключает вывод отладочной трассировки служебных программ системы.

  • Корневой раздел. Параметр root-partition-auto-resize расширяет корневой раздел до конца диска при каждой загрузке системы. Однократное расширение выполняет команда force root-partition-auto-resize (см. Образы системы).

  • Параметры ядра. Параметры kernel disable-mitigations, kernel disable-power-saving, kernel amd-pstate-driver и kernel quiet изменяют параметры загрузки ядра и вступают в силу после перезагрузки. Параметр kernel amd-pstate-driver принимается только на процессорах AMD. Параметр kernel debug wireguard включает динамическую отладку модуля WireGuard сразу после применения конфигурации.

  • Производительность. Параметр performance настраивает систему на максимальную пропускную способность сети (throughput) или на низкую задержку (latency). Параметр interfaces-rx-mode задает режим приема пакетов для интерфейсов, которые обслуживает FVE: опрос (polling, по умолчанию), прерывания (interrupt) или адаптивный режим (adaptive). В адаптивном режиме система работает в режиме прерываний, пока нагрузка не превысит порог polling-mode-threshold (по умолчанию 4 %), и переключается обратно в режим прерываний при снижении нагрузки до порога interrupt-mode-threshold (по умолчанию 2 %). Пороги задаются в процентах.

  • Источник соединений. Параметры http-client и ssh-client задают адрес (source-address) или интерфейс (source-interface) источника соединений, которые маршрутизатор устанавливает как клиент HTTP и SSH. Адрес источника должен быть назначен одному из интерфейсов маршрутизатора; иначе применение конфигурации завершается ошибкой. Для клиента HTTP нельзя одновременно задать адрес и интерфейс. Параметр ssh-client действует на клиент SSH командной оболочки маршрутизатора (команда ssh): с source-address соединение устанавливается с заданного адреса, с source-interface — через заданный интерфейс с его адресом. Команды CLI, которые передают файлы по SCP или SFTP (например, save scp://…), используют собственный клиент, и параметр ssh-client на них не действует.

Раздел system sysctl содержит параметры ядра в виде пар «имя — значение»: имя задает узел parameter <parameter>, значение — параметр value. Допустимые имена — имена параметров ядра работающей системы в записи через точку (например, net.ipv4.tcp_keepalive_time); другое имя отклоняется при вводе команды с сообщением Invalid value. Значения вступают в силу при применении конфигурации. Если ядро не принимает значение, применение конфигурации завершается ошибкой sysctl: setting key "<parameter>": Invalid argument. После удаления параметра из конфигурации ядро сохраняет установленное значение до перезагрузки системы.

Параметр system time-zone задает часовой пояс системы; по умолчанию используется UTC. Часовой пояс вступает в силу при применении конфигурации.

Параметры interfaces-rx-mode, polling-mode-threshold и interrupt-mode-threshold относятся к интерфейсам, которые обслуживает FVE. Текущий режим приема пакетов и пороги переключения отображают команды show system interfaces-rx-mode и show system adaptive-mode-thresholds (см. Общие сведения).

В текущей версии ПО Факел параметры http-client source-address и http-client source-interface не применяются (см. Ограничения).

Список команд

Режим «Конфигурирование»


system option ctrl-alt-delete <ctrl-alt-delete>

Описание:
Задает действие системы при нажатии комбинации клавиш Ctrl-Alt-Delete. Если параметр не задан, нажатие комбинации игнорируется.

Синтаксис:

  • set system option ctrl-alt-delete <ctrl-alt-delete>

  • delete system option ctrl-alt-delete <ctrl-alt-delete>

  • show system option ctrl-alt-delete

Аргументы:

  • <ctrl-alt-delete> — действие системы. Возможные значения: ignore — игнорировать комбинацию клавиш; reboot — перезагрузить систему; poweroff — выключить систему.

Режим: «Конфигурирование».

system option disable-usb-autosuspend

Описание:
Отключает автоматическое приостановление питания (autosuspend) для всех устройств USB.

Синтаксис:

  • set system option disable-usb-autosuspend

  • delete system option disable-usb-autosuspend

  • show system option disable-usb-autosuspend

Режим: «Конфигурирование».

system option http-client source-address <source-address>

Описание:
Задает IP-адрес источника, с которого клиент HTTP маршрутизатора устанавливает соединения. Нельзя задать одновременно с параметром source-interface.

Синтаксис:

  • set system option http-client source-address <source-address>

  • delete system option http-client source-address <source-address>

  • show system option http-client source-address

Аргументы:

  • <source-address> — адрес источника. Адрес должен быть назначен одному из интерфейсов маршрутизатора. Формат: IPv4-адрес (x.x.x.x) или IPv6-адрес (h:h:h:h:h:h:h:h).

Режим: «Конфигурирование».

system option http-client source-interface <source-interface>

Описание:
Задает интерфейс, через который клиент HTTP маршрутизатора устанавливает соединения. Нельзя задать одновременно с параметром source-address.

Синтаксис:

  • set system option http-client source-interface <source-interface>

  • delete system option http-client source-interface <source-interface>

  • show system option http-client source-interface

Аргументы:

  • <source-interface> — имя интерфейса. Формат: строка.

Режим: «Конфигурирование».

system option interfaces-rx-mode <interfaces-rx-mode>

Описание:
Задает режим приема пакетов (rx-mode) для интерфейсов, которые обслуживает FVE.

Синтаксис:

  • set system option interfaces-rx-mode <interfaces-rx-mode>

  • delete system option interfaces-rx-mode <interfaces-rx-mode>

  • show system option interfaces-rx-mode

Аргументы:

  • <interfaces-rx-mode> — режим приема пакетов. Возможные значения: polling — опрос; цикл обработки работает без ожидания (низкая задержка, высокая загрузка процессора); interrupt — прерывания; цикл обработки ожидает события (низкая загрузка процессора, задержка немного выше); adaptive — адаптивный режим; система работает в режиме прерываний, пока нагрузка не превысит порог переключения в режим опроса. Значение по умолчанию: polling.

Режим: «Конфигурирование».

system option interrupt-mode-threshold <interrupt-mode-threshold>

Описание:
Задает порог нагрузки, при котором адаптивный режим приема пакетов переключается в режим прерываний. Порог задается в процентах. Команда show system adaptive-mode-thresholds выводит его по шкале от 0 до 255, то есть значение в процентах, умноженное на 2,5 (см. Общие сведения).

Синтаксис:

  • set system option interrupt-mode-threshold <interrupt-mode-threshold>

  • delete system option interrupt-mode-threshold <interrupt-mode-threshold>

  • show system option interrupt-mode-threshold

Аргументы:

  • <interrupt-mode-threshold> — порог в процентах. Формат: целое число. Диапазон значений: от 1 до 100. Значение по умолчанию: 2.

Режим: «Конфигурирование».

system option kernel amd-pstate-driver <amd-pstate-driver>

Описание:
Включает и настраивает драйвер pstate для процессоров AMD Ryzen и Epyc. Параметр принимается только на процессорах AMD. Изменение параметров ядра вступает в силу после перезагрузки.

Синтаксис:

  • set system option kernel amd-pstate-driver <amd-pstate-driver>

  • delete system option kernel amd-pstate-driver <amd-pstate-driver>

  • show system option kernel amd-pstate-driver

Аргументы:

  • <amd-pstate-driver> — режим драйвера. Возможные значения: active — низкоуровневое управление прошивкой по заданному профилю; регулятор системы не действует; passive — драйвер позволяет регулятору системы управлять частотой процессора и предоставляет доступные состояния производительности; guided — драйвер позволяет задать желаемые уровни производительности, а прошивка выбирает уровень в этом диапазоне с учетом текущей нагрузки.

Режим: «Конфигурирование».

system option kernel debug wireguard

Описание:
Включает динамическую отладку модуля WireGuard ядра операционной системы.

Синтаксис:

  • set system option kernel debug wireguard

  • delete system option kernel debug wireguard

  • show system option kernel debug wireguard

Режим: «Конфигурирование».

system option kernel disable-mitigations

Описание:
Отключает все необязательные меры защиты процессора от уязвимостей (mitigations). Изменение параметров ядра вступает в силу после перезагрузки.

Синтаксис:

  • set system option kernel disable-mitigations

  • delete system option kernel disable-mitigations

  • show system option kernel disable-mitigations

Режим: «Конфигурирование».

system option kernel disable-power-saving

Описание:
Отключает механизмы энергосбережения процессора (состояния C). Изменение параметров ядра вступает в силу после перезагрузки.

Синтаксис:

  • set system option kernel disable-power-saving

  • delete system option kernel disable-power-saving

  • show system option kernel disable-power-saving

Режим: «Конфигурирование».

system option kernel quiet

Описание:
Отключает большинство сообщений журнала ядра. Изменение параметров ядра вступает в силу после перезагрузки.

Синтаксис:

  • set system option kernel quiet

  • delete system option kernel quiet

  • show system option kernel quiet

Режим: «Конфигурирование».

system option keyboard-layout <keyboard-layout>

Описание:
Задает раскладку клавиатуры системы (код ISO2).

Синтаксис:

  • set system option keyboard-layout <keyboard-layout>

  • delete system option keyboard-layout <keyboard-layout>

  • show system option keyboard-layout

Аргументы:

  • <keyboard-layout> — раскладка клавиатуры. Возможные значения: us — США; uk — Великобритания; fr — Франция; de — Германия; es — Испания; fi — Финляндия; it — Италия; jp106 — Япония; no — Норвегия; dk — Дания; se-latin1 — Швеция; dvorak — раскладка Дворака. Значение по умолчанию: us.

Режим: «Конфигурирование».

system option performance <performance>

Описание:
Настраивает производительность системы под сетевую нагрузку.

Синтаксис:

  • set system option performance <performance>

  • delete system option performance <performance>

  • show system option performance

Аргументы:

  • <performance> — профиль настройки. Возможные значения: throughput — настройка на максимальную пропускную способность сети; latency — настройка на низкую задержку в сети.

Режим: «Конфигурирование».

system option polling-mode-threshold <polling-mode-threshold>

Описание:
Задает порог нагрузки, при котором адаптивный режим приема пакетов переключается в режим опроса. Порог задается в процентах. Команда show system adaptive-mode-thresholds выводит его по шкале от 0 до 255, то есть значение в процентах, умноженное на 2,5 (см. Общие сведения).

Синтаксис:

  • set system option polling-mode-threshold <polling-mode-threshold>

  • delete system option polling-mode-threshold <polling-mode-threshold>

  • show system option polling-mode-threshold

Аргументы:

  • <polling-mode-threshold> — порог в процентах. Формат: целое число. Диапазон значений: от 1 до 100. Значение по умолчанию: 4.

Режим: «Конфигурирование».

system option reboot-on-panic

Описание:
Включает перезагрузку системы через 60 секунд после критической ошибки ядра (kernel panic).

Синтаксис:

  • set system option reboot-on-panic

  • delete system option reboot-on-panic

  • show system option reboot-on-panic

Режим: «Конфигурирование».

system option root-partition-auto-resize

Описание:
Включает расширение корневого раздела ПО Факел до конца диска при каждой загрузке системы (см. Образы системы).

Синтаксис:

  • set system option root-partition-auto-resize

  • delete system option root-partition-auto-resize

  • show system option root-partition-auto-resize

Режим: «Конфигурирование».

system option ssh-client source-address <source-address>

Описание:
Задает IP-адрес источника, с которого клиент SSH командной оболочки маршрутизатора (команда ssh) устанавливает соединения. На команды CLI, которые передают файлы по SCP или SFTP, параметр не действует.

Синтаксис:

  • set system option ssh-client source-address <source-address>

  • delete system option ssh-client source-address <source-address>

  • show system option ssh-client source-address

Аргументы:

  • <source-address> — адрес источника. Адрес должен быть назначен одному из интерфейсов маршрутизатора. Формат: IPv4-адрес (x.x.x.x) или IPv6-адрес (h:h:h:h:h:h:h:h).

Режим: «Конфигурирование».

system option ssh-client source-interface <source-interface>

Описание:
Задает интерфейс, через который клиент SSH командной оболочки маршрутизатора (команда ssh) устанавливает соединения; адрес источника — адрес этого интерфейса. На команды CLI, которые передают файлы по SCP или SFTP, параметр не действует.

Синтаксис:

  • set system option ssh-client source-interface <source-interface>

  • delete system option ssh-client source-interface <source-interface>

  • show system option ssh-client source-interface

Аргументы:

  • <source-interface> — имя интерфейса. Формат: строка.

Режим: «Конфигурирование».

system option startup-beep

Описание:
Включает звуковой сигнал через динамик системы, когда в систему можно войти.

Синтаксис:

  • set system option startup-beep

  • delete system option startup-beep

  • show system option startup-beep

Режим: «Конфигурирование».

system option time-format <time-format>

Описание:
Задает формат времени системы.

Синтаксис:

  • set system option time-format <time-format>

  • delete system option time-format <time-format>

  • show system option time-format

Аргументы:

  • <time-format> — формат времени. Возможные значения: 12-hour — 12-часовой формат времени; 24-hour — 24-часовой формат времени. Значение по умолчанию: 12-hour.

Режим: «Конфигурирование».

system option trace <trace>

Описание:
Включает или отключает вывод трассировки вызовов (Traceback) в отчете об ошибке, который выводится при сбое команды, например при применении конфигурации. Если вывод отключен, отчет содержит только сведения о системе и сообщение об ошибке. В конфигурации по умолчанию вывод включен.

Синтаксис:

  • set system option trace <trace>

  • delete system option trace <trace>

  • show system option trace

Аргументы:

  • <trace> — состояние вывода трассировки. Возможные значения: enable — вывод трассировки включен; disable — вывод трассировки отключен.

Режим: «Конфигурирование».

system sysctl parameter <parameter>

Описание:
Задает параметр ядра операционной системы, значение которого нужно изменить. Значение задает параметр value. После удаления параметра из конфигурации ядро сохраняет установленное значение до перезагрузки системы.

Синтаксис:

  • set system sysctl parameter <parameter>

  • delete system sysctl parameter <parameter>

  • show system sysctl parameter

Аргументы:

  • <parameter> — имя параметра ядра работающей системы в записи через точку, например net.ipv4.tcp_keepalive_time. Другое имя отклоняется с сообщением Invalid value.

Режим: «Конфигурирование».

system sysctl parameter <parameter> value <value>

Описание:
Задает значение параметра ядра операционной системы. Значение вступает в силу при применении конфигурации; если ядро его не принимает, применение завершается ошибкой sysctl: setting key "<parameter>": Invalid argument.

Синтаксис:

  • set system sysctl parameter <parameter> value <value>

  • delete system sysctl parameter <parameter> value <value>

  • show system sysctl parameter <parameter> value

Аргументы:

  • <parameter> — имя параметра ядра. Формат: строка.

  • <value> — значение параметра. Формат: строка.

Режим: «Конфигурирование».

system time-zone <time-zone>

Описание:
Задает часовой пояс системы.

Синтаксис:

  • set system time-zone <time-zone>

  • delete system time-zone <time-zone>

  • show system time-zone

Аргументы:

  • <time-zone> — название часового пояса. Формат: название часового пояса из базы данных часовых поясов, например Europe/Moscow. Значение по умолчанию: UTC.

Режим: «Конфигурирование».