H9.4. Dr.Web服务器脚本运行远程诊断工具

Dr.Web服务器远程诊断工具可远程连接Dr.Web服务器进行基本管理,并可查看运行统计信息。与drwcntl不同,工具drwcmd可用于运行脚本。

提供以下Dr.Web服务器脚本运行远程诊断工具控制台版本:

可执行文件

位置

描述

drweb-cmd-<操作系统>-<位数>

管理中心的管理→工具部分

为工具的独立版本。可从自定义目录启动,可用于相应操作系统的任一计算机。

服务器目录webmin/utilities

drwcmd

服务器目录bin

此工具版本取决于是否具备服务器库。只能从所在目录启动。

工具版本drweb-cmd-<操作系统>-<位数>drwcmd功能相同。以下介绍的是为drwcmd版本,但所有示例同样适用于另一版本。

连接服务器远程诊断工具必须启用插件Dr.Web Server FrontDoor。启用操作是在Dr.Web服务器配置模块标签勾选插件Dr.Web Server FrontDoor

 

连接服务器远程诊断工具要求管理员具备使用高级功能权限。否则会禁止管理员通过远程诊断工具访问服务器。

如何设置服务器来连接Dr.Web服务器远程诊断工具参见管理员手册远程访问Dr.Web服务器

启动命令格式:

drwcmd [<参数>] [<文件>]

可用参数

工具drwcmd参数使用原则遵循H1. 导言部分介绍的总体原则。

--?——显示参数说明文档。

--help——显示参数说明文档。

--commands=<指令>——执行指定的命令(与执行drwcntl工具指令类似)。可指定多个指令,用;隔开。

--debug=yes|no——以调试模式记录工具运行日志(输出标准线程stderr)。默认为no

--files=yes|no——允许从指定文件执行指令(与执行drwcntl工具指令类似)。默认为yes

在文件给出指令应为每行一个指令。空行忽略。注释开始可使用符合#

--keep=yes|no——支持在执行最后一个指令后并在工具结束运行前连接服务器。默认为no

--output=<文件>——用于输出服务器回应的文件。默认如未指定文件,使用标准输出线程stdout

如果文件名称以符合(+)开始,则指令执行结果会添加到文件结尾,否则文件将覆盖写入。

--password=<密码>——在服务器进行身份验证的密码。可在文件中参数--resource中给出。

--read=yes|no——允许从资源文件读取服务器连接参数。默认为yes

--resource=<文件>——资源文件,包含服务器连接参数:服务器地址和管理员在服务器进行身份验证的注册信息。默认使用文件.drwcmdrc,所在目录为:

UNIX家族操作系统:$HOME

OS Windows:%LOCALAPPDATA%

文件中每一行为空格隔开的3个词段:<服务器> <用户> <密码>

某词段中间的空格利用%S给出。百分符号则利用%P

例如:

ssl://127.0.0.1 user1 password1

ssl://127.0.0.1 user2 password2

ssl://127.0.0.1 user pass%Sword

--password=<密码>——服务器地址。默认为ssl://127.0.0.1。可在文件中参数--resource中给出。

--user=<用户>——在服务器进行身份验证的用户名。可在文件中参数--resource中给出。

--verbose=yes|no——输出服务器详细回应(输出标准线程stdout)。默认为no

连接服务器的流程:

1.启动服务器连接参数时优先的是参数值--server--user--password

2.如参数--server未给出,则使用默认地址——ssl://127.0.0.1

3.如参数--user未给出,则在文件.drwcmdrc(可在--resource另行指定)搜索所需服务器和字母排序最先的用户名。

4.如参数--password未给出,则在文件.drwcmdrc(可在--resource另行指定)按照服务器和用户名进行搜索。

将从文件.drwcmdrc(可在--resource另行指定)读取用户名和密码,如参数--read不禁止读取。

5.如没有通过参数或资源文件给出用户名和密码,工具则要求通过控制台输入登录账户。

执行指令的特点:

如指令文件为空值(-),则读取从控制台输入的指令。

如同时给出--commands指令和文件列表,则先执行在--commands给出的指令。

如没有给出--commands指令和文件列表,则读取从控制台输入的指令。

例如

如要先执行--command中的指令,然后执行控制台指令,需输入:

drwcmd --commands=<指令> -- -

运行结束码

0 – 已成功执行。

1 – 已调用参数帮助文档:--help--?

2 – 命令行解析出错:未给出身份认证参数等原因。

3 – 创建服务器回应输出文件时出错。

4 – 在服务器进行身份验证时出错н:管理员用户名和/或密码不正确。

5 – 与服务器的连接错误中断。

127 – 未能确定的致命错误。