H4.8. Описание ключей

Кроссплатформенные ключи

-activation-key=<лиц_ключ> – лицензионный ключ Сервера. По умолчанию файл enterprise.key, расположенный в подкаталоге etc корневого каталога.

Обратите внимание, лицензионный ключ Сервера более не используется, начиная с версии 10. Ключ -activation-key может использоваться при обновлении Сервера с предыдущих версий и при инициализации базы данных: идентификатор Сервера будет взят из указанного лицензионного ключа.

-bin-root=<каталог_для_исполняемых> – путь к исполняемым файлам. По умолчанию подкаталог bin корневого каталога.

-conf=<конф_файл> – имя и расположение конфигурационного файла Сервера. По умолчанию файл drwcsd.conf в подкаталоге etc корневого каталога.

-daemon – для Windows-платформ означает запуск как службы; для платформ UNIX: "демонизация процесса" (перейти в корневой каталог, отсоединиться от терминала и перейти в фоновый режим).

-db-verify=on – при запуске Сервера выполнять проверку целостности БД. Значение по умолчанию. Настоятельно не рекомендуется запускать с явным указанием противоположного значения, за исключением запуска немедленно после проверки БД командой drwcsd verifydb, см. выше.

-help – выдать справку. Аналогично описанным выше программам.

-hooks – разрешить выполнение Сервером пользовательских скриптов расширения, находящихся в папке:

для ОС Windows: var\extensions

для OC FreeBSD: /var/drwcs/extensions

для OC Linux: /var/opt/drwcs/extensions

каталога установки Сервера Dr.Web. Скрипты предназначены для автоматизации работы администратора, упрощая и ускоряя выполнение некоторых заданий. Все скрипты по умолчанию отключены.

-home=<корень> – каталог установки Сервера (корневой каталог). Структура данного каталога описана в Руководстве по установке, п. Установка Сервера Dr.Web для ОС Windows®. По умолчанию текущий каталог при запуске.

-log=<журнал> – имя файла журнала Сервера. Вместо имени файла может использоваться “минус” (только для Сервера на платформах UNIX), что означает выводить журнал на стандартный вывод. По умолчанию: для Windows-платформ drwcsd.log в каталоге, указываемом ключом -var-root, для платформ UNIX задается ключом -syslog=user (см. ниже).

-private-key=<закр_ключ> – закрытый ключ Сервера. По умолчанию drwcsd.pri в подкаталоге etc корневого каталога.

-rotate=<N><f>,<M><u> – режим ротации журнала работы Сервера, где:

Параметр

Описание

<N>

Общее количество файлов журнала (включая текущий и архивные).

<f>

Формат хранения файлов журнала, возможные значения:

z (gzip) – сжимать файлы, используется по умолчанию,

p (plain) – не сжимать файлы.

<M>

Размер файла журнала либо время ротации, в зависимости от значения <u>;

<u>

Единица измерения, возможные значения:

для задания ротации по размеру файла журнала:

k – Кб,

m – Мб,

g – Гб.

для задания ротации по времени:

H – часы,

D – дни,

W – недели.

При задании ротации по времени осуществляется синхронизация вне зависимости от времени запуска команды: для значения H – синхронизация с началом часа, для D – с началом суток, для W – с началом недели (00:00 в понедельник) согласно кратности, указанной в параметре <u>.

Начальная точка отсчета – 01 января 01 года н.э., UTC+0.

По умолчанию 10,10m, что означает хранить 10 файлов по 10 мегабайт, использовать сжатие. Можно также использовать специальный формат none (-rotate=none) – это означает "не использовать ротацию, а писать всегда в один и тот же файл неограниченного размера".

При использовании режима ротации используется следующий формат именования файлов: file.<N>.log или file.<N>.log.gz, где <N> – порядковый номер: 1, 2, и т.д.

Например, пусть имя файла журнала (см. выше ключ -log) задано file.log. Тогда:

file.log – текущий файл (в который идет запись),

file.1.log – предыдущий,

file.2.log и так далее – чем больше число, тем более старая версия.

-trace – детально протоколировать место возникновения ошибки.

-var-root=<каталог_для_изменяемых> – путь к каталогу, в который Сервер имеет право записи и который предназначен для хранения изменяемых файлов (например, журналов, а также файлов репозитория). По умолчанию подкаталог var корневого каталога.

-verbosity=<уровень_подробности> – уровень детализации журнала. По умолчанию WARNING. Допустимые значения: ALL, DEBUG3, DEBUG2, DEBUG1, DEBUG, TRACE3, TRACE2, TRACE1, TRACE, INFO, NOTICE, WARNING, ERROR, CRIT. Значения ALL и DEBUG3 – синонимы (см. также Приложение K. Формат файлов журнала).

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

 

Ключи -verbosity и -log позиционно-зависимы.

При использовании этих ключей одновременно, ключ -verbosity должен идти перед ключом -log: ключ -verbosity переопределяет уровень детализации журналов, расположенных по путям, следующим далее в командной строке.

Ключи, доступные только под ОС Windows

-minimized – (только если запуск не как службы, а интерактивно) – минимизировать окно.

-service=<имя_сервиса> – ключ используется запущенным процессом службы для самоидентификации и установки самозащиты на ветку реестра службы Сервера. <имя_сервиса> – суффикс, который добавляется к названию службы по умолчанию, при этом полное имя службы: DrWebES-<имя_сервиса>.

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

-screen-size=<размер> – (только если запуск не как службы, а интерактивно) – размер в строках видимого журнала в окне Сервера, по умолчанию 1000.

Ключи, доступные только под ОС семейства UNIX

-etc=<path> – путь к директории etc (<var>/etc).

-pid=<файл> – файл, в который Сервер записывает идентификатор своего процесса.

-syslog=<режим> – протоколирование в системный журнал. Возможные режимы: auth, cron, daemon, kern, lpr, mail, news, syslog, user, uucp, local0 – local7 и для некоторых платформ – ftp, authpriv и console.

Ключи -syslog и -log работают совместно. Т.е. при запуске Сервера с ключом -syslog (например, service drwcsd start -syslog=user), Сервер запустится с заданным значением для ключа -syslog и со значением по умолчанию для ключа -log.

-user=<пользователь>, -group=<группа> – доступны только для OC UNIX, при запуске от имени пользователя root; означают изменить пользователя или группу процесса и выполняться с правами указанного пользователя (группы).