test

Sun GlassFish Enterprise Server v3 管理ガイド

第 15 章 EIS 接続の管理

この章では、Sun GlassFishTM Enterprise Server v3 環境で、asadmin コマンド行ユーティリティーを使用し、エンタープライズ情報システム (EIS) のデータとの接続を管理する方法について説明します。

注 –

Web Profile をインストールした場合は、発信機能だけを使用するコネクタモジュールと、着信機能を伴わない作業管理がサポートされます。その他のコネクタ機能は、Full Platform Profile でのみサポートされます。

ここでは、以下のトピックに関して説明します。

本章で説明するタスクを管理コンソールから実行する手順については、管理コンソールのオンラインヘルプを参照してください。

データベース接続については、第 14 章データベース接続の管理 を参照してください。

EIS 接続とは

エンタープライズ情報システム (EIS) は、組織のデータを保持する任意のシステムです。メインフレーム、メッセージングシステム、データベースシステム、またはアプリケーションがこれに使用できます。アプリケーションとモジュールが EIS ソフトウェアにアクセスするには、接続リソースが使用されます。

EIS 接続の主な要素は、次のとおりです。

実行時に、アプリケーションが EIS に接続されると次のことが行われます。

  1. JNDI API を介して呼び出しを行うことにより、アプリケーションは EIS に関連したコネクタリソース (データソース) を取得します。

    コネクタリソースの JNDI 名を基に、ネーミングおよびディレクトリサービスがリソースを検索します。EIS リソースはそれぞれコネクタ接続プールを指定します。

  2. コネクタリソースを経由して、アプリケーションは EIS 接続を取得します。

    Enterprise Server は EIS リソースに対応した接続プールから物理接続を取得します。プールは、EIS 名、ユーザー名、パスワードなどの接続属性を定義します。

  3. EIS 接続が確立されると、アプリケーションは EIS のデータの読み込み、変更、および追加を行うことができます。

    アプリケーションは JMS API を呼び出すことにより、EIS 情報にアクセスします。

  4. EIS へのアクセスが完了すると、アプリケーションは接続を終了して、接続を接続プールに返します。

コネクタ接続プールの管理

コネクタモジュールを配備すると、これにコネクタ接続プールを作成できるようになります。

ここでは、以下のトピックに関して説明します。

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

配備したコネクタモジュールにコネクタ接続プールを作成するには、リモートモードで create-connector-connection-pool サブコマンドを使用します。コネクタ接続プールを構築する際に、その EIS に固有の所定データを入力するよう求められます。必須の --connectiondefintion オプションの値が、EIS 情報となります。

複数のコネクタリソースで 1 つの接続プールを指定できます。

コネクタ接続プールの作成は動的イベントで、サーバーの再起動は求められません。ただし、パラメータの中には、サーバーの再起動を求めるものもあります。「サーバーの再起動が必要な構成の変更」を参照してください。

始める前に

コネクタ接続プールを作成する前に、コネクタをインストールしておいてください。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. create-connector-connection-pool(1) サブコマンドを使用して、コネクタ接続プールを作成します。

    このサブコマンドのプロパティーについては、このマニュアルページに記載されています。

  3. (省略可能) 必要な場合は、サーバーを再起動します。

    プロパティーの中には、サーバーの再起動を求めるものもあります。「サーバーの再起動が必要な構成の変更」を参照してください。サーバーを再起動する必要がある場合は、「ドメインの再起動」を参照してください。

  4. (省略可能) 接続プールが使用可能であることを確認するには、ping-connection-pool サブコマンドを使用します。

    手順については、「接続プールと通信する (ping を実行する)」を参照してください。

例 15–1 コネクタ接続プールの作成

この例では、javax.jms.QueueConnectionFactory コネクタモジュールに jms/qConnPool プールを新規作成します。


asadmin> create-connector-connection-pool --steadypoolsize 20 --maxpoolsize 100 
--poolresize 2 --maxwait 60000 --raname jmsra --connectiondefinition 
javax.jms.QueueConnectionFactory jms/qConnPool  
Command create-connector-connection-pool executed successfully
参照

