H3.8. スイッチについての説明

クロスプラットフォームなスイッチ

-activation-key=<license_key> - Serverのライセンスキーです。デフォルトではルートフォルダのetcサブフォルダ内にあるenterprise.keyファイルです。

Serverのライセンスキーファイルは、バージョン10以降は使用されません。-activation-keyスイッチは以前のバージョンからのServerアップグレード中またはデータベース初期化の際に使用される場合があります。Server IDは指定されたライセンスキーから取得されます。

-bin-root=<folder> - 実行ファイルへのパスです。デフォルトはルートフォルダのbinサブフォルダです。

-conf=<folder> - Server設定ファイルの名前と場所です。デフォルトはルートフォルダのetcサブフォルダ内にあるdrwcsd.confファイルです。

-daemon - Windowsプラットフォームではサービスとしての起動を意味し、UNIXプラットフォームでは「プロセスをデーモンにする」(ルートフォルダに行くために、ターミナルとの接続を切りバックグラウンドで動作します)を意味します。

-db-verify=on - Server起動時にデータベースの整合性をチェックします。これはデフォルトの値です。データベースをdrwcsd verifydb命令によってチェックした直後に起動する場合を除いては、このデフォルト値の明示的な逆の値で起動することは推奨できません。上を参照してください。

-help - ヘルプを表示します。上のプログラムと同じです。

-hooks - Serverに対し、Serverインストールフォルダの以下のサブフォルダにあるユーザー拡張子スクリプトの使用を許可します。

Windows OS:var\extensions

FreeBSD OS:/var/drwcs/extensions

Linux OS:/var/opt/drwcs/extensions

Serverインストールフォルダのサブフォルダに置かれています。これらのスクリプトは管理者の作業を自動化し、タスクをより速く実行できるようにします。デフォルトでは全てのスクリプトは無効です。

-home=<folder> - サーバーインストールフォルダ(ルートフォルダ)。このフォルダの構造については『インストールマニュアル』の「Dr.Web Server for Windows OSをインストールする」を参照してください。デフォルトでは、起動時の現在のフォルダです。

-log=<log_file> - 指定したパスのファイルへのロギングを有効にします。

UNIX系OSのServerでは、ファイル名の代わりに「 -(マイナス)」記号を使用できます。これにより、ログの標準出力を指示します。

デフォルト:Windows OSでは-var-rootスイッチにより指定されるフォルダ内のdrwcsd.log、UNIX系OSでは、-syslog=userにより設定されます(以下参照)。

-private-key=<private_key> - Serverのプライベート暗号化キーです。デフォルトは、ルートフォルダのetcサブフォルダにあるdrwcsd.priです。

-rotate=<N><f>,<M><u> - Serverのログローテーションモードです。

パラメータ

説明

<N>

ログファイルの合計数(カレントログファイルおよびアーカイブを含む)

<f>

ログファイルの保存フォーマット。可能な値は次のとおりです。

z (gzip) – ファイルを圧縮します。デフォルトで使用されます。

p (plain) – ファイルを圧縮しません。

<M>

<u> 値に応じて、ログファイルのサイズまたはローテーション時間

<u>

単位、可能な値:

ログファイルサイズに応じてローテーションを設定する場合:

k - Kb

m - Мb

g - Gb

時間に応じてローテーションを設定する場合:

H - 時間

D - 日

W - 週

時間に応じたローテーションが設定されている場合、同期はコマンド実行時間とは関係なく行われます。同期は、値にHが指定されている場合は1時間の初めに、Dが指定されている場合は1日の初めに、Wが指定されている場合は1週間の初め(月曜日の00:00)に、<u>パラメータで指定された頻度で実行されます。

基準となる日時は1年1月1日UTC+0です。

デフォルトでは10,10mで、圧縮を使ってそれぞれ10メガバイトのファイルを10個保存するという意味になります。または、「ローテーションを使用しません。常に、サイズに制限のない同じファイルに書き込みます」という意味のnoneフォーマット(-rotate=none)を使うこともできます。

ローテーションモードではログファイルの名前はfile.<N>.log or file.<N>.log.dz のようになります。<N>は1、2などの連続する数です。

例として、ログファイルの名前がfile.log(上の–logスイッチ参照)に設定されているとします。

file.log - 現在のログファイル

file.1.log - 前回のログファイル

file.2.log等 - 数字が大きいほど古いバージョンのファイルです。

-trace - エラーが発生した場所を特定するためのログを作成します。

-var-root=<folder> - Serverが書き込み権限を持ち、変更されたファイル(ログやリポジトリファイルなど)の保存場所として指定されたフォルダへのパスです。デフォルトではルートフォルダのvarサブフォルダです。

-verbosity=<level> - ログの詳細レベルです。デフォルトはWARNINGです。許可された値は、ALLDEBUG3DEBUG2DEBUG1DEBUGTRACE3TRACE2TRACE1TRACEINFONOTICEWARNINGERRORCRIT です。ALL値とDEBUG3値はシノニムです。

必要に応じて、次のフォーマットで複数のメッセージソースに対して特定の詳細レベルを一度に設定することが可能です:

-verbosity=<message_source1>:<level1>,<message_source2>:<level2>,<message_source3>:<level3> など。この場合、<level> は一般的な原則で継承されます(指定された詳細レベルを持つ、最も近い親ソースを探します)。-verbosity=all:all スイッチは -verbosity=all スイッチと同じです 付録K. ログファイルフォーマット も参照)。

このキーは、続く-logキー(上参照)によって設定されるログの詳細レベルを定義します。1つの命令にこの種類のスイッチを複数含むことができます。

 

-verbosityおよび-logスイッチは相対配置です。

これらのパラメータを同時に使う場合、-verbosityスイッチを-logスイッチの前に設定します。-verbosityスイッチは、フォルダ内にあり次のスイッチ内で指定されるログの詳細レベルを再定義します。

Windows OSでのみ使用可能なスイッチ

-minimized - (サービスとしてではなく、インタラクティブモードで起動している場合はWindowsのみ)- ウィンドウを最小化します。

-service=<service_name> - このスイッチは、Serverサービスのレジストリ部のSelf-Protectionを自己識別して有効にするために、実行中のサービスプロセスにより使われます。<service_name>はサービスのデフォルト名の後に付けられるサフィックスです。この場合、サービスの完全な名前は「DrWebES-<service_name>」になります。

このスイッチはinstallコマンドで使われます。単独では使用できません。

-screen-size=<size> - (サービスとしてではなく、インタラクティブモードで起動している場合はWindowsのみ) - Serverスクリーンに表示されるログの、ラインでのサイズ。デフォルトの値は1000です。

UNIX系OSでのみ使用可能なスイッチ

-etc=<path> - etcディレクトリへのパスです(<var>/etc)。

-keep - Serverのインストール後に一時ディレクトリを削除しません。

-pid=<file> - Serverがそのプロセス識別子を書き込むファイルです。

-syslog=<mode> - システムログヘのロギングを命令します。可能なモード:authcrondaemonkernlprmailnewssysloguseruucplocal0local7(および、いくつかのプラットフォームにはftpauthpriv

-syslogおよび-logキーは一緒に使用されます。Serverを-syslogキー(例:service drwcsd start -syslog=user)で起動する場合、そのServerは-syslogキーの指定された値、および-logキーのデフォルト値で動作します。

-user=<user>-group=<group> - ルートユーザーによって起動している場合に、UNIX OSでのみ使用可能です。プロセスのユーザーまたはグループを変更し、指定されたユーザー(またはグループ)のパーミッションで実行することを意味します。