H10. Утилита дистанционной диагностики Сервера Dr.Web

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

Консольная версия утилиты располагается в каталоге bin каталога установки Сервера.

Описание настроек Сервера для подключения утилиты дистанционной диагностики Сервера Dr.Web приведены в Руководстве администратора, п. Удаленный доступ к Серверу Dr.Web.

Консольная версия утилиты

Формат команды запуска:

drwcntl [-?|-h|--help] [+<файл_журнала>] [<сервер> [<регистрационное_имя> [<пароль>]]]

где:

•-? -h --help – вывести справку по командам для использования утилиты.

•<файл_журнала> – записывать все действия утилиты в файл журнала по заданному пути.

•<сервер> – адресная строка Сервера, к которому подключается утилита в формате [(tcp|ssl)://]<IP-адрес или DNS-имя>[:<порт>].

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

a)Для подключения по ssl в конфигурационном файле frontdoor.conf должен присутствовать тег <ssl />. При этом подключение будет возможно только по ssl.

b)Для подключения по tcp в конфигурационном файле frontdoor.conf должен был отключен (закомментирован) тег <ssl />. При этом подключение будет возможно только по tcp.

Если в адресной строки Сервера не заданы параметры подключения, используются следующие значения:

•<регистрационное_имя> – регистрационное имя администратора Сервера.

•<пароль> – пароль администратора для доступа к Серверу.

Если регистрационное имя и пароль администратора не были заданы в строке подключения, утилита запросит ввести соответствующие учетные данные.

Допустимые команды

•cache <операция> – работа с файловым кэшем. Для запроса конкретной операции используйте следующие команды:

▫clear – очистить файловый кэш,

▫list – показать все содержимое файлового кэша,

▫matched <регулярное выражение> – показать содержимое файлового кэша, которое удовлетворяет заданному регулярному выражению,

▫maxfilesize [<размер>] – показать/установить максимальный размер предзагруженных файловых объектов. При запуске без дополнительных параметров показывает текущий размер. Для установки размера задайте требуемый размер в байтах после имени команды.

▫statistics – показать статистику использования файлового кэша.

•calculate <функция> – вычисление заданной последовательности. Для запроса конкретной последовательности используйте следующие команды:

▫hash [<стандарт>] [<строка>] – вычисление хэша заданной строки. Чтобы задать конкретный стандарт, используйте следующие команды:

▪gost – вычисление хэша заданной строки по стандарту ГОСТ,

▪md5 – вычисление MD5 хэша заданной строки,

▪sha – вычисление хэша заданной строки по стандарту SHA,

▪sha1 – вычисление хэша заданной строки по стандарту SHA1,

▪sha224 – вычисление хэша заданной строки по стандарту SHA224,

▪sha256 – вычисление хэша заданной строки по стандарту SHA256,

▪sha384 – вычисление хэша заданной строки по стандарту SHA384,

▪sha512 – вычисление хэша заданной строки по стандарту SHA512.

▫hmac [<стандарт>] [<строка>] – вычисление HMAC заданной строки. Чтобы задать конкретный стандарт, используйте следующие команды:

▪md5 – вычисление HMAC-MD5 для заданной строки,

▪sha256 – вычисление HMAC-SHA256 для заданной строки.

▫random – генерация произвольного числа,

▫uuid – генерация произвольного уникального идентификатора.

•clients <операция> – получение информации и управление клиентами, подключенными к Серверу. Для запроса конкретной функции используйте следующие команды:

▫addresses [<регулярное выражение>] – показать сетевые адреса станций, соответствующих заданному регулярному выражению. Если регулярное выражение не задано – показать адреса всех станции.

▫caddresses [<регулярное выражение>] – показать количество IP-адресов станций, соответствующих заданному регулярному выражению. Если регулярное выражение не задано – показать количество всех станций.

▫chosts [<регулярное выражение>] – показать количество имен компьютеров станций, соответствующих заданному регулярному выражению. Если регулярное выражение не задано – показать количество всех станции.

▫cids [<регулярное выражение>] – показать количество идентификаторов станций, соответствующих заданному регулярному выражению. Если регулярное выражение не задано – показать количество всех станции.

▫cnames [<регулярное выражение>] – показать количество имен станций, соответствующих заданному регулярному выражению. Если регулярное выражение не задано – показать количество количество всех станции.

