Sun ロゴ      前へ      目次      索引      次へ     

Sun ONE Application Server 7, Enterprise Edition 管理者用設定ファイルリファレンス

第 5 章
その他の設定ファイル

本章では、他の章では触れていない重要な設定ファイルを対象に、その目的と場所、内容や構文を要約し、各ファイルで使用できるすべての指令とパラメータを含めて、表形式で簡潔に説明しています。他の章またはマニュアルに指令やパラメータの詳細な説明がある場合、関連項目の見出しの後に相互参照を示します。変更してはならない設定ファイルはこの章のリストには記載されていません。

次の設定ファイルをアルファベット順に示します。


dbswitch.conf

目的

Sun ONE Application Server が使用する LDAP ディレクトリを指定します。


注

dbswitch.conf インタフェースは、不確定です。不確定なインタフェースは試験的または一時的なインタフェースであるため、次のリリースで互換性がなくなったり、削除されたり、または安定したインタフェースに置き換えられたりする場合があります。


場所

instance_dir/config

構文

directory name LDAP_URL
name
:property1 [value1]
name:property2 [value2]
...

このファイルのデフォルトの内容は次のとおりです。

directory default null:///none

SSL を介して匿名バインドを実行するには、ファイルを次のように編集します。

directory default ldaps://directory.sun.com:636:/dc%3Dcom

SSL を介さないで匿名バインドを実行するには、ファイルを次のように編集します。

directory default ldap://directory.sun.com:389:/dc%3Dcom

関連項目

「ユーザーデータベースの選択」

次の表に、dbswich.conf ファイルのプロパティを示します。

表 5-1 dbswitch.conf のプロパティ 

プロパティ

許容値

デフォルト値

説明

nsessions

正の整数

8

データベースへの LDAP 接続の数

dyngroups

off、on、recursive

on

ダイナミックグループの処理方法を決定。off の場合、ダイナミックグループはサポートされない。on の場合、ダイナミックグループはサポートされる。recursive の場合、ダイナミックグループにほかのグループを含めることができる

binddn

有効な DN

 

データベースへの接続に使用する DN。binddn と bindpw の両方がない場合、バインドは匿名

bindpw

 

 

データベースへの接続に使用するパスワード。binddn と bindpw の両方がない場合、バインドは匿名

dcsuffix

有効な DN (LDAP URL と関連して)

なし

指定した場合、要求の仮想サーバーの基本 DN のデフォルト値は、仮想サーバーの host 属性のうち、クライアントの提供する Host ヘッダと一致する属性の dcsuffix DN で始まる DC ツリー検索で決定される。host 属性が 1 つも一致しない場合、親 http-listener の server-name 属性が使われる

指定しない場合、基本 DN のデフォルト値は LDAP URL での base DN 値

server.xml ファイルの auth-db 要素の basedn 属性は、この値に優先する

digestauth

off、on

off

データベースがダイジェスト認証できるかどうかを指定する。on の場合、特別なディレクトリサーバープラグインが必要。このプラグインのインストール方法の詳細については、『Sun ONE Application Server 管理者ガイド』を参照

LDAP データベースがスキーマに準拠している場合、クライアントの提供する Host ヘッダーと一致するvirtual-server 要素の host 属性の DC ツリー検索を使って、アクセスの基本 DN が計算されます。host 属性が 1 つも一致しない場合、親 http-listener の server-name 属性が使われます。検索結果には、基本 DN を含む inetDomainBaseDN 属性が含まれている必要があります。この基本 DN は、そのまま取得され、いずれの基本 DN 値とも関連がありません。


配備記述子

目的

配備されたモジュールおよびアプリケ−ションに対応した Sun ONE Application Server の機能を設定します。

場所

モジュールまたはアプリケーションの META-INF または WEB-INF ディレクトリ

関連項目

次の表は、Sun ONE Application Server 配備記述子についての詳細情報の参照先を示しています。

表 5-2 Sun ONE Application Server 記述子 

配備記述子

詳細情報の参照先

sun-application.xml

『Sun ONE Application Server Developer's Guide』

sun-web.xml

『Sun ONE Application Server Developer's Guide to Web Applications』

sun-ejb-jar.xml および sun-cmp-mapping.xml

『Sun ONE Application Server Developer's Guide to Enterprise JavaBeans Technology』

sun-application-client.xml および sun-acc.xml