コマンド行に asadmin help create-connector-connection-pool と 入力して、サブコマンドの完全な構文とオプションを確認することもできます。

Procedureコネクタ接続プールを一覧表示する

作成済みのプールを一覧表示するには、リモートモードで list-connector-connection-pools サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-connector-connection-pools(1) サブコマンドを使用して、コネクタ接続プールを一覧表示します。

例 15–2 コネクタ接続プールの一覧表示

この例では、既存のコネクタ接続プールを一覧表示します。


asadmin> list-connector-connection-pools
jms/qConnPool
Command list-connector-connection-pools executed successfully
参照

コマンド行に asadmin help list-connector-connection-pools と 入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

Procedureコネクタ接続プールに接続 (ping) するかコネクタ接続プールをリセット (フラッシュ) する

リモートモードで接続プールにこれらのタスクを実行するには、ping-connection-pool または flush-connection-pool サブコマンドを使用します。手順については、「接続プールと通信する (ping を実行する)」または「接続プールをリセット (フラッシュ) する」を参照してください。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. flush-connection-pool(1) サブコマンド、または ping-connection-pool(1) サブコマンドを使用して、コネクタ接続プールに接続、またはコネクタ接続プールをリセットします。

Procedureコネクタ接続プールを更新する

コネクタ接続プールのプロパティー値を表示および変更するには、 get および set サブコマンドを使用します。

  1. list-connector-connection-pools(1) サブコマンドを使用して、コネクタ接続プールを一覧表示します。

  2. get(1) サブコマンドを使用して、コネクタ接続プールのプロパティーを表示します。

    次に例を示します。


    asadmin> get domain.resources.connector-connection-pool.conectionpoolname.*

  3. set(1) サブコマンドを使用して、コネクタ接続プールのプロパティーを設定します。

    次に例を示します。


    asadmin> set domain.resources.connector-connection-pool
.conectionpoolname.validate-atmost-once-period-in-seconds=3

  4. (省略可能) 必要な場合は、サーバーを再起動します。

    プロパティーの中には、サーバーの再起動を求めるものもあります。「サーバーの再起動が必要な構成の変更」を参照してください。サーバーを再起動する必要がある場合は、「ドメインの再起動」を参照してください。

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

コネクタ接続プールを削除するには、リモートモードで delete-connector-connection-pool サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-connector-connection-pools(1) サブコマンドを使用して、コネクタ接続プールを一覧表示します。

  3. 必要な場合は、コネクタ接続プールが削除されることをユーザーに通知してください。

  4. delete-connector-connection-pool(1) サブコマンドを使用して、コネクタ接続プールを削除します。

例 15–3 コネクタ接続プールの削除

この例では、jms/qConnPool という接続プールを削除します。


asadmin> delete-connector-connection-pool --cascade=false jms/qConnPool
Command delete-connector-connection-pool executed successfully
参照

コマンド行に asadmin help delete-connector-connection-pool と 入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

コネクタリソースの管理

コネクタリソースとは、アプリケーションまたはモジュールに EIS への接続手段を提供するものです。通常、ドメインに配備するアプリケーションのアクセス対象となる EIS ごとに、コネクタリソースを作成します。

ここでは、以下のトピックに関して説明します。

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

新しいコネクタリソースとその JNDI 名を登録するには、リモートモードで create-connector-resource サブコマンドを使用します。

コネクタリソースの作成は動的イベントで、サーバーの再起動は求められません。ただし、パラメータの中には、サーバーの再起動を求めるものもあります。「サーバーの再起動が必要な構成の変更」を参照してください。

始める前に

コネクタリソースを作成する前に、まずコネクタ接続プールを作成しておく必要があります。手順については、「コネクタ接続プールを作成する」を参照してください。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. create-connector-resource(1) サブコマンドを使用して、コネクタリソースを作成します。

    このサブコマンドのプロパティーについては、このマニュアルページに記載されています。

  3. (省略可能) 必要な場合は、サーバーを再起動します。

    プロパティーの中には、サーバーの再起動を求めるものもあります。「サーバーの再起動が必要な構成の変更」を参照してください。サーバーを再起動する必要がある場合は、「ドメインの再起動」を参照してください。

