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

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

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

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

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

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

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

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

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

для ОС Windows: var\extensions

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

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

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

-home=<корень> — каталог установки Сервера (корневой каталог). Структура данного каталога описана в п. Установка Dr.Web Enterprise Server для ОС 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> - единица измерения, возможные значения: k (kilo), m (mega), g (giga).

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

При использовании режима ротации используется следующий формат именования файлов: file.<N>.log или file.<N>.log.dz, где <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 — синонимы (см. также Приложение L. Формат файлов протокола).

 

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

 

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

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

 

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

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

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