Java 設定の編集

ここでは、選択した構成の Java 関連設定の編集に関係する手順について説明します。以下を参照してください。

• 「一般設定の編集」

• 「パス設定の編集」

• 「JVM 設定の編集」

• 「JVM オプションの編集」

• 「JVM プロファイラの追加」

• 「新しい JVM プロファイラの追加」

• 「Java 設定のデバッグ」

• 「JVM デバッグの有効化」

• 「リソース設定の編集」

• 「JDBC リソース」

• 「共通 JDBC ドライバ」

• 「JDBC リソースの追加」

• 「カスタムリソース」

• 「カスタムリソースの追加」

• 「カスタムリソースのプロパティー」

• 「外部 JNDI リソース」

• 「外部 JNDI リソースの追加」

• 「外部 JNDI リソースのプロパティー」

• 「メールリソース」

• 「新しいメールリソースの追加」

• 「メールリソースのプロパティー」

• 「サーバーのライフサイクル」

• 「新しいライフサイクルモジュールの追加」

• 「ライフサイクルモジュールの削除」

• 「ライフサイクルモジュールの編集」

• 「認証設定の編集」

• 「認証レルムの必須プロパティー」

• 「サーブレットコンテナ設定の編集」

• 「サーブレットコンテナのパラメータ」

• 「セッションレプリケーション設定の編集」

• 「セッションレプリケーションのパラメータ」

• 「SOAP 認証設定の編集」

• 「SOAP 認証プロバイダのパラメータ」

一般設定の編集

この節では、選択された構成で Java を有効にし、Java ホーム変数を設定できるようにします。

Java の一般設定の編集

1. 構成を選択します。

   構成のリストから構成を選択します。利用可能な構成のリストを取得するには、「構成」タブをクリックします。

2. 「Java」、「一般」タブの順にクリックします。

Java の一般設定のパラメータ

次の表では、Java の一般設定の設定時に利用可能なパラメータについて説明します。

表 23 フィールドの説明 > Java の一般設定

パス設定の編集

この節では、選択された構成の JVM クラスパスを追加できるようにします。

パス設定の編集

1. 構成を選択します。

   構成のリストから構成を選択します。利用可能な構成のリストを取得するには、「構成」タブをクリックします。

2. 「Java」、「一般」タブの順にクリックします。「パス設定」セクションに移動します。

パス設定のパラメータ

次の表では、構成の JVM パス設定の変更時に利用可能なパラメータについて説明します。

表 24 フィールドの説明 > パス設定

JVM 設定の編集

管理インタフェースで JVM コマンド行オプションを設定するには、次のタスクを実行します。

JVM 設定の編集

1. 構成を選択します。

   構成のリストから構成を選択します。リストを取得するには「構成」タブをクリックします。

2. 「Java」>「JVM 設定」タブをクリックします。

JVM オプションの編集

ここで値を指定することで、コマンド行 JVM オプションを追加/削除できます。JVM オプションを追加するには、「JVM オプションを追加」ボタンをクリックします。

JVM オプションの例を次にいくつか示します。 -Djava.security.auth.login.config=login.conf、-Djava.util.logging.manager=com.iplanet.ias.server.logging.ServerLogManager、および -Xms128m -Xmx256m

JVM プロファイラの追加

JVM プロファイラは、アプリケーションの最高レベルの安定性とスケーラビリティーを確実にするために、Java アプリケーションのパフォーマンスの問題、メモリーのリーク、マルチスレッドの問題、およびシステムリソース使用率の問題の診断と解決に役立ちます。

プロファイラを使用して、Sun Java System Web Server 上でリモートプロファイリングを実行し、サーバー側のパフォーマンスにおけるボトルネックを検出することができます。

新しい JVM プロファイラの追加

1. 構成を選択します。

   構成のリストから構成を選択します。利用可能な構成のリストを取得するには、「構成」タブをクリックします。