▫disconnect [<регулярное выражение>] – оборвать текущее активное соединение со станциями, идентификаторы которых соответствуют заданному регулярному выражению. Если регулярное выражение не задано – оборвать соединение со всеми подключенными станциями.

▫enable [<режим>] – показать/установить режим подключения клиентов к Серверу. При запуске без дополнительных параметров показывает текущий режим. Для установки режима используйте следующие дополнительные команды:

▪on – принимать все соединения с клиентами.

▪off – отказывать всем клиентам в подключении.

▫hosts <регулярное выражение> – показать имена компьютеров станций, соответствующих заданному регулярному выражению.

▫ids <регулярное выражение> – показать идентификаторы станций, соответствующих заданному регулярному выражению.

▫names <регулярное выражение> – показать имена станций, соответствующих заданному регулярному выражению.

▫online <регулярное выражение> – показать длительность подключения станций, идентификатор, имя или адрес которых соответствуют заданному регулярному выражению. Длительность подключения считается с момента последнего подключения станций к Серверу.

▫statistics <регулярное выражение> – показать статистику по количеству клиентов, соответствующих заданному регулярному выражению.

▫traffic <регулярное выражение> – показать данные по трафику подключенных в данный момент клиентов, соответствующими заданному регулярному выражению.

•core – записать дамп процесса Сервера.

•cpu <параметр> – показать статистику использования CPU компьютера, на котором установлен Сервер. Для запроса конкретного параметра используйте следующие команды:

▫clear – удалить все накопленные статистические данные,

▫day – показать график загрузки CPU за текущий день,

▫disable – отключить отслеживание загрузки CPU,

▫enable – включить отслеживание загрузки CPU,

▫hour – показать график загрузки CPU за текущий час,

▫load – показать средний уровень загрузки CPU,

▫minute – показать график загрузки CPU за прошедшую минуту,

▫rawd – показать числовую статистику по загрузке CPU за день,

▫rawh – показать числовую статистику по загрузке CPU за последний час,

▫rawl – показать числовую статистику по средней загрузке CPU,

▫rawm – показать числовую статистику по загрузке CPU за последнюю минуту,

▫status – показать статус отслеживания статистики загрузки CPU.

•debug <параметр> – настройка отладки. Для задания конкретного параметра, используйте дополнительные команды. Для уточнения списка дополнительных команд, можете вызвать справку при помощи команды: ? debug.

•die – остановить Сервер и записать дамп процесса Сервера.

•dwcp <параметр> – установить/посмотреть настройки Dr.Web Control Protocol (включает журналы Сервера, Агентов и инсталляторов Агентов). Допустимые параметры:

▫compression <режим> – установить один из следующих режимов сжатия трафика:

▪on – сжатие включено,

▪off – сжатие отключено,

▪possible – сжатие возможно.

▫encryption <режим> – установить один из следующих режимов шифрования трафика:

▪on – шифрование включено,

▪off – шифрование отключено,

▪possible – шифрование возможно.

▫show – вывести текущие настройки Dr.Web Control Protocol.

•io <параметр> – показать статистику чтения/записи данных процессом Сервера. Для запроса конкретного параметра используйте следующие команды:

▫clear – удалить все накопленные статистические данные,

▫disable – отключить отслеживание статистики,

▫enable – включить отслеживание статистики,

▫rawdr – показать числовую статистику чтения данных за день,

▫rawdw – показать числовую статистику записи данных за день,

▫rawh – показать числовую статистику за последний час,

▫rawm – показать числовую статистику за последнюю минуту,

▫rday – показать график статистики чтения данных за день,

▫rhour – показать график статистики чтения данных за последний час,

▫rminute – показать график статистики чтения данных за последнюю минуту,

▫status – показать статус отслеживания статистики,

▫wday – показать график статистики записи данных за день,

▫whour – показать график статистики записи данных за последний час,

▫wminute – показать график статистики чтения данных за последнюю минуту.

•log <параметр> – записать строку в файл журнала Сервера или установить/посмотреть уровень детализации журнала. В зависимости от заданных параметров выполняются следующие действия:

▫log <строка> – записать в журнал Сервера заданную строку с уровнем детализации NOTICE.

