OpenWBEM CIMOM(owcimomd)を起動すると、openwbem.confファイルからランタイム設定が読み込まれます。openwbem.confファイルは、/etc/openwbemディレクトリにあります。
オプションがセミコロン(;)、またはシャープ記号(#)でコメントアウトされている設定では、デフォルト設定が使用されます。
このファイルに変更を加える場合は、使用するプラットフォームにネイティブな形式でファイルを保存するテキストエディタを使用できます。
openwbem.confファイル中の任意の設定を変更することができます。ここでは、次の環境設定について説明していきます。
認証設定を変更する場合、制御可能な項目がいくつかあります。
CIMOMにアクセスできるユーザ
使用する認証モジュール
以下の設定を参照してください。
ローカルシステムのファイルのパーミッションによって、パスワードなしでローカル認証を許可するよう、http_serverに指示します。
この設定と、[Basic]または[Digest]の設定を併用することができます。
http_server.allow_local_authentication =
option
http_server.allow_local_authentication = true
パスワードファイルの場所を指定します。http_server.use_digestを有効にしている場合、この設定が必要になります。
http_server.digest_password_file =
path_filename
ダイジェストパスワードファイルの、デフォルトのパスとファイル名を以下に示します。
/etc/openwbem/digest_auth.passwd
http_server.digest_password_file = /etc/openwbem/digest_auth.passwd
SSLクライアント証明書を使って、サーバにクライアントの認証を行わせるかどうかを指定します。
デフォルトでは、この設定は無効にされています。
http_server.ssl_client_verification =
option
http_server.ssl_client_verification = disabled
OpenSSLトラストストアのあるディレクトリを指定します。
http_server.ssl_trust_store =
path
トラストストアファイルのデフォルトパスを以下に示します。
/etc/openwbem/truststore
http_server.ssl_trust_store =
/etc/openwbem/truststore
HTTPサーバに、ダイジェスト認証の使用を指示します。基本(Basic)認証機構はバイパスされます。ダイジェスト認証を使用するには、owdigestgenpassを使ってダイジェストパスワードファイルを設定する必要があります。
ダイジェスト認証の場合、owcimomd.authentication_moduleに指定された認証モジュールは使われません。
http_server.use_digest =
option
http_server.use_digest = false
owcimomdによって維持されるすべてのネームスペース内のすべてのCommon Information Model (CIM) データにアクセスするユーザのユーザ名を指定します。このユーザ名は、すべてのACLユーザ権限が保管される/root/securityネームスペースの管理に使用します。
ACL処理は、OpenWBEM_Acl1.0.mofファイルがインポートされない限り、有効になりません。
owcimomd.ACL_superuser =
username
owcimomd.ACL_superuser = root
owcimomdへの匿名(Anonymous)ログインを有効、または無効にします。
owcimomd.allow_anonymous =
option
owcimomd.allowed_anonymous = false
owcimomdデータへのアクセスを許可する一連のユーザを指定します。
owcimomd.allowed_users =
option
owcimomd.allowed_users = bcwhitely jkcarey jlanderson
http_server.SSL&lowbarcertおよびhttp_server.SSL&lowbarkey設定には、ホストの秘密鍵と証明書を含むファイルの場所を指定します。この秘密鍵と証明書は、OpenSSLがHTTPS通信を行う場合に使用されます。
デフォルトでは、.pemファイルは以下の場所に格納されています。
/etc/openwbem/servercert.pem
/etc/openwbem/serverkey.pem
http_server.SSL_cert =
path_filename
または
http_server.SSL_key =
path_filename
![]() | |
鍵と証明書の両方を同じファイルに保管することができます。この場合、http_server.SSL_certとhttp_server.SSL_keyの値は同じになります。 | |
http_server.SSL_cert = /etc/openwbem/servercert.pem
http_server.SSL_key = /etc/openwbem/servercert.pem
http_server.SSL_key = /etc/openwbem/serverkey.pem
http_server.http&lowbarportおよびserver.https_port設定には、owcimomdがすべてのHTTP/HTTPS通信のために待機するポート番号を指定します。
http_server.http_port = option
または
http_server.https_port =
option
|
オプション |
説明 |
|---|---|
|
|
HTTPまたはHTTPS通信を行うための特定のポートを指定します。 HTTPの場合、デフォルトのポートは5988です。 HTTPSの場合、デフォルトのポートは5989です。 |
|
-1 |
HTTP接続、またはHTTPS接続を無効にします(HTTPS接続のみをサポートする場合など)。 |
|
0 |
実行時に動的にポート番号を割り当てます。 |
HTTPポートを無効にして、HTTPS通信用のポート5989を有効にする設定を以下に示します。
http_server.http_port = -1
http_server.https_port = 5989
owcimomd.confファイルの次のログ設定で、ログを記録する場所、頻度、およびエラータイプ、ログのサイズ、ファイル名および形式を指定できます。
デバッグログの記録を設定する場合は、11.2.5項 「デバッグログの設定」を参照してください。
他のログを設定する場合は、11.2.6項 「他のログの設定」を参照してください。
ログ出力のカテゴリを指定します。
log.main.categories =
option
|
オプション |
説明 |
|---|---|
|
|
記録するカテゴリを、スペースで区切って指定します。 owcimomdで利用できるカテゴリを以下に示します。
これらのオプションの詳細については、11.2.4.4項 「log.main.level」を参照してください。 このオプションに指定した場合、あらかじめ定義されているカテゴリはレベルとして扱われずに、それぞれ独立したカテゴリとして処理されます。デフォルト値はありません。カテゴリが設定されていない場合、いずれのカテゴリも記録されず、log.main.levelの設定が使用されます。 |
|
* |
すべてのカテゴリを記録します。 デフォルトの設定です。 |
log.main.categories = FATAL ERROR INFO
ログが出力するコンポーネントを指定します。
log.main.components =
option
|
オプション |
説明 |
|---|---|
|
|
記録するコンポーネント(owcimomdなど)を指定します。複数を指定する場合は、スペースで各コンポーネントを区切ります。 プロバイダは、独自のコンポーネントを使用できます。 |
|
* |
すべてのコンポーネントを記録することを指定します。 デフォルトの設定です。 |
log.main.components = owcimomd nssd
ログメッセージの形式(printf()スタイル変換指定子が混在するテキスト)を指定します。
log.main.format =
conversion_specifier
フィールドの最小幅、最大幅、および位置揃えを調整することができます。書式変更子(オプション)は、パーセント記号(%)と変換文字の間に指定します。最初の書式変更子マイナス記号(-)は、左揃えを指示します。その次に、フィールドの最小幅を指定する場合は、出力する最小文字数を表す整数を書式変更子として指定します。表示するデータの文字数がこれより少ない場合は、位置揃えの指定に応じてフィールドの左または右が、スペースで埋められます。表示するデータの文字数がフィールドの最小幅よりも多い場合は、そのデータ全体を表示できるように、フィールドが拡張されます。
フィールドの最大幅を指定するには、ピリオドに続けて(.)10進定数を指定します。データの文字数がフィールドの最大幅よりも大きい場合、超過する文字数分の文字がデータの先頭から(デフォルト)、またはデータの最後から(左揃えが指定されている場合)切り捨てられます。
Log4j TTCCレイアウト:
"%r [%t] %-5p %c - %m"
固定サイズがある以外はTTCCに類似しているフィールド:
"%-6r [%15.15t] %-5p %30.30c - %m"
log4j.dtd 1.2に準拠し、Chainsawで処理可能なXML出力(実際に使用する場合は1行でなければなりませんが、ここでは見やすくするために行を分けています)。
"<log4j:event logger="%c" timestamp="%d{%s%Q}" level="%p" thread="%t"> <log4j:message>%e</log4j:message> <log4j:locationInfo class="" method="" file="%F" line="%L"/></log4j:event>"
デフォルトを以下に示します。
log.main.format = [%t]%m
ログ出力のレベルを指定します。レベルを設定した場合、指定したレベル以上にある、あらかじめ定義されているすべてのカテゴリが、ログに出力されます。
log.main.level =
option
log.main.level = ERROR
log.main.type設定オプションで、ログをファイルに送信するように指定されている場合、owcimomdログファイルが使用する場所を指定します。
log.main.location =
path_filename
log.main.location = /system/cimom/var/owcimomd.log
記録を保持するバックアップログの量を指定します。この量を超えた場合は、最も古いバックアップログが消去されます。
log.main.backup_index =
option
|
オプション |
説明 |
|---|---|
|
|
保持するバックアップログ数を指定します。 デフォルトは1です。 |
|
0 |
バックアップログは作成されず、最大ファイルサイズに達したログは切り捨てられます。 |
log.main.max_backup_index = 1
owcimomdがデバッグモードで起動している場合、次の設定でデバッグログがアクティブになります。
log.debug.categories = *
log.debug.components = *
log.debug.format = [%t] %m
log.debug.level = *
log.debug.type = stderr
追加ログを作成するには、次の設定でログ名のリストを作成します。
owcimomd.additional_logs =
logname
複数のログ名を指定する場合は、間をスペースで区切ります。
owcimomd.additional_logs =
logname
各ログに対して、以下の設定が適用されます。
ログ.
log_name.categories
ログ.
log_name.components
ログ.
log_name.format
ログ.
log_name.level
ログ.
log_name.location
ログ.
log_name.max_backup_index
ログ.
log_name.max_file_size
owcimomd.additional_logs = errorlog1 errorlog2 errorlog3