2. 「Java」>「JVM 設定」タブをクリックします。

3. 「プロファイラ」セクションの「新規」ボタンをクリックします。

4. 次の各パラメータの値を入力します。

   • 名前 — 新しい JVM プロファイラの簡易名を入力します。

   • 有効 — 実行時にプロファイラを有効にするかどうかを決定します。

   • クラスパス — プロファイラの有効なクラスパスを入力します。(省略可能)。

   • ネイティブライブラリパス — 有効なネイティブライブラリパスを入力します。(省略可能)。

   • JVM オプション — CLI の追加の JVM オプションを指定できます。

     例: —Xrunhprof:file=log.txt,options

     HPROF は Java 2 SE に付属している単純なプロファイラエージェントです。これは動的にリンクされたライブラリで、JVMPI (Java 仮想マシンプロファイラインタフェース) と対話し、ファイルまたはソケットに、ASCII またはバイナリ形式でプロファイリング情報を書き出します。この情報は、プロファイラのフロントエンドツールによってさらに処理することもできます。

     さまざまな商用プロファイラと、それらのオプションについては、『Sun Java System Web Server 7.0 Developer's Guide to Java Web Applications』を参照してください。

Java 設定のデバッグ

JVM はデバッグモードで起動でき、JPDA (Java Platform Debugger Architecture) デバッガと接続できます。デバッグを有効にすると、ローカルとリモートのデバッグがどちらも有効になります。

Sun Java System Web Server のデバッグは JPDA ソフトウェアに基づいています。デバッグを有効にするには、次のタスクを実行します。

JVM デバッグの有効化

1. 構成を選択します。

   構成のリストから構成を選択します。利用可能な構成のリストを取得するには、「構成」タブをクリックします。

2. 「Java」>「JVM 設定」タブをクリックします。

3. 「Java 設定のデバッグ」で「デバッグを有効にする」チェックボックスを選択します。

4. 必要であれば、「新規」ボタンをクリックして JVM オプションを入力します。

   デフォルトの JPDA オプションは次のとおりです。

   -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=7.0896

   
   

   代わりに suspend=y に使用すると、JVM は中断モードで起動され、デバッグが接続するまで中断された状態に保たれます。これは、JVM の起動後すぐにデバッグを開始したい場合に便利です。JVM をデバッガに接続するときに使用するポートを指定するには、address=port_number を指定します。デバッグオプションの一覧については、JPDA のドキュメントを確認してください。

リソース設定の編集

このページでは、JDBC、メール、JNDI、およびその他の Java ベースリソースを設定および管理できます。

Web アプリケーションは、リソースマネージャー、データソース (SQL データソースなど)、メールセッション、URL 接続ファクトリなど、さまざまなリソースにアクセスする可能性があります。J2EE プラットフォームは、JNDI (Java Naming and Directory Interface) サービスを使用してそれらのリソースをアプリケーションに公開します。

Sun Java System Web Server では、次の Java EE リソースを作成および管理できます。

• JDBC データソース

• JDBC 接続プール

• Java メールセッション。

• カスタムリソース。

• 外部 JNDI リソース。

JDBC リソース

JDBC データソースは、Sun Java System Web Server で作成および管理可能な Java EE リソースの 1 つです。

JDBC API は、リレーショナルデータベースシステムと接続するための API です。JDBC API は次の 2 つの部分から成ります。

• アプリケーションコンポーネントがデータベースへのアクセスに使用する、アプリケーションレベルのインタフェース。

• JDBC ドライバを Java EE プラットフォームに接続するためのサービスプロバイダインタフェース。

JDBC データソースオブジェクトは、データソースを Java プログラミング言語で実装したものです。簡単に言えば、データソースとはデータを格納する機能のことです。それは、大企業向けの複雑なデータベースのように高度なものでもかまいませんし、行と列を含むファイルのように単純なものでもかまいません。JDBC データソースは、Sun Java System Web Server 経由で作成および管理可能な Java EE リソースの 1 つです。

