H7.4. Dr.Web Serverリモートスクリプタブル診断ユーティリティ

Dr.Web Serverリモート診断ユーティリティでは、リモートでDr.Web Serverに接続し、基本的な管理と動作の統計表示ができます。drwcntlとは異なり、drwcmdユーティリティは、スクリプト作成時に使用できます。

次のコンソールバージョンのDr.Web Serverリモートスクリプタブル診断ユーティリティが提供されています。

実行ファイル

位置情報

説明

drweb-cmd-<OS>-<bitness>

Control Center、管理 → ユーティリティ セクション

個々のバージョンのユーティリティ。任意のディレクトリから、または対応するオペレーティングシステムが搭載されたコンピューターで起動できます。

webmin/utilities Serverディレクトリ

drwcmd

bin Serverディレクトリ

ユーティリティのバージョンはサーバーのライブラリに依存します。保存先のディレクトリからのみ起動できます。

drweb-cmd-<OS>-<bitness>drwcmdのバージョンのユーティリティは機能が似ています。さらにこのセクションでは、drwcmdのバージョンが示されていますが、全ての例が両バージョンに関連します。

Serverリモート診断ユーティリティに接続するには、Dr.Web Server FrontDoorプラグインを有効にする必要があります。これを行うには、Dr.Web Server設定 セクションの モジュール タブで、Dr.Web Server FrontDoorプラグイン フラグを設定します。

 

Serverリモート診断ユーティリティに接続するには、ユーティリティ経由で接続する管理者が 追加機能を使用 権限を持っている必要があります。そうでない場合、リモート診断ユーティリティ経由でServerにアクセスすることはできません。

Dr.Web Serverリモート診断ユーティリティへのServerの接続設定については、管理者マニュアルDr.Web Serverのリモートアクセスを参照してください。

スタート命令フォーマット

drwcmd [<switches>] [<files>]

使用可能なスイッチ

drwcmdユーティリティは付録H. Dr.Web Enterprise Security Suite に含まれるプログラムのコマンドラインパラメータに記載の一般的な規則に従ってスイッチを使用します。

--? - ユーティリティ使用のスイッチに関するヘルプを表示します。

--help - ユーティリティ使用のコマンドに関するヘルプを表示します。

--commands=<commands> - (drwcntlユーティリティコマンドと同様の)指定したコマンドを実行します。複数のコマンドを指定するには、「;」記号を区切り文字として使用します。

--debug=yes|no - デバッグモード(stderr標準出力ストリーム)でユーティリティ操作をログ記録します。デフォルトはnoです。

--files=yes|no - 指定したファイルから(drwcntlユーティリティコマンドと同様に)コマンドを実行できます。デフォルトはyesです。

コマンドはファイル内で1行に1つずつ設定する必要があります。空行は無視されます。コメントを開始するには「#」記号を使用してください。

--keep=yes|no - 最後のコマンドが実行された後、ユーティリティプロセスが完了するまで、Serverとの接続を維持します。デフォルトはnoです。

--output=<file> - Server応答の出力ファイル。ファイルが指定されていない場合、デフォルトでは、stdout標準出力ストリームが使用されます。

ファイル名が「+」で始まる場合、コマンドの実行結果がファイルの最後に追加されます。そうでない場合はファイルが書き換えられます。

--password=<password> - Serverでの認証用パスワード。--resourceスイッチのファイルセットで定義できます。

--read=yes|no - リソースファイルからのServer接続パラメータの読み取りを許可します。デフォルトはyesです。

--resource=<file> - Server接続パラメータ(Serverのアドレスと、Serverでの認証用の管理者認証情報)のリソースファイル。デフォルトでは、drwcmdrcファイルは以下のディレクトリから使用されます。

UNIX系OSの場合:$HOME

Windows OSの場合:%LOCALAPPDATA%

ファイルの各行は、<Server> <user> <password>のようにスペースで区切られた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

--resourceスイッチを使用する場合は、--serverスイッチも指定する必要があります。ユーティリティは、リソースファイル内のこのServerのアドレスに対応する認証情報に従って、--serverスイッチで指定されたServeに接続します。

--server=<Server> - Serverのアドレス。デフォルトはssl://127.0.0.1です。--resourceスイッチのファイルセットで定義できます。

--user=<user> - Serverでの認証用ユーザー名。--resourceスイッチのファイルセットで定義できます。

--verbose=yes|no - Serverの詳細応答を印刷する(stdout標準出力ストリーム)。デフォルトはnoです。

Serverに接続する手順は次のとおりです。

1.Server接続のデータを定義するとき、--server--user--passwordスイッチで指定された値に優先順位が与えられます。

2.--serverスイッチが指定されていない場合は、デフォルト値であるssl://127.0.0.1が使用されます。

3.--userスイッチが指定されていない場合は、.drwcmdrcファイル(--resourceスイッチで再定義可能)で必要なServerが検索され、アルファベット順で最初のユーザー名が使用されます。

4.--passwordスイッチが指定されていない場合は、drwcmdrcファイル(--resourceで再定義可能)でServerとユーザー名の検索が実行されます。

--readで禁止されていない場合、ユーザー名とパスワードはdrwcmdrcファイル(--resourceスイッチで再定義可能)から読み込まれます。

5.ユーザー名とパスワードがスイッチファイルまたはリソースファイルで指定されていない場合、ユーティリティはコンソールで認証情報を入力するよう求めます。

コマンド実行機能は次のとおり。

ファイルにコマンドで「-」値が設定されている場合、ユーティリティはコンソールで入力されたコマンドを読み取ります。

--commandsスイッチのコマンドとファイルリストのコマンドの両方が設定されている場合、--commandsスイッチのコマンドが最初に実行されます。

--commandsスイッチのコマンドのいずれのファイルも指定されていない場合、コンソールから入力されたコマンドが読み込まれます。

例:

--commandスイッチからコマンドを実行してからコンソールコマンドを実行するには、次のように入力します。

drwcmd --commands=<commands> -- -

完了コード

0 - 実行成功。

1 - スイッチのヘルプが要求されています。--helpまたは--?

2 - コマンドライン解析エラー。認証パラメータが指定されていない、など。

3 - Server応答の出力ファイルを作成できません。

4 - Serverの認証エラー。管理者のログイン情報および/またはパスワードが正しくありません。

5 - Server接続が異常終了しました。

127 - 不明な致命的エラー。