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

Dr.Web Serverリモート診断ユーティリティは、動作に関する統計を管理・確認するためにリモートでDr.Web Serverに接続することを可能にします。drwcntl とは異なり、drwcmd ユーティリティはスクリプト作成時に使用できます。

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

実行ファイル

位置情報

説明

drweb-cmd-<OS>-<bitness>

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

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

webmin/utilities Dr.Web Serverディレクトリ

drwcmd

bin Dr.Web Serverディレクトリ

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

drweb-cmd-<OS>-<bitness>drwcmd のバージョンのユーティリティは類似した機能を持っています。このセクションでは、drwcmd のバージョンについて記載していますが、すべての例が両バージョンに当てはまります。

Dr.Web Serverリモート診断ユーティリティに接続するには、Dr.Web Server FrontDoorプラグインを有効にする必要があります。Dr.Web Server設定 セクションの モジュール タブで、Dr.Web Server FrontDoorプラグイン にチェックを入れてください。

 

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

Dr.Web Serverリモート診断ユーティリティへのDr.Web Serverの接続設定については、管理者マニュアル付録J. ログファイルフォーマット を参照してください。

コマンドフォーマット

drwcmd [<switches>] [<files>]

使用可能なスイッチ

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

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

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

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

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

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

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

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

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

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

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

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

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

UNIX系OSの場合:$HOME

Windows OSの場合:%LOCALAPPDATA%

ファイルの各行は、<Dr.Web_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 スイッチも指定する必要があります。ユーティリティは、リソースファイル内のこのDr.Web Serverのアドレスに対応する認証情報に従って、--server スイッチで指定されたDr.Web Serverに接続します。

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

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

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

--version - ユーティリティのバージョンを表示します。

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

1.Dr.Web Server接続のデータを定義する際、--server--user--password スイッチで指定された値が優先されます。

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

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

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

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

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

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

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

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

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

例:

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

drwcmd --commands=<commands> -- -

完了コード

0 - 実行成功。

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

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

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

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

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

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