例 15–4 コネクタリソースの作成

この例では、jms/qConnPool 接続プールに jms/qConnFactory というリソースを新規作成します。


asadmin> create-connector-resource --poolname jms/qConnPool 
--description "creating sample connector resource" jms/qConnFactory
Command create-connector-resource executed successfully
参照

コマンド行に asadmin help create-connector-resource と 入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

Procedureコネクタリソースを一覧表示する

作成済みのコネクタリソースを一覧表示するには、リモートモードで list-connector-resources サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-connector-resources(1) サブコマンドを使用して、コネクタ接続プールを一覧表示します。

例 15–5 コネクタリソースの一覧表示

この例では、既存のコネクタリソースを一覧表示します。


asadmin> list-connector-resources
jms/qConnFactory
Command list-connector-resources executed successfully
参照

コマンド行に asadmin help list-connector-resources と 入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

Procedureコネクタリソースを更新する

コネクタリソースのプロパティー値を表示および変更するには、 get および set サブコマンドを使用します。

  1. list-connector-resources(1) サブコマンドを使用して、コネクタ接続プールを一覧表示します。

  2. get(1) サブコマンドを使用して、コネクタリソースのプロパティーを表示します。

    次に例を示します。


    asadmin> get domain.resources.connector-resource.jms/qConnFactory

  3. set(1) サブコマンドを使用して、コネクタリソースのプロパティーを設定します。

    次に例を示します。


    asadmin> set domain.resources.connector-resource.jms/qConnFactory.enabled=true

  4. (省略可能) 必要な場合は、サーバーを再起動します。

    プロパティーの中には、サーバーの再起動を求めるものもあります。「サーバーの再起動が必要な構成の変更」を参照してください。サーバーを再起動する必要がある場合は、「ドメインの再起動」を参照してください。

Procedureコネクタリソースを削除する

JNDI 名を指定してコネクタリソースを削除するには、リモートモードで delete-connector-resource サブコマンドを使用します。

始める前に

リソースを削除する前に、そのリソースに関連付けられているものをすべて削除しておく必要があります。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-connector-resources(1) サブコマンドを使用して、コネクタ接続プールを一覧表示します。

  3. 必要な場合は、コネクタリソースが削除されることをユーザーに通知してください。

  4. delete-connector-resource(1) サブコマンドを使用して、コネクタリソースを削除します。

例 15–6 コネクタリソースの削除

この例では、jms/qConnFactory コネクタリソースを削除します。


asadmin> delete-connector-resource jms/qConnFactory 
Command delete-connector-resources executed successfully
参照

コマンド行に asadmin help delete-connector-resource と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

リソースアダプタ構成の管理

ここでは、以下のトピックに関して説明します。

Procedureリソースアダプタの構成情報を作成する

リソースアダプタ (コネクタモジュール) の構成情報を作成するには、リモートモードで create-resource-adapter-config サブコマンドを使用します。配備するときに構成情報を使用できるように、このサブコマンドを実行してからリソースアダプタを配備することができます。このリソースアダプタ構成は、リソースアダプタを配備したあとでも作成できます。この場合、リソースアダプタは新しい構成で再起動されます。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. create-resource-adapter-config(1) サブコマンドで、構成情報を作成します。

    このサブコマンドのプロパティーについては、このマニュアルページに記載されています。

例 15–7 リソースアダプタ構成の作成

この例では、リソースアダプタ ra1 の構成を作成します。


asadmin> create-resource-adapter-config --property foo=bar 
--threadpoolid mycustomerthreadpool ra1
Command create-resource-adapter-config executed successfully
参照

コマンド行に asadmin help create-resource-adapter-config と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

Procedureリソースアダプタ構成の一覧表示