JDBC API は標準 SQL データベースアクセスインタフェースを備えた Java 向けの一連のクラスを提供しますが、それらのクラスを使えば、広範なリレーショナルデータベースに統一的な方法で確実にアクセスできます。

JDBC を使えば、事実上すべてのデータベース管理システム (DBMS) に SQL 文を送信できます。これは、リレーショナル DBMS、オブジェクト DBMS のどちらのインタフェースとしても使用されます。

共通 JDBC ドライバ

次の表に、一般的な JDBC ドライバと、新しい JDBC リソースの追加時に構成する必要のあるプロパティーの一覧を示します。「JDBC リソースの追加」を参照してください。

注 – 次のリストは、サポートされるすべての JDBC ドライバの一部にすぎません。

表 25 サポートされている共通 JDBC ドライバのリスト

JDBC リソースの追加

1. 構成を選択します。

   構成のリストから構成を選択します。リストを取得するには「構成」タブをクリックします。

2. 「Java」、「リソース」タブの順にクリックします。

3. 「JDBC リソース」セクションの下の「新規」ボタンをクリックします。

4. ドライバベンダーを選択します。

   JNDI 名として一意の値を指定し、選択可能なリストから JDBC ドライバベンダーを選択します。

5. JDBC リソースのプロパティーを入力します。

   1 つ前の手順で選択した JDBC ドライバベンダーに基づいて、ドライバのクラス名と JDBC リソースプロパティーが自動的に設定されます。一部の共通 JDBC ドライバで提案されているプロパティーのリストについては、「共通 JDBC ドライバ」を参照してください。

6. 「概要」を表示します。

   概要を表示し、「完了」をクリックして新しい JDBC リソースを作成します。

カスタムリソース

このオプションを使用して、カスタムリソースを構成のインスタンスに登録できます。

カスタムリソースの追加

1. 構成を選択します。

   構成のリストから構成を選択します。リストを取得するには「構成」タブをクリックします。

2. 「Java」、「リソース」タブの順にクリックします。

3. 「カスタムリソース」セクションの下の「新規」ボタンをクリックします。

カスタムリソースのプロパティー

次の表では、カスタムリソースの作成時に利用可能なプロパティーについて説明します。

表 26 フィールドの作成 > カスタムリソース

外部 JNDI リソース

このオプションを使えば、外部 Java Naming and Directory Interface (JNDI) リソースを作成できます。外部 JNDI リソースは、内部 JNDI リポジトリに保存されているリソースにアクセスするのに必要です。

外部 JNDI リソースの追加

1. 構成を選択します。

   構成のリストから構成を選択します。リストを取得するには「構成」タブをクリックします。

2. 「Java」、「リソース」タブの順にクリックします。

3. 「外部 JNDI リソース」セクションの下の「新規」ボタンをクリックします。

外部 JNDI リソースのプロパティー

次の表では、新しい外部 JNDI リソースの追加時に利用可能なプロパティーについて説明します。

表 27 フィールドの説明 > 外部 JNDI リソース

メールリソース

JMS デスティネーションは、Sun Java System Web Server 経由で作成および管理可能な Java EE リソースです。

多くのインターネットアプリケーションで電子メール通知を送信する機能が必要となるため、Java EE プラットフォームには JavaMail API と JavaMail サービスプロバイダが含まれています。これにより、アプリケーションコンポーネントによるインターネットメールの送信が可能となります。

新しいメールリソースの追加

1. 構成を選択します。

   構成のリストから構成を選択します。リストを取得するには「構成」タブをクリックします。

2. 「Java」、「リソース」タブの順にクリックします。

3. 「メールリソース」セクションの下の「新規」ボタンをクリックします。

メールリソースのプロパティー

次の表では、新しいメールリソースの追加時に利用可能なプロパティーについて説明します。

表 28 フィールドの説明 > メールリソースのプロパティー

