Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理ガイド

- Previous: 第 6 章 JNDI リソース
- Next: 第 8 章 J2EE コンテナ

# 第 7 章 コネクタリソース

この章では、エンタープライズ情報システム (EIS) へのアクセスに使用されるコネクタの設定方法について説明します。この章には次の節が含まれています。

- 「コネクタについて」

- 「コネクタ接続プールに関する管理コンソールタスク」

- 「コネクタリソースに関する管理コンソールタスク」

- 「管理対象オブジェクトリソースに関する管理コンソールタスク」

# コネクタについて

コネクタモジュールとは、アプリケーションがエンタープライズ情報システム (EIS) と対話することを可能にする J2EE コンポーネントであり、リソースアダプタとも呼ばれます。EIS ソフトウェアにはさまざまな種類のシステムが含まれています。ERP (Enterprise Resource Planning)、メインフレームトランザクション処理、非リレーショナルデータベースなどです。ほかの J2EE モジュールと同様に、コネクタモジュールをインストールするには、これを配備する必要があります。

コネクタ接続プールとは、特定の EIS のための再利用可能な接続のグループです。コネクタ接続プールを作成するには、プールに関連付けられたコネクタモジュール (リソースアダプタ) を指定します。

コネクタリソースとは、アプリケーションに EIS への接続を提供するプログラムオブジェクトです。コネクタリソースを作成するには、JNDI 名と関連する接続プールを指定します。複数のコネクタリソースで 1 つの接続プールを指定できます。アプリケーションはリソースの JNDI 名を検索してその位置を確定します。JNDI の詳細については、「JNDI 名とリソース」の節を参照してください。EIS 用コネクタリソースの JNDI 名は、通常 `java:comp/env/`eis-specific サブコンテキストにあります。

Application Server は、コネクタモジュール (リソースアダプタ) を使って JMS を実装します。「JMS リソースとコネクタリソースの関係」を参照してください。

# コネクタ接続プールに関する管理コンソールタスク

- 「EIS アクセスを設定する」

- 「コネクタ接続プールを作成する」

- 「コネクタ接続プールを編集する」

- 「コネクタ接続プールを削除する」

## EIS アクセスを設定する

##### 手順

1. コネクタを配備 (インストール) します。「コネクタモジュールを配備する」を参照してください。

2. コネクタの接続プールを作成します。「コネクタ接続プールを作成する」を参照してください。

3. 接続プールに関連付けられたコネクタリソースを作成します。「コネクタリソースを作成する」を参照してください。

## コネクタ接続プールを作成する

##### 始める前に

プールを作成する前に、プールに関連付けられたコネクタモジュール (リソースアダプタ) を配備します。新しいプールに指定する値は、配備したコネクタモジュールにより異なります。

##### 手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「コネクタ接続プール」ノードを選択します。

3. 「コネクタ接続プール」ページで、「新規」をクリックします。

4. 最初の「コネクタ接続プールを作成」ページで、次の設定値を指定します。

   1. 「名前」フィールドで、プールの論理名を入力します。

      コネクタリソースの作成時にこの名前を指定します。

   2. 「リソースアダプタ」コンボボックスからエントリを選択します。

      コンボボックスには配備したリソースアダプタ (コネクタモジュール) のリストが表示されます。

5. 「次へ」をクリックします。

6. 次の「コネクタ接続プールを作成」ページで、「接続の定義」コンボボックスから値を選択します。

   コンボボックスの選択はリソースアダプタにより異なります。通常は、`ConnectionFactory` のタイプとして EIS に接続するファクトリインスタンスを指定します。

7. 「次へ」をクリックします。