指定したリソースアダプタ (コネクタモジュール) のドメイン構成ファイル (domain.xml) に含まれている構成情報を一覧表示するには、リモートモードで list-resource-adapter-configs サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-resource-adapter-configs(1) サブコマンドで、リソースアダプタの設定を一覧表示します。

例 15–8 リソースアダプタ構成の一覧表示

この例では、リソースアダプタ構成を一覧表示します。


asadmin> list-resource-adapter-configs
ra1
ra2
Command list-resource-adapter-configs executed successfully
参照

コマンド行に asadmin help list-resource-adapter-configs と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

Procedureリソースアダプタ構成を更新する

リソースアダプタ構成のプロパティー値を表示および変更するには、 get および set サブコマンドを使用します。

  1. list-resource-adapter-configs(1) サブコマンドで、リソースアダプタの構成を一覧表示します。

  2. get(1) サブコマンドを使用して、コネクタリソースのプロパティーを表示します。

    次に例を示します。


    asadmin> get domain.resources.resource-adapter-config.ra1.*

  3. set(1) サブコマンドを使用して、コネクタリソースのプロパティーを設定します。

    次に例を示します。


    asadmin> set domain.resources.resource-adapter-config.ra1.raSpecificProperty=value

Procedureリソースアダプタ構成を削除する

指定したリソースアダプタ (コネクタモジュール) のドメイン構成ファイル (domain.xml) に含まれている構成情報を削除するには、リモートモードで delete-resource-adapter-config サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-resource-adapter-configs(1) サブコマンドで、リソースアダプタの構成を一覧表示します。

  3. delete-resource-adapter-config(1) サブコマンドで、リソースアダプタの構成を削除します。

例 15–9 リソースアダプタ構成の削除

この例では、リソースアダプタ ra1 の構成を削除します。


asadmin> delete-resource-adapter-config ra1
Command delete-resource-adapter-config executed successfully
参照

コマンド行に asadmin help delete-resource-adapter-config と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

コネクタセキュリティーマップの管理

EIS は、組織のデータを保持する任意のシステムです。メインフレーム、メッセージングシステム、データベースシステム、またはアプリケーションがこれに使用できます。コネクタセキュリティーマップは、アプリケーションの証明を EIS 証明にマッピングするのに使用します。

セキュリティーマップは、個々のコネクタ接続プールに適用されます。1 つ以上の指定したセキュリティーマップをコネクタ接続プールに関連付けることができます。

ここでは、以下のトピックに関して説明します。

Procedureコネクタセキュリティーマップを作成する

指定したコネクタ接続プールにセキュリティーマップを作成するには、リモートモードで create-connector-security-map サブコマンドを使用します。セキュリティーマップが存在しない場合は、新規に作成されます。バックエンド EIS 主体、またはバックエンド EIS ユーザーグループを指定できます。コネクタセキュリティーマップの構成では、ワイルドカード文字としてアスタリスク (*) を使用し、すべてのユーザーまたはすべてのユーザーグループを示すことができます。

このサブコマンドを使用して、コンテナ管理トランザクションベースのシナリオで、アプリケーション (主体またはユーザーグループ) の呼び出し側 ID を適切な EIS 主体に割り当てることもできます。

始める前に

このサブコマンドを正常に実行するためには、最初にコネクタ接続プールを作成しておく必要があります。手順については、「コネクタ接続プールを作成する」を参照してください。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. create-connector-security-map(1) サブコマンドで、コネクタセキュリティーマップを作成します。

    このサブコマンドのオプションについては、このマニュアルページに記載されています。

  3. (省略可能) 必要な場合は、サーバーを再起動します。

    プロパティーの中には、サーバーの再起動を求めるものもあります。「サーバーの再起動が必要な構成の変更」を参照してください。サーバーを再起動する必要がある場合は、「ドメインの再起動」を参照してください。

例 15–10 コネクタセキュリティーマップの作成

この例では、connection-pool1 に、securityMap1 コネクタセキュリティーマップを作成します。


asadmin> create-connector-security-map --poolname connector-pool1 
--principals principal1, principal2 --mappedusername backend-username securityMap1
Command create-connector-security-map executed successfully

