З3.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 — синонимы.

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

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

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

 

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

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

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

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

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

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

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

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

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

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

-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; означают изменить пользователя или группу процесса и выполняться с правами указанного пользователя (группы).