8. 最後に 3 番目の「コネクタ接続プールを作成」ページで、次のタスクを実行します。

   1. 「一般設定」セクションでその値が正しいことを確認します。

   2. 「プール設定」セクションのフィールドに、デフォルト値を保持できます。

      これらの設定はあとで変更できます。「コネクタ接続プールの編集」を参照してください。

   3. 「追加プロパティー」テーブルで、必要なプロパティーを追加します。

      前の「コネクタ接続プールを作成」ページでは、「接続の定義」コンボボックスから値を選択しました。このクラスはサーバーのクラスパス内にあり、「追加プロパティー」テーブルにはデフォルトプロパティーが表示されます。

9. 「完了」をクリックします。

##### 同機能を持つ asadmin コマンド

`create-connector-connection-pool`

## コネクタ接続プールを編集する

##### 手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「コネクタ接続プール」ノードを開きます。

3. 編集するプールのノードを選択します。

4. 「コネクタ接続プールを編集」ページで、プールに含まれる接続の数を制御する設定を変更できます。次の表を参照してください。

   パラメータ | 説明
   --- | ---
   初期および最小プールサイズ | プール内の接続の最小数。この値は、プールを最初に作成したり、Application Server を起動したりするときの、プールに含まれる接続の数も指定します。
   最大プールサイズ | プールに含まれる接続の最大数。
   プールサイズ変更量 | プールのサイズが最小プールサイズに近づくと、プールサイズが一括処理で変更されます。この値は一括処理での接続の数を指定します。過大な値を設定すると接続の再利用が遅れ、過小な値を設定すると効率が落ちます。
   アイドルタイムアウト | プールで接続がアイドル状態のままでいられる最長時間を指定します。この時間を過ぎると、接続はプールから削除されます。
   最大待ち時間 | 接続タイムアウトになる前に接続を要求したアプリケーションが待つ時間。デフォルトの待ち時間は長いので、アプリケーションがハングアップしているように見える可能性があります。
   すべて障害で | 「すべての接続を閉じる」のチェックボックスを選択してある場合、1 つの接続が失敗すると、アプリケーションサーバーはプールに含まれるすべての接続を閉じ、それらを再確立します。そのチェックボックスを選択していない場合は、使用されるときにだけ個々の接続が再確立されます。
   トランザクションサポート | トランザクションサポートのリストを使用して、接続プールのトランザクションサポートのタイプを選択します。選択したトランザクションサポートは、この接続プールに下位互換性があるように関連付けられたリソースアダプタのトランザクションサポート属性をオーバーライドします。つまり、リソースアダプタに指定したレベルより低いトランザクションレベルまたはリソースアダプタに指定したレベルと同じトランザクションレベルをサポートし、それより高いレベルを指定することはできません。 トランザクションサポートオプションには次のものが含まれます。 「トランザクションサポート」メニューから「なし」を選択すると、リソースアダプタがローカルのリソースマネージャーまたは JTA トランザクションをサポートせず、`XAResource` または `LocalTransaction` インタフェースを実装しないことを示します。 ローカルトランザクションサポートは、リソースアダプタが `LocalTransaction` インタフェースを実装することにより、ローカルトランザクションをサポートすることを意味します。ローカルトランザクションはリソースマネージャーの内部で管理され、外部トランザクションマネージャーは一切関与しません。 XA トランザクションサポートは、リソースアダプタが `LocalTransaction` および `XAResource` インタフェースを実装することにより、ローカルのリソースマネージャーと JTA トランザクションをサポートすることを意味します。XA トランザクションは、リソースマネージャーの外部にあるトランザクションマネージャーによって制御され、協調動作します。ローカルトランザクションはリソースマネージャーの内部で管理され、外部トランザクションマネージャーは一切関与しません。

5. 「追加プロパティー」テーブルで、名前と値のペアを指定します。

   指定するプロパティーは、プールが使用するリソースアダプタにより異なります。配備担当者がこのテーブルを使用して指定した名前と値のペアは、リソースアダプタベンダーが定義したプロパティーのデフォルト値をオーバーライドするために使用できます。

6. 「セキュリティーマップ」タブ付き区画で、接続プールのセキュリティーマップを作成または変更します。

   セキュリティーマップの作成方法の詳細については、「セキュリティーマップについて」を参照してください。

