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

カスタムリソースについて

カスタムリソースの使用

カスタムリソースはローカルの JNDI リポジトリにアクセスし、外部リソースは外部 JNDI リポジトリにアクセスします。両方のリソースのタイプが、ユーザー指定のファクトリクラス要素、JNDI 名属性などを必要とします。この節では、J2EE リソースの JNDI 接続ファクトリリソースを設定し、これらのリソースにアクセスする方法を説明します。

Application Server では、list-jndi-entities と同様に、リソースを作成、削除、一覧表示することができます。

Procedureカスタムリソースを作成する

手順
  1. 管理コンソールの左側の区画で、JNDI 設定を変更する Application Server インスタンスを開きます。

  2. 「JNDI」タブを開き、「カスタムリソース」をクリックします。

    カスタムリソースがすでに作成されている場合、それらが右側の区画に表示されます。新しいカスタムリソースを作成するには、「新規」をクリックします。「JNDI」タブを開き、「新規」をクリックします。新しいカスタムリソースを追加するページが表示されます。

  3. 「JNDI 名」フィールドで、リソースへのアクセスに使用する名前を入力します。

    この名前は JNDI ネームサービスに登録されます。

  4. 「リソースタイプ」フィールドで、上記の例に示すとおり完全修飾タイプの定義を入力します。

    リソースタイプの定義は、xxx.xxx の形式に従います。

  5. 「ファクトリクラス」フィールドで、作成するカスタムリソースのファクトリクラス名を入力します。

    「ファクトリクラス」はファクトリクラスのユーザー指定の名前です。このクラスは javax.naming.spi.ObjectFactory インタフェースを実装します。

  6. 「説明」フィールドで、作成するリソースの説明を入力します。

    この説明は文字列値で、最大 250 文字を入力することができます。

  7. 「追加プロパティー」セクションで、プロパティー名およびプロパティー値を追加します。

  8. 「カスタムリソースを有効」チェックボックスにチェックマークを付けて、カスタムリソースを有効にします。

  9. 「了解」をクリックして、カスタムリソースを保存します。

    クラスタまたはスタンドアロンインスタンスにカスタムリソースが配備されている場合、「ターゲット」タブを使用してターゲットを管理できます。「ターゲット」タブは、カスタムリソースの作成後に表示されます。ターゲット名を入力して「了解」をクリックし、ターゲットを設定します。

同機能を持つ asadmin コマンド

create-custom-resource

Procedureカスタムリソースを編集する

手順
  1. 管理コンソールの左側の区画で、JNDI 設定を変更する Application Server インスタンスを開きます。

  2. 「JNDI」を開き、「カスタムリソース」を選択します。

    カスタムリソースがすでに作成されている場合、それらが右側の区画に表示されます。

  3. 右側の区画のファイル名をクリックします。

  4. 「リソースタイプ」フィールド、「ファクトリクラス」フィールド、または「説明」フィールドを編集します。

  5. 「カスタムリソースを有効」チェックボックスにチェックマークを付けて、カスタムリソースを有効にします。

  6. 「保存」をクリックして、カスタムリソースの変更を保存します。

Procedureカスタムリソースを削除する

手順
  1. 管理コンソールの左側の区画で、「JNDI」タブを開きます。

  2. 「カスタムリソース」をクリックします。

    カスタムリソースがすでに作成されている場合、それらが右側の区画に表示されます。

  3. 削除するリソース名の横にあるボックスをクリックします。

  4. 「削除」をクリックします。カスタムリソースが削除されます。

同機能を持つ asadmin コマンド

delete-custom-resource

カスタムリソースの一覧表示

カスタムリソースを一覧表示するには、asadmin list-custom-resources コマンドを入力します。たとえば、ホスト plum 上のカスタムリソースを一覧表示するには、次のように入力します。


$asadmin list-custom-resources --host plum target6

コマンドの完全なコンテキストを確認するには、asadmin help list-custom-resources と入力してください。