Procedureコネクタセキュリティーマップの一覧表示

指定したコネクタ接続プールに属する既存のセキュリティーマップを一覧表示するには、リモートモードで list-connector-security-maps サブコマンドを使用します。コネクタ接続プールにコネクタセキュリティーマップの簡易リストを取得することも、マップの主体を表示するような総合リストを取得することもできます。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-connector-connection-pools(1) サブコマンドを使用して、既存のコネクタ接続プールを一覧表示します。

  3. list-connector-security-maps(1) サブコマンドで、指定のコネクタ接続プールのセキュリティーマップを一覧表示します。

例 15–11 コネクタ接続プールのコネクタセキュリティーマップの一覧表示

この例では、connector-Pool1 に関連付けられているコネクタセキュリティーマップを一覧表示します。


asadmin> list-connector-security-maps connector-Pool1
securityMap1 
Command list-connector-security-maps executed successfully.
例 15–12 コネクタ接続プールの指定セキュリティーマップの主体の一覧表示

この例では、securityMap1 に関連付けられている主体を一覧表示します。


asadmin> list-connector-security-maps --securitymap securityMap1 connector-Pool1
principal1
principal1
Command list-connector-security-maps executed successfully.
例 15–13 コネクタ接続プールのコネクタセキュリティーマップの主体の一覧表示

この例では、connector-Pool1 に関連付けられているコネクタセキュリティーマップを一覧表示します。


asadmin> list-connector-security-maps --verbose connector-Pool1
securityMap1
principal1
principal1
Command list-connector-security-maps executed successfully.

Procedureコネクタセキュリティーマップを更新する

指定したコネクタ接続プールにセキュリティーマップを作成または変更するには、リモートモードで update-connector-security-map サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-connector-security-maps(1) サブコマンドを使用して、既存のコネクタセキュリティーマップを一覧表示します。

  3. update-connector-security-map(1) サブコマンドで、指定のコネクタ接続プールのセキュリティーマップを変更します。

  4. (省略可能) 必要な場合は、サーバーを再起動します。

    プロパティーの中には、サーバーの再起動を求めるものもあります。「サーバーの再起動が必要な構成の変更」を参照してください。サーバーを再起動する必要がある場合は、「ドメインの再起動」を参照してください。

例 15–14 コネクタセキュリティーマップの更新

この例では、securityMap1 に主体を追加します。


asadmin> update-connector-security-map --poolname connector-pool1 
--addprincipals principal1, principal2 securityMap1
Command update-connector-security-map executed successfully.

Procedureコネクタセキュリティーマップを削除する

指定したコネクタ接続プールにセキュリティーマップを削除するには、リモートモードで delete-connector-security-map サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-connector-connection-pools(1) サブコマンドを使用して、既存のコネクタ接続プールを一覧表示します。

  3. delete-connector-security-map(1) サブコマンドで、指定のコネクタ接続プールのセキュリティーマップを削除します。

    このサブコマンドのオプションについては、このマニュアルページに記載されています。

例 15–15 コネクタセキュリティーマップの削除

この例では、connector-pool1 から securityMap1 を削除します。


asadmin> delete-connector-security-map --poolname connector-pool1 securityMap1
Command delete-connector-security-map executed successfully

コネクタ作業セキュリティーマップの管理

EIS は、組織のデータを保持する任意のシステムです。メインフレーム、メッセージングシステム、データベースシステム、またはアプリケーションがこれに使用できます。コネクタ作業セキュリティーマップは、EIS 証明を Enterprise Server セキュリティードメインの証明にマッピングするのに使用します。

セキュリティーマップは、個々のコネクタ接続プールに適用されます。1 つ以上の指定したセキュリティーマップをコネクタ接続プールに関連付けることができます。

ここでは、以下のトピックに関して説明します。

Procedureコネクタ作業セキュリティーマップを作成する

コネクタモジュール (リソースアダプタ) の EIS 主体または EIS グループが提出した作業の呼び出し側 ID を、Enterprise Server セキュリティードメインの適切な主体またはユーザーグループにマッピングするには、リモートモードで create-connector-work-security-map サブコマンドを使用します。1 つ以上の作業セキュリティーマップをコネクタモジュールに関連付けることができます。