▫log \s [<уровень>] – установить/просмотреть уровень детализации журнала. При запуске с ключом \s без указания уровня выводится текущий уровень детализации. Допустимые значения уровня детализации: ALL, DEBUG3, DEBUG2, DEBUG1, DEBUG, TRACE3, TRACE2, TRACE1, TRACE, INFO, NOTICE, WARNING, ERROR, CRIT.

•lua <скрипт> – выполнить заданный LUA-скрипт.

•mallopt <параметр> – задать настройки распределения памяти. Для задания конкретной настройки используйте дополнительные команды. Для уточнения списка дополнительных команд, можете вызвать справку при помощи команды ? mallopt.

Для получения подробностей по особенностям параметров данной команды, ознакомьтесь с описанием функции mallopt() из библиотеки glibc. Для получения справки по данной функции можете воспользоваться, например, командой man mallopt.

•memory <параметр> – показать статистику использования памяти компьютера, на котором установлен Сервер. Для запроса конкретного параметра используйте следующие команды:

▫all – вывести всю информацию и статистические данные,

▫heap – вывести информацию по динамической памяти,

▫malloc – вывести статистику по размещению памяти,

▫sizes – вывести статистику по размерам размещаемой памяти,

▫system – вывести информацию по системной памяти.

•monitoring <режим> – установить/посмотреть режим мониторинга использования ресурсов CPU (ключ cpu <параметр>) и ввода/вывода (ключ io <параметр>) процессом Сервера. Допустимые команды:

▫disable – отключить мониторинг,

▫enable – включить мониторинг,

▫show – показать текущий режим.

•printstat – записать статистику работы Сервера в журнал.

•reload – перезагрузить расширение Dr.Web Server FrontDoor.

•repository <параметр> – управление репозиторием. Для запроса конкретной функции используйте следующие команды:

▫all – вывести список всех продуктов репозитория и количество всех файлов по продуктам,

▫clear – очистить содержимое кэша, вне зависимости от значения TTL размещенных в кэше объектов,

▫fill – разместить все файлы репозитория в кэше,

▫keep – хранить все файлы репозитория, находящиеся в кэше в данный момент, всегда, вне зависимости от их значения TTL,

▫loaded – вывести список всех продуктов репозитория и количество всех файлов по продуктам, находящимся в кэше в данный момент,

▫reload – перезагрузить репозиторий с диска,

▫statistics – показать статистику обновлений репозитория.

•restart – перезапустить Сервер.

•show <параметр> – показать информацию о системе, на которой установлен Сервер. Для задания конкретного параметра, используйте дополнительные команды. Для уточнения списка дополнительных команд, можете вызвать справку при помощи команды ? show.

•sql <запрос> – выполнить заданный SQL-запрос.

•stop – остановить Сервер.

•traffic <параметр> – показать статистику по сетевому трафику Сервера. Для запроса конкретного параметра используйте следующие команды:

▫all – показать весь объем трафика с начала работы Сервера.

▫incremental – показать приращение трафика относительно последнего запуска команды traffic incremental.

▫last – показать изменение трафика с последней фиксированной точки.

▫store – создание фиксированной точки для ключа last.

•update <параметр> – получение информации и управление обновлениями. Для запроса конкретной функции используйте следующие ключи:

▫active – показать список Агентов, осуществляющих обновление в данный момент.

▫agent [<режим>] – показать/установить режим обновления Агентов с Сервера. При запуске без дополнительных параметров показывает текущий режим. Для установки режима используйте следующие дополнительные ключи:

▪on – включить обновления Агентов.

▪off – отключить обновления Агентов.

▫gus – запустить обновление репозитория с ВСО вне зависимости от состояния процесса обновления с ВСО.

▫http [<режим>] – показать/установить режим обновлений репозитория Сервера с ВСО. При запуске без дополнительных параметров показывает текущий режим. Для установки режима используйте следующие дополнительные ключи:

▪on – включить обновления репозитория с ВСО.

▪off – отключить обновления репозитория с ВСО.

▫inactive – показать список Агентов, которые не осуществляют обновление в данный момент.

▫track [<режим>] – показать/установить режим отслеживания обновлений Агентов. При запуске без дополнительных параметров показывает текущий режим. Для установки режима используйте следующие дополнительные команды:

▪on – включить отслеживание обновлений Агентов.

▪off – отключить отслеживание обновлений Агентов. При этом ключ update active не будет выводить список обновляемых Агентов.