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 – разрешить выполнение Сервером пользовательских скриптов расширения, находящихся в каталоге:

каталога установки Сервера 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.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 переопределяет уровень детализации журналов, расположенных по путям, следующим далее в командной строке.

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

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

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