サーバーのライフサイクル

• 初期化 — このフェーズには、構成の読み取り、組み込みサブシステム (ネーミング、セキュリティー、およびロギングのサービス) の初期化、および Web コンテナの作成が含まれます。

• 起動 — このフェーズには、配備済みアプリケーションの読み込みと初期化が含まれます

• サービス — サーバーが要求を処理する準備が整いました

• シャットダウン — このフェーズでは、読み込み済みのアプリケーションが停止および破棄されます。システムは停止準備中です。

• 終了 — このフェーズでは、組み込みサブシステムとサーバー実行時環境が終了されます。このフェーズ後に別のアクティビティーが発生することはありません。

• 再構成 — サーバーがサービス状態を保ちつつサーバースレッドが動的に再構成を行っているという、サーバーの一時的な状態。このフェーズは、サーバーの存続期間中に何回か発生する可能性があります。

新しいライフサイクルモジュールの追加

1. 構成を選択します。

   構成のリストから構成を選択します。構成のリストを表示するには「構成」タブをクリックします。

2. 「Java」>「ライフサイクルモジュール」タブをクリックします。

3. 「新規」ボタンをクリックします。

   次の各パラメータの値を入力します。

   • 名前 — 新しいライフサイクルモジュールの有効な一意名を入力します。

   • 有効 — このライフサイクルモジュールを有効にするには、このオプションを使用します。

   • クラス名 — 完全修飾 Java クラス名。このクラスで LifecycleListener インタフェースを実装します。このインタフェースの詳細については、『Developer's Guide』を参照してください。

   • クラスパス — 省略可能です。リスナークラスのクラスパスを指定できます。

   • 読み込み順序 — > 100。ライフサイクルイベントリスナーの読み込みは番号順に行われます。100 と等しいかそれより大きい読み込み順序を選択することをお勧めします。そうすれば、内部ライフサイクルモジュールとの衝突を回避できます。

   • 読み込み時の障害 — このオプションを有効にすると、サーバーがリスナークラスからスローされた例外を致命的な障害として扱わないため、通常の起動が引き続き行われます。デフォルトは無効です。

   • 説明 — ライフサイクルモジュールについての簡単な説明を入力します。

   • プロパティー — プロパティーを使えば、Java ライフサイクルモジュールに引数を渡せます。新しいプロパティーを追加するには、「プロパティーを追加」ボタンをクリックし、名前、値、および説明のテキストを入力します。

   ---

   注意 – サーバーライフサイクルリスナークラスはメインサーバースレッドから同期起動されるため、リスナークラスがサーバーをブロックしないように特に注意する必要があります。リスナークラスは必要に応じてスレッドを作成できますが、それらのスレッドがシャットダウン/終了フェーズで停止されるようにする必要があります。

   ---

ライフサイクルモジュールの削除

1. 構成を選択します。

   構成のリストから構成を選択します。構成のリストを表示するには「構成」タブをクリックします。

2. 「Java」>「ライフサイクルモジュール」タブをクリックします。

3. ライフサイクルモジュールを選択し、「ライフサイクルモジュールを削除」ボタンをクリックします。

ライフサイクルモジュールの編集

Java サーバーライフサイクルモジュールはサーバーのライフサイクルイベントを待機する Java クラスであり、その目的は、サーバーの起動や停止といったサーバーイベントが発生するたびに特定のタスクを実行することにあります。

このサーバーは、Web サーバー環境内での Java ベースの短期または長期タスクの実行をサポートします。これらのタスクは、サーバー起動時に自動的に起動され、サーバー停止時にその旨を通知されます。これにより、単独サーバー、RMI サーバーなどをインスタンス化するようなタスクを開始できます。

サーバーのライフサイクルに関する簡単な説明を次に示します。

認証設定の編集

このページから、認証レルムを追加および削除できます。Java EE ベースのセキュリティーモデルは、ユーザーを識別および認証するセキュリティーレルムをサポートします。