『Sun ONE Application Server Developer's Guide to Clients』

sun-ra.xml

『Sun ONE J2EE CA Service Provider Implementation Administrator's Guide』


generated.instance.acl

目的

サーバーインスタンスへのアクセス権を設定します。これはデフォルトの ACL ファイルですが、ユーザーが作成したりほかのファイルを使うこともできます。


注

ACL ファイルインタフェースは、不確定です。不確定なインタフェースは試験的または一時的なインタフェースであるため、次のリリースで互換性がなくなったり、削除されたり、または安定したインタフェースに置き換えられたりする場合があります。


場所

instance_dir/config

関連項目

『Sun ONE Application Server セキュリティ管理者ガイド』


loadbalancer.xml

目的

クラスタとロードバランスの設定を行います。


注

loadbalancer.xml インタフェースは不確定です。不確定なインタフェースは試験的または一時的なインタフェースであるため、次のリリースで互換性がなくなったり、削除されたり、または安定したインタフェースに置き換えられたりする場合があります。


場所

loadbalancer.xml ファイルは、フロントエンドの Web サーバーにあります。

構文

ほとんどのファイルは、要素が入れ子になった、次のような基本的な XML 構文で記述されています。

<ELEMENT attribute="value" attribute="value" ... >
   <SUBELEMENT attribute="value" attribute="value" ... />
</ELEMENT>

「loadbalancer.xml の要素と属性」の表では、属性と区別しやすいように要素を太字で表記しています。

関連項目

『Sun ONE Application Server 管理者ガイド』

Sun ONE Web Server マニュアルセット

次の表では、loadbalancer.xml ファイルの要素、属性、およびプロパティについて説明します。

表 5-3 loadbalancer.xml の要素と属性 

要素 / 属性

サブ要素またはデフォルト値

説明

loadbalancer

cluster、property

ロードバランサを定義する

cluster

instance、web-module、health-checker

アプリケーションサーバーインスタンスのクラスタを定義する

  name

なし

クラスタの名前を指定する。クラスタ名はロードバランサ内で一意でなければならない

instance

なし

アプリケーションサーバーインスタンスを定義する

  name

なし

サーバーインスタンスの名前を指定する。インスタンス名はクラスタ内で一意でなければならない

  enabled

true

(省略可能) インスタンスがロードバランスを適用される要求に対してアクティブ (有効) かどうかを指定する

  disable-timeout-in-minutes

31

(省略可能) 休止状態のタイムアウト間隔を指定する。この間隔で、ロードバランサはインスタンスを無効にし、アクティブな接続をすべて終了する

  listeners

なし

空白文字で区切ってインスタンスのリスナーの URL を指定する。リスナーの URL はクラスタ内で一意でなければならない

web-module

なし

Web モジュールを定義する

  context-root

なし

Web モジュールのコンテキストルートを指定する。コンテキストルートはクラスタ内で一意でなければならない

  enabled

true

(省略可能) Web モジュールがロードバランスを適用される要求に対してアクティブ (有効) かどうかを指定する

  disable-timeout-in-minutes

31

(省略可能) 休止状態のタイムアウト間隔を指定する。この間隔で、ロードバランサは Web モジュールを無効にし、アクティブな接続をすべて終了する

health-checker

なし

クラスタのヘルスチェッカーを設定する

  url

/

(省略可能) リスナーの状態を判断するため ping を実行する URL を指定する

  interval-in-seconds

30

(省略可能) インスタンスのヘルスチェックを行う間隔を指定する

  timeout-in-seconds

10

(省略可能) タイムアウト間隔を指定する。この間に応答が返されれば、リスナーは正常であると判断される

property

description

プロパティを定義する

  name

なし

プロパティの名前を指定する

  value

なし

プロパティの値を指定する

description

 

プロパティを説明するテキストを定義する

表 5-4 loadbalancer.xml のプロパティ 

プロパティ名

デフォルト値

説明

response-timeout-in-seconds

60

タイムアウト間隔を指定する。この間にロードバランス要求の応答が返されなければ、インスタンスの状態は悪いと判断される

reload-poll-interval-in-seconds

0

ロードバランサが loadbalancer.xml のタイムスタンプが変更されたかどうかをチェックする間隔を指定する。変更された場合、ロードバランサはファイルを再度読み込む。0 の場合、ポーリングは無効

