Ж3.8. Описание ключей

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

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

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

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

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

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

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

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

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

для ОС Windows: var\extensions

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

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

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

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

-log=<файл_журнала> — активировать ведение журнала Сервера Dr.Web в файл по указанному пути.

Для Сервера Dr.Web на платформах UNIX вместо имени файла может использоваться "минус", что означает выводить журнал на стандартный вывод. Операции на платформах UNIX выполняются от имени пользователя drwcs, и если у него нет прав на запись в каталог файла журнала, то возникнет ошибка.

По умолчанию: для ОС Windows — drwcsd.log в каталоге, указываемом ключом -var-root, для ОС семейства UNIX задается ключом -syslog=user (см. ниже).

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

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

Параметр

Описание

<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.

По умолчанию 10z,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=<каталог> — путь к каталогу, в который Сервер Dr.Web имеет право записи и который предназначен для хранения изменяемых файлов (например, журналов, а также файлов репозитория). По умолчанию подкаталог var корневого каталога.

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

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

-verbosity=<источник_сообщения1>:<уровень1>,<источник_сообщения2>:<уровень2>,<источник_сообщения3>:<уровень3> и т. д. При этом <уровень> наследуется по общему принципу, т.е. находится ближайший родительский источник с заданным уровнем детализации. Ключ формата -verbosity=all:all равносилен ключу -verbosity=all (см. также Приложение К. Формат файлов журнала).

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

 

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

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

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

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

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

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

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

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

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

-keep — не удалять содержимое временного каталога после установки Сервера Dr.Web.

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

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

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

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