認証プロセスでは、Java レルムを使用してユーザーを検証します。レルムは、ユーザーのセット、オプションのグループマッピング、および認証要求を検証できる認証ロジックで構成されます。構成されたレルムと確立されたセキュリティーコンテキストによって認証要求が検証されたあと、このアイデンティティーが以降のすべての認証決定に適用されます。

Java レルムは auth-db (認証データベース) とよく似ていますが、auth-db は (ACL ファイル内のルールに基づいて) ACL エンジンによって使用されるのに対し、Java レルムは Java Servlet のアクセス制御ルール (各 Web アプリケーションの web.xml) によって使用される点が異なります。

サーバーインスタンスは任意の数の構成済みレルムを持つことができます。構成情報は、server.xml ファイルの auth-realm 要素内に存在します。

次の表では、Sun Java System Web Server 7.0 でサポートされているさまざまなタイプのレルムの定義を示します。

表 29 レルムのタイプ

次の節では、新しい認証レルムを追加する場合の手順について説明します。

認証レルムの追加

1. 構成を選択します。

   新しい認証レルムを追加する必要のある構成を選択します。「構成」タブをクリックし、構成を選択します。

2. 「Java」、「認証」タブの順にクリックします。

3. 「サーブレット認証」の下で「新規」をクリックします。

4. レルムの詳細を入力します。

   • 名前 — レルムの簡易名を入力します。この名前は、web.xml などからこのレルムを参照する場合に使用されます。

   • クラス — カスタムレルムを設定している場合は、カスタムレルムを実装する完全 Java クラス名を入力します。組み込みレルムの場合、クラスを入力する必要はありません。

   • タイプ — レルムのタイプを選択します。表 29 を参照してください。

   • プロパティー — レルム固有のプロパティーを追加します。例: property name="file" value="instance_dir/config/keyfile" and property name="jaas-context" value="fileRealm。

認証レルムの必須プロパティー

各認証レルムには、必須プロパティーを追加する必要があります。次の表では、必須プロパティーの一部を示します。

表 30 認証レルムの必須プロパティー

サーブレットコンテナ設定の編集

この節では、サーブレットコンテナの構成手順について説明します。

サーブレットコンテナ設定の編集

1. 構成を選択します。

   構成のリストから構成を選択します。リストを取得するには「構成」タブをクリックします。

2. 「Java」、「サーブレットコンテナ」の順にクリックします。

サーブレットコンテナのパラメータ

次の表では、サーブレットコンテナページで利用可能なパラメータについて説明します。

表 31 フィールドの説明 > サーブレットコンテナ

セッションレプリケーション設定の編集

この節では、選択された構成のセッションレプリケーションのプロパティーを設定する手順について説明します。

セッションレプリケーション設定の編集

1. 構成を選択します。

   構成のリストから構成を選択します。リストを取得するには「構成」タブをクリックします。

2. 「Java」、「セッションレプリケーション」の順にクリックします。

セッションレプリケーションのパラメータ

次の表では、セッションレプリケーションページで利用可能なパラメータについて説明します。

表 32 フィールドの説明 > セッションレプリケーション

SOAP 認証設定の編集

Java Authentication Service Provider Interface for Containers 仕様は、認証メカニズムプロバイダをコンテナに統合できるようにするための標準サービスプロバイダインタフェースを定義します。管理コンソールを使えば、新しい SOAP 認証プロバイダを追加できます。

SOAP 認証プロバイダの追加

1. 構成を選択します。

   構成のリストから構成を選択します。リストを取得するには「構成」タブをクリックします。

2. 「Java」、「認証」タブの順にクリックします。

3. 「SOAP 認証」セクションの下の「新規」をクリックします。

SOAP 認証プロバイダのパラメータ

次の表では、新規 SOAP 認証プロバイダページで利用可能なパラメータについて説明します。

表 33 フィールドの説明 > SOAP 認証プロバイダ