https-routing

false

ロードバランサが着信 HTTPS 要求を HTTPS 要求としてインスタンスに配信するかどうかを指定する

require-monitor-data

false

ロードバランサの監視を有効にするかどうかを指定する


nsfc.conf

目的

ファイルキャッシュのパラメータを設定します。このファイルは、ファイルのキャッシュパラメータがデフォルトから変更されている場合にのみ存在します。


注

nsfc.conf インタフェースは、不確定です。不確定なインタフェースは試験的または一時的なインタフェースであるため、次のリリースで互換性がなくなったり、削除されたり、または安定したインタフェースに置き換えられたりする場合があります。


場所

instance_dir/config

構文

parameter=value

関連項目

『Sun ONE Application Server Performance Tuning Guide』

次の表に、nsfc.conf ファイルのパラメータを示します。

表 5-5 nsfc.conf のパラメータ 

パラメータ

許容値

デフォルト値

説明

FileCacheEnable

on、off

on

ファイルキャッシュを有効にする

CacheFileContent

on、off

on

MediumFileSizeLimit より小さい (TransmitFiles が on になっている場合は、SmallFileSizeLimit より小さい) ファイルについて、ファイル情報だけでなくファイルの内容のキャッシュも有効にする

MaxAge

秒数

30

有効なキャッシュエントリの最大生存期間。この設定は、ファイルがキャッシュされた後の、キャッシュされた情報の使用期間を制御する。MaxAge より古いエントリは、同じファイルの新しいエントリに置き換えられる

MediumFileSizeLimit

利用可能なメモリーサイズ

537600 (525K)

(UNIX のみ) TransmitFiles が off になっている場合に、メモリーマップファイルとしてキャッシュできる 1 つのファイルの最大サイズ

MediumFileSpace

利用可能なメモリーサイズ

10485760 (10M)

TransmitFiles が off になっている場合に、メモリーマップファイルとしてキャッシュされるファイルの合計サイズ

SmallFileSizeLimit

利用可能なメモリーサイズ

2048 (2K)

(UNIX のみ) メモリーに読み込めるファイルの最大サイズ

SmallFileSpace

利用可能なメモリーサイズ

1048576 (UNIX、1M)

メモリーに読み込まれるすべてのファイルの合計サイズ

TransmitFiles

on、off

off (UNIX)

TransmitFile システム呼び出しの使用を有効にする。IRIX、Compaq、Linux ではサポートされない

MaxFiles

 

1024

ファイルキャッシュ内の最大ファイル数

HashInitSize

利用可能なメモリーサイズ

0

ハッシュバケットの初期番号。0 の場合、ハッシュバケットの番号は 2 * MaxFiles + 1 として動的に決定される

TempDir

パス名

system_temp/instance

CopyFiles が on の場合、ファイルキャッシュの一時ディレクトリを指定する


password.conf

目的

デフォルトでは、アプリケーションサーバーの起動時に、管理者が SSL キーデータベースのパスワードを入力する必要があります。アプリケーションサーバーを人の介入なしで再起動できるようにするには、password.conf ファイルにパスワードを保存する必要があります。システムを充分にセキュリティ保護して、このファイルとキーデータベースが危険にさらされないようにする必要があります。

場所

instance_dir/config

デフォルトでは、このファイルは存在しません。必要な場合はファイルを作成する必要があります。

構文

PKCS#11_module_name:password

サーバーに付属している内部 PKCS#11 ソフトウェア暗号化モジュールを使用している場合には、次の情報を入力します。

internal:password

それ以外の PKCS#11 モジュールを (たとえばハードウェアの暗号化またはハードウェアアクセラータ用に) 使用している場合は、PKCS#11 モジュールの名前を指定し、続けて次のようにパスワードを入力する必要があります。

internal:password

関連項目

『Sun ONE Application Server 管理者ガイド』


server.policy

目的

アプリケーションがアクセスするリソースを制御します。これは 標準の J2SE ポリシーファイルです。

場所

instance_dir/config

構文

grant [codeBase "path"] {
   permission permission_class "package", "permission_type";
   ...
};

関連項目

『Sun ONE Application Server Developer's Guide』

http://java.sun.com/docs/books/tutorial/security1.2/tour2/index.html



前へ      目次      索引      次へ     


Copyright 2003 Sun Microsystems, Inc. All rights reserved.