7. 「保存」をクリックします。

## コネクタ接続プールを削除する

##### 手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「コネクタ接続プール」ノードを選択します。

3. 「コネクタ接続プール」ページで、削除するプールのチェックボックスにチェックマークを付けます。

4. 「削除」をクリックします。

##### 同機能を持つ asadmin コマンド

`delete-connector-connection-pool`

# コネクタリソースに関する管理コンソールタスク

- 「コネクタリソースを作成する」

- 「コネクタリソースを編集する」

- 「コネクタリソースの削除」

- 「コネクタサービスを設定する」

## コネクタリソースを作成する

コネクタリソース (データソース) はアプリケーションに EIS への接続を提供します。

##### 始める前に

コネクタリソースを作成する前に、まずコネクタ接続プールを作成します。

##### 手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「コネクタリソース」ノードを開きます。

3. 「コネクタリソース」ページで、「新規」をクリックします。

4. 「コネクタリソースを作成」ページで、リソースの設定を指定します。

   1. 「JNDI 名」フィールドに、一意の名前を入力します。次に例を示します。`eis/myERP` 。

      スラッシュを忘れないでください。

   2. 「プール名」コンボボックスから、新しいコネクタリソースが属する接続プールを選択します。

   3. リソースを利用不可に変更するには、「すべてのターゲットを無効」ラジオボタンをオンにします。

      デフォルトでは、リソースは作成すると同時に利用可能 (有効) です。

   4. このページの「ターゲット」セクションで、「選択可能」フィールドからコネクタリソースが配置されるドメイン、クラスタ、またはサーバーインスタンスを選択して「追加」をクリックします。

      「選択」フィールドに一覧表示されたドメイン、クラスタ、またはサーバーインスタンスのいずれかにコネクタリソースを配備しない場合は、同フィールドから該当するものを選択して「削除」をクリックします。

5. 「了解」をクリックします。

##### 同機能を持つ asadmin コマンド

`create-connector-resource`

## コネクタリソースを編集する

##### 手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「コネクタリソース」ノードを開きます。

3. 編集するコネクタリソースのノードを選択します。

4. 「コネクタリソースを編集」ページで、「プール名」メニューから別の接続プールを選択することができます。

5. 「ターゲット」タブ付き区画で、「ターゲットの管理」をクリックして、コネクタリソースが配備されているターゲットを編集することができます。

   ターゲットの詳細については、「コネクタリソースを作成する」を参照してください。

6. 「保存」をクリックして、編集を適用します。

## コネクタリソースの削除

##### 手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「コネクタリソース」ノードを選択します。

3. 「コネクタリソース」ページで、削除するリソースのチェックボックスにチェックマークを付けます。

4. 「削除」をクリックします。

##### 同機能を持つ asadmin コマンド

`delete-connector-resource`

## コネクタサービスを設定する

「コネクタサービス」画面を使用して、このクラスタまたはサーバーインスタンスに配備されたすべてのリソースアダプタのコネクタコンテナを設定します。

##### 手順

1. ツリーから「設定」を選択します。

2. 設定するインスタンスを選択します。

   - 特定のインスタンスを設定するには、そのインスタンスの設定ノードを選択します。たとえば、デフォルトインスタンス server の場合は、server-config ノードを選択します。

   - default-config のコピーを利用する将来のインスタンスのためにデフォルト設定を設定するには、default-config ノードを選択します。

3. 「コネクタサービス」ノードを選択します。

4. 「シャットダウンタイムアウト」フィールドで、シャットダウンのタイムアウトを秒単位で指定します。

   アプリケーションサーバーがコネクタモジュールのインスタンスの `ResourceAdapter.stop` メソッドの完了を待機する秒数 (整数) を入力します。指定したシャットダウンタイムアウトよりも長い時間がかかるリソースアダプタはアプリケーションサーバーに無視され、シャットダウン手順が続行されます。デフォルトのシャットダウンタイムアウトは 30 秒です。「デフォルトを読み込み」をクリックして、このクラスタまたはサーバーインスタンスに配備されたリソースアダプタのデフォルトのシャットダウンタイムアウトを選択します。