コネクタセキュリティーマップの構成では、ワイルドカード文字としてアスタリスク (*) を使用し、すべてのユーザーまたはすべてのユーザーグループを示すことができます。

始める前に

コネクタリソースを作成する前に、まずコネクタ作業セキュリティーマップを作成しておく必要があります。手順については、「コネクタ接続プールを作成する」を参照してください。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. create-connector-work-security-map(1) サブコマンドで、コネクタ作業セキュリティーマップを作成します。

    このサブコマンドのプロパティーについては、このマニュアルページに記載されています。

  3. (省略可能) 必要な場合は、サーバーを再起動します。

    プロパティーの中には、サーバーの再起動を求めるものもあります。「サーバーの再起動が必要な構成の変更」を参照してください。サーバーを再起動する必要がある場合は、「ドメインの再起動」を参照してください。

例 15–16 コネクタ作業セキュリティーマップを作成する

次の例は、my-resource-adapter-name に workSecurityMap1 および workSecurityMap2 を作成します。


asadmin> create-connector-work-security-map --raname my-resource-adapter-name 
--principalsmap eis-principal-1=server-principal-1,eis-principal-2=server-principal-2, 
eis-principal-3=server-principal-1 workSecurityMap1


asadmin> create-connector-work-security-map --raname my-resource-adapter-name
--groupsmap eis-group-1=server-group-1,eis-group-2=server-group-2,
eis-group-3=server-group-1 workSecurityMap2
Command create-connector-work-security-map executed successfully
参照

コマンド行に asadmin help create-connector-work-security-map と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

Procedureコネクタ作業セキュリティーマップを一覧表示する

指定のコネクタモジュールに属する作業セキュリティーマップを一覧表示するには、リモートモードで list-connector-work-security-maps サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-connector-work-security-maps(1) サブコマンドで、コネクタ作業セキュリティーマップを一覧表示します。

例 15–17 コネクタ作業セキュリティーマップの一覧表示

この例では、一般的な作業セキュリティーマップを一覧表示します。


asadmin> list-connector-work-security-maps generic-ra
generic-ra-groups-map: EIS group=eis-group, mapped group=glassfish-group
generic-ra-principals-map: EIS principal=eis-bar, mapped principal=bar
generic-ra-principals-map: EIS principal=eis-foo, mapped principal=foo
Command list-connector-work-security-maps executed successfully.
参照

コマンド行に asadmin help list-connector-work-security-maps と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

Procedureコネクタ作業セキュリティーマップを更新する

指定のリソースアダプタ (接続モジュール) に属する作業セキュリティーマップを変更するには、リモートモードで update-connector–work-security-map サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-connector-work-security-maps(1) サブコマンドで、コネクタ作業セキュリティーマップを一覧表示します。

  3. 必要な場合は、コネクタ作業セキュリティーマップが変更されることをユーザーに通知してください。

  4. update-connector-work-security-map(1) サブコマンドで、コネクタ作業セキュリティーマップを更新します。

例 15–18 コネクタ作業セキュリティーマップの更新

この例では、作業セキュリティーマップから主体を削除します。


asadmin> update-connector-work-security-map --raname generic-ra 
--removeprincipals eis-foo generic-ra-principals-map
Command update-connector-work-security-map executed successfully.
参照

コマンド行に asadmin help update-connector-work-security-map と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

Procedureコネクタ作業セキュリティーマップを削除する

指定のコネクタモジュール (リソースアダプタ) に属する作業セキュリティーマップを削除するには、リモートモードで delete-connector–work-security-map サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-connector-work-security-maps(1) サブコマンドで、コネクタ作業セキュリティーマップを一覧表示します。

  3. delete-connector-work-security-map(1) サブコマンドで、コネクタ作業セキュリティーマップを削除します。

例 15–19 コネクタ作業セキュリティーマップの削除

この例では、my_ra コネクタモジュールから worksecuritymap1 マップを削除します。


