З7.4. Утилита дистанционной диагностики Сервера Dr.Web для работы со скриптами |
Утилита дистанционной диагностики Сервера Dr.Web позволяет удаленно подключаться к Серверу Dr.Web для базового управления и просмотра статистики работы. В отличие от drwcntl, утилита drwcmd может быть использована при работе со скриптами. Предоставляются следующие версии консольной утилиты дистанционной диагностики Сервера Dr.Web для работы со скриптами:
Описание настроек Сервера Dr.Web для подключения утилиты дистанционной диагностики Сервера Dr.Web приведены в , п. Удаленный доступ к Серверу Dr.Web. Формат команды запуска: drwcmd [<ключи>] [<файлы>] Допустимые ключи
•--? — вывести справку по ключам. •--help — вывести справку по ключам. •--commands=<команды> — выполнить заданные команды (аналогичны командам утилиты drwcntl). Допускается задание нескольких команд, разделенных знаком ;. •--debug=yes|no — вести журнала работы утилиты в отладочном режиме (стандартный поток вывода stderr). По умолчанию no. •--files=yes|no — разрешить выполнение команд (аналогичны командам утилиты drwcntl) из заданных файлов. По умолчанию yes. Задание команд в файле должно осуществляться по одной команде на строке. Пустые строки игнорируются. В качестве начала комментария допускается использование знака #. •--keep=yes|no — поддерживать соединение с Сервером Dr.Web после выполнения последней команды до завершения процесса утилиты. По умолчанию no. •--output=<файл> — файл для вывода ответов Сервера Dr.Web. По умолчанию, если файл не указан, используется стандартный поток вывода stdout. Если имя файла начинается с символа (+), то результат выполнения команд будет добавлен в конец файла, иначе — файл будет перезаписан. •--password=<пароль> — пароль для авторизации на Сервере Dr.Web. Может быть определен в файле, заданном в ключе --resource. •--read=yes|no — разрешить чтение параметров подключения к Серверу Dr.Web из ресурсного файла. По умолчанию yes. •--resource=<файл> — ресурсный файл с параметрами подключения к Серверу Dr.Web: адресом Сервера Dr.Web и регистрационными данными администратора для авторизации на Сервере Dr.Web. По умолчанию используется файл .drwcmdrc, расположенный в следующем каталоге: ▫Для ОС семейства UNIX: $HOME ▫Для ОС Windows: %LOCALAPPDATA% Каждая строка в файле должна представлять из себя 3 слова, разделенных пробелами: <Сервер_Dr.Web> <пользователь> <пароль>. Если нужно использовать в середине слова пробел, то он задается как %S. Если требуется знак процента, то он задается как %P. Например:
•--server=<Сервер_Dr.Web> — адрес Сервера Dr.Web. По умолчанию ssl://127.0.0.1. Может быть определен в файле, заданном в ключе --resource. •--user=<пользователь> — имя пользователя для авторизации на Сервере Dr.Web. Может быть определено в файле, заданном в ключе --resource. •--verbose=yes|no — выводить подробный ответа Сервера Dr.Web (стандартный поток вывода stdout). По умолчанию no. •--version — вывести информацию о версии утилиты. Процедура подключения к Серверу Dr.Web: 1.При определении данных подключения к Серверу Dr.Web приоритетными являются значения, заданные в ключах --server, --user и --password. 2.Если ключ --server не задан, используется его значение по умолчанию — ssl://127.0.0.1. 3.Если ключ --user не задан, то в файле .drwcmdrc (может быть переопределен в ключе --resource) осуществляется поиск нужного Сервера Dr.Web и берется первое по алфавиту имя пользователя. 4.Если ключ --password не задан, то в файле .drwcmdrc (может быть переопределен в ключе --resource) осуществляется поиск по Серверу Dr.Web и имени пользователя.
5.Если имя пользователя и пароль не заданы при помощи ключей или через ресурсный файл, утилита запросит ввод учетных данных через консоль. Особенности выполнения команд: •Если в качестве файлов с командами задано пустое значение (-), то читаются команды, введенные через консоль. •Если одновременно заданы команды в ключе --commands и список файлов, то сначала выполняются команды, заданные в ключе --commands. •Если не заданы ни файлы, ни команды в ключе --commands, то читаются команды, введенные через консоль. Чтобы выполнить команды из ключа --command, а затем команды из консоли, введите следующее:
Коды завершения работы •0 — успешное выполнение. •1 — запрошена справка по ключам: --help или --?. •2 — ошибка разбора командной строки: не заданы параметры авторизации и т. п. •3 — ошибка создания файла для вывода ответа Сервера Dr.Web. •4 — ошибка авторизации на Сервере Dr.Web: неверные имя и/или пароль администратора. •5 — аварийный разрыв соединения с Сервером Dr.Web. •127 — неопределенная фатальная ошибка. |