# 管理対象オブジェクトリソースに関する管理コンソールタスク

- 「管理対象オブジェクトリソースを作成する」

- 「管理対象オブジェクトリソースを編集する」

- 「管理対象オブジェクトリソースを削除する」

## 管理対象オブジェクトリソースを作成する

リソースアダプタ (コネクタモジュール) にパッケージ化されている管理対象オブジェクトは、アプリケーションの特殊な機能を提供します。たとえば、管理対象オブジェクトは、リソースアダプタおよびそれに関連付けられた EIS に固有なパーサーへのアクセスを提供できます。オブジェクトは管理対象に指定することができます。つまり、管理者により設定可能です。オブジェクトを設定するには、「作成」または「管理オブジェクトリソースを編集」ページで、名前と値のプロパティーペアを追加します。管理対象オブジェクトリソースを作成すると、その管理対象オブジェクトが JNDI 名に関連付けられます。

Application Server はリソースアダプタを使って JMS を実装します。作成する各 JMS 送信先に対して、Application Server は管理対象オブジェクトリソースを自動的に作成します。

##### 手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「管理オブジェクトリソース」ノードを開きます。

3. 「コネクタリソース」ページで、「新規」をクリックします。

4. 「管理オブジェクトリソース」ページで、次の設定を指定します。

   1. 「JNDI 名」フィールドで、リソースを識別する一意の名前を入力します。

   2. 「リソースタイプ」フィールドで、リソースの Java タイプを入力します。

   3. 「リソースアダプタ」コンボボックスから、管理対象オブジェクトが含まれるリソースアダプタを選択します。

   4. チェックボックスを選択または選択解除して、リソースを有効または無効にします。

   5. 「次へ」をクリックします。

5. 次の「管理オブジェクトリソースを作成」ページで、次のタスクを実行できます。

   1. 名前と値のプロパティーペアで管理対象オブジェクトを設定するには、「プロパティーを追加」をクリックします。

   2. このページの「ターゲット」セクションで、「選択可能」フィールドから管理対象オブジェクトが配置されるドメイン、クラスタ、またはサーバーインスタンスを選択して「追加」をクリックします。

      「選択」フィールドに一覧表示されたドメイン、クラスタ、またはサーバーインスタンスのいずれかへの管理対象オブジェクトの配備を取り消す場合は、同フィールドから該当するものを選択して「削除」をクリックします。

6. 「完了」をクリックします。

##### 同機能を持つ asadmin コマンド

`create-admin-object`

## 管理対象オブジェクトリソースを編集する

##### 手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「管理対象オブジェクトリソース」ノードを開きます。

3. 編集する管理対象オブジェクトリソースのノードを選択します。

4. 「管理対象オブジェクトリソースを編集」ページで、「管理対象オブジェクトリソースの作成」で指定した値を変更します。

5. 「ターゲット」タブ付き区画で、「ターゲットの管理」をクリックして、管理対象オブジェクトが配備されているターゲットを編集することができます。

   ターゲットの詳細については、「管理対象オブジェクトリソースを作成する」を参照してください。

6. 「保存」をクリックして、編集を適用します。

## 管理対象オブジェクトリソースを削除する

##### 手順

1. ツリーコンポーネントで、「リソース」ノードを開き、次に「コネクタ」ノードを開きます。

2. 「管理対象オブジェクトリソース」ノードを選択します。

3. 「管理対象オブジェクトリソース」ページで、削除するリソースのチェックボックスにチェックマークを付けます。

4. 「削除」をクリックします。

##### 同機能を持つ asadmin コマンド

`delete-admin-object`

- Previous: 第 6 章 JNDI リソース
- Next: 第 8 章 J2EE コンテナ

- © 2010, Oracle Corporation and/or its affiliates