asadmin> delete-connector-work-security-map --raname my_ra worksecuritymap1
Command delete-connector-work-security-map executed successfully.
参照

コマンド行に asadmin help delete-connector-work-security-map と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

管理対象オブジェクトの管理

コネクタモジュールにパッケージ化されている管理対象オブジェクトは、アプリケーションの特殊な機能を提供します。たとえば、管理対象オブジェクトは、コネクタモジュールおよびそれに関連付けられた EIS に固有なパーサーへのアクセスを提供できます。

ここでは、以下のトピックに関して説明します。

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

管理対象オブジェクトを作成するには、create-admin-object サブコマンドを使用します。管理対象オブジェクトリソースを作成すると、名前と値のペアが作成され、そのオブジェクトが JNDI 名と関連付けられます。

始める前に

このサブコマンド (jmsrar.rar) を実行する前に、リソースアダプタを配備しておいてください。

  1. create-admin-object(1) サブコマンドで、管理対象オブジェクトを作成します。

    このサブコマンドのプロパティーについては、このマニュアルページに記載されています。

  2. (省略可能) 必要な場合は、サーバーを再起動します。

    プロパティーの中には、サーバーの再起動を求めるものもあります。「サーバーの再起動が必要な構成の変更」を参照してください。サーバーを再起動する必要がある場合は、「ドメインの再起動」を参照してください。

例 15–20 管理対象オブジェクトの作成

この例では、ra.xml ファイルから javax.jms.Queue リソースの型が取得されます。新たに作成される管理対象オブジェクトの JNDI 名は、jms/samplequeue です。


asadmin> create-admin-object --restype javax.jms.Queue 
--raname jmsra  --description "sample administered object" 
--property Name=sample_jmsqueue jms/samplequeue
Command create-admin-object executed successfully
参照

コマンド行に asadmin help create-admin-object と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

Procedure管理対象オブジェクトを一覧表示する

既存の管理対象オブジェクトを一覧表示するには、リモートモードで list-admin-object サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-admin-objects(1) サブコマンドで、管理対象オブジェクトを一覧表示します。

例 15–21 管理対象オブジェクトの一覧表示

この例では、既存の管理対象オブジェクトを一覧表示します。


asadmin> list-admin-objects
jms/samplequeue
Command list-admin-objects executed successfully
参照

コマンド行に asadmin help list-admin-object と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

Procedure管理対象オブジェクトを更新する

管理対象オブジェクトのプロパティー値を表示および変更するには、 get および set サブコマンドを使用します。

  1. list-admin-objects(1) サブコマンドで、管理対象オブジェクトを一覧表示します。

  2. get(1) サブコマンドを使用して、管理対象オブジェクトのプロパティーを表示します。

    次に例を示します。


    asadmin> get domain.resources.admin-object-resource.jms/samplequeue.*

  3. set(1) サブコマンドを使用して、管理対象オブジェクトのプロパティーを設定します。

    次に例を示します。


    asadmin> set domain.resources.admin-object-resource.jms/samplequeue.enabled=false

  4. (省略可能) 必要な場合は、サーバーを再起動します。

    プロパティーの中には、サーバーの再起動を求めるものもあります。「サーバーの再起動が必要な構成の変更」を参照してください。サーバーを再起動する必要がある場合は、「ドメインの再起動」を参照してください。

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

管理対象オブジェクトを削除するには、delete-admin-object サブコマンドを使用します。

  1. list-admin-objects(1) サブコマンドで、管理対象オブジェクトを一覧表示します。

  2. 必要な場合は、管理対象オブジェクトが削除されることをユーザーに通知してください。

  3. delete-admin-object(1) サブコマンドで、管理対象オブジェクトを削除します。

例 15–22 管理対象オブジェクトの削除

この例では、JNDI 名 jms/samplequeue が付いた管理対象オブジェクトを削除します。


asadmin> delete-admin-object jms/samplequeue
Command delete-admin-object executed successfully
参照

コマンド行に asadmin help delete-admin-object と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。