Как изменить параметры задачи в командной строке

Вы можете изменять параметры всех пользовательских задач и всех предустановленных задач, кроме задач Rollback и License.

В командной строке вы можете изменять параметры задач с помощью команды kfl-control --set-settings:

• Вы можете изменять все параметры задачи, используя конфигурационный файл, который содержит параметры задачи. Конфигурационный файл вы можете получить с помощью команды вывода параметров задачи.
• Вы можете изменять отдельные параметры задачи, используя ключи командной строки в формате <имя параметра>=<значение параметра>. Текущие значения параметров задачи вы можете получить с помощью команды вывода параметров задачи.
• Вы можете восстанавливать заданные по умолчанию параметры задачи.

Вы можете добавлять и удалять области проверки и области исключения используя конфигурационный файл, который содержит параметры задачи, или ключи командной строки. Настройка областей проверки и областей исключения доступна для задач с типами OAS и ODS.

В системах с файловой системой btrfs и включенными активными снимками для оптимизации работы задач проверки рекомендуется добавить в исключения путь со снимками, смонтированными системой в режиме "только чтение". Например, в системах на базе SUSE/OpenSUSE в качестве пути для исключения вы можете указать /.snapshots/*/snapshot/.

Для некоторых задач также предусмотрены отдельные команды управления, которые позволяют изменять параметры задач.

Как изменить параметры задачи с помощью конфигурационного файла

Чтобы изменить значения параметров задачи с помощью конфигурационного файла:

1. Выведите параметры задачи в конфигурационный файл с помощью команды kfl-control --get-settings.
2. Откройте конфигурационный файл и измените значения нужных параметров.

   Для задач типа OAS и ODS вы можете добавлять или удалять области проверки и области исключения.

   Если вы хотите добавить область проверки, добавьте в файл секцию [ScanScope.item_#] со следующими параметрами:

   • AreaDesc – описание области проверки, содержащее дополнительную информацию об этой области.
   • UseScanArea – включить проверку указанной области.
   • Path – путь к директории с проверяемыми объектами. Вы можете указывать путь к локальной директории или включать проверку удаленных директорий, смонтированных на клиентском устройстве.
   • AreaMask.item_# – ограничение области проверки. Вы можете указать маску имени файлов, которые нужно проверять. По умолчанию проверка включена для всех объектов области проверки. Вы можете указать несколько элементов AreaMask.item_#.

   Если вы хотите добавить область исключения, добавьте в файл секцию [ExcludedFromScanScope.item_#] со следующими параметрами:

   • AreaDesc – описание области исключения, содержащее дополнительную информацию об области исключения.
   • UseScanArea – включить исключение указанной области.
   • Path – путь к директории с исключаемыми объектами. Вы можете указывать путь к локальной директории или исключать удаленные директории, смонтированные на клиентском устройстве. Возможные значения параметра зависят от типа задачи.
   • AreaMask.item_# – ограничение области исключения. Вы можете указать маску имени файлов, которые вы хотите исключить из области проверки. По умолчанию исключаются все объекты области.

     Пример: [ExcludedFromScanScope.item_0000] AreaDesc= UseScanArea=Yes Path=/tmp/notchecked AreaMask.item_0000=*

   Вы можете указать несколько секций [ScanScope.item_#] и [ExcludedFromScanScope.item_#]. Приложение будет обрабатывать области по индексу в порядке возрастания.

3. Сохраните конфигурационный файл.
4. Выполните команду:

   kfl-control --set-settings <идентификатор/имя задачи> --file <путь к конфигурационному файлу> [--json]

   где:

   • <идентификатор/имя задачи> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
   • --file <путь к конфигурационному файлу> – полный путь к конфигурационному файлу, из которого будут импортированы параметры задачи.
   • --json – укажите этот ключ, если вы импортируете параметры из конфигурационного файла формата JSON. Если вы не укажете ключ --json, приложение попытается выполнить импорт из файла формата INI. При невозможности импорта отображается ошибка.

Все значения параметров задачи, заданные в файле, будут импортированы в приложение.

Как изменить параметры задачи с помощью ключей командной строки

С помощью ключей команды kfl-control --set-settings вы можете изменять отдельные значения параметров задачи, а также добавлять или удалять области проверки и области исключения для задач типа OAS и ODS.

Настройка отдельных параметров задач

Чтобы изменить отдельные значения параметров задачи с помощью ключей командной строки, выполните следующую команду:

kfl-control --set-settings <идентификатор/имя задачи> <имя параметра>=<значение параметра> [<имя параметра>=<значение параметра>]

где:

• <идентификатор/имя задачи> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
• <имя параметра>=<значение параметра> – имя и значение одного из параметров задачи. Текущие значения параметров задачи вы можете получить с помощью команды вывода параметров задачи.

Значения указанных параметров задачи будут изменены.

Добавление и удаление области проверки

Чтобы добавить область проверки с помощью ключей командной строки, выполните следующую команду:

kfl-control --set-settings <идентификатор/имя задачи> --add-path <путь>

где:

• <идентификатор/имя задачи> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
• --add-path <путь> – добавить путь к директории с проверяемыми объектами.

В параметры задачи будет добавлена новая секция [ScanScope.item_#]. Приложение будет проверять объекты в директории, указанной параметром Path. Остальные параметры области проверки принимают значения по умолчанию.

Если в параметрах задачи уже есть секция [ScanScope.item_#] с указанным значением параметра Path, дублирующая секция не добавляется.

Если для параметра UseScanArea установлено значение No, после выполнения этой команды значение изменится на Yes и будет выполняться проверка объектов, расположенных в этой директории.

Чтобы удалить область проверки с помощью ключей командной строки, выполните следующую команду:

kfl-control --set-settings <идентификатор/имя задачи> --del-path <путь>

где:

• <идентификатор/имя задачи> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
• --del-path <путь> – удалить путь к директории с проверяемыми объектами.

Секция [ScanScope.item_#], содержащая указанный путь, будет удалена из параметров задачи. Приложение не будет проверять объекты в указанной директории.

Добавление и удаление области исключения

Чтобы добавить область исключения с помощью ключей командной строки, выполните следующую команду:

kfl-control --set-settings <идентификатор/имя задачи> --add-exclusion <путь>

где:

• <идентификатор/имя задачи> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
• --add-exclusion <путь> – добавить путь к директории с объектами, которые вы хотите исключить из проверки.

В параметры задачи будет добавлена новая секция [ExcludedFromScanScope.item_#]. Приложение будет исключать из проверки объекты в директории, указанной параметром Path. Остальные параметры области исключения принимают значения по умолчанию.

Если в параметрах задачи уже есть секция [ExcludedFromScanScope.item_#] с указанным значением параметра Path, дублирующая секция не добавляется.

Если для параметра UseScanArea установлено значение No, после выполнения этой команды значение изменится на Yes и объекты, расположенные в этой директории, будут исключаться из проверки.

Чтобы удалить область исключения с помощью ключей командной строки, выполните следующую команду:

kfl-control --set-settings <идентификатор/имя задачи> --del-exclusion <путь>

где:

• <идентификатор/имя задачи> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
• --del-exclusion <путь> – удалить путь к директории с исключаемыми объектами.

Секция [ExcludedFromScanScope.item_#], содержащая указанный путь, будет удалена из параметров задачи. Приложение не будет исключать из проверки объекты в указанной директории.

Как восстановить параметры задачи по умолчанию в командной строке

Вы можете восстанавливать заданные по умолчанию параметры для всех пользовательских задач и всех предустановленных задач, кроме задач типов Rollback и License (эти задачи не имеют параметров).

Чтобы восстановить заданные по умолчанию параметры задачи, выполните следующую команду:

kfl-control --set-settings <идентификатор/имя задачи> --set-to-default

где <идентификатор/имя задачи> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.

Приложение изменит значения параметров на заданные по умолчанию.