前へ 目次 索引 次へ |
Sun Java System Message Queue 3.5 SP1 管理ガイド

> ## 第 7 章
> 管理対象オブジェクトの管理

> 管理対象オブジェクトを使用すると、ほかの JMS プロバイダへの移植が可能なクライアントアプリケーションを開発できます。管理対象オブジェクトは、プロバイダ固有の設定およびネーミング情報をカプセル化するオブジェクトです。通常、これらのオブジェクトは Message Queue の管理者によって作成され、クライアントアプリケーションがブローカへのコネクションを取得する際に使用されます。さらに、これらのオブジェクトは、物理的な送信先にメッセージを送信したり、物理的な送信先からメッセージを受信したりする場合にも使用されます。

> 管理対象オブジェクトの概要については、「Message Queue管理対象オブジェクト」を参照してください。

> Message Queueは、管理対象オブジェクトを作成したり管理したりするための 2 つの管理ツールを提供しています。それは、コマンド行オブジェクトマネージャユーティリティ (imqobjmgr) と GUI 管理コンソールです。これらのツールでは、次のようなタスクを実行できます。

> - オブジェクトストアへの管理対象オブジェクトの追加やオブジェクトストアからの管理対象オブジェクトの削除
> - 既存の管理対象オブジェクトの一覧表示
> - 管理対象オブジェクトに関する情報のクエリーおよび表示
> - オブジェクトストアにある既存の管理対象オブジェクトの変更

> この章では、オブジェクトマネージャユーティリティ (imqobjmgr) を使用して、これらのタスクを実行する方法について説明します。これらのタスクを実行するには、使用するオブジェクトストアと作成する管理対象オブジェクトの両方の属性を理解する必要があるため、この章では、imqobjmgr を使用して管理対象オブジェクトを管理する方法を説明する前に、この 2 つのトピックの背景について説明します。

> 管理コンソールの使用法については、第 4 章「管理コンソールのチュートリアル」を参照してください。

> ##

> オブジェクトストアについて

> 管理対象オブジェクトは、即時に使用可能なオブジェクトストアに配置されます。クライアントアプリケーションは JNDI 検索を行うときに、このオブジェクトストアに配置された管理対象オブジェクトにアクセスします。標準 LDAP ディレクトリサーバまたはファイルシステムのオブジェクトストアの 2 種類のオブジェクトストアが使用できます。

> ### LDAP サーバオブジェクトストア

> LDAP サーバは、運用メッセージングシステム用のオブジェクトストアとしてお勧めします。LDAP 実装は、多数のベンダーでサポートされており、分散システムでの使用を考慮した設計になっています。LDAP サーバは、運用環境で役立つセキュリティ機能も備えています。

> Message Queue 管理ツールは、LDAP サーバ上のオブジェクトストアを管理できます。ただし、はじめに LDAP サーバのマニュアルに記載されているとおり、java オブジェクトを格納し JNDI 検索を実行するように LDAP サーバを設定する必要があります。

> また、LDAP サーバをオブジェクトストアとして使用している場合は、表 7-1 に示す属性を指定する必要があります。これらの属性は、次のように分類されます。

> - 初期コンテキスト : LDAP サーバオブジェクトストアの場合、この属性は固定である
> - ロケーション : LDAP サーバの設定時に、管理対象オブジェクトの URL とディレクトリパスを指定する。特に、指定したパスが存在することを確認する必要がある
> - セキュリティ情報 : LDAP プロバイダによって異なる。セキュリティ情報をすべての操作で必要とするのか、あるいは格納データを変更する操作にだけ必要とするのか決める場合、使用する LDAP 実装に付属するマニュアルを参照する必要がある

> 表 7-1 LDAP オブジェクトストアの属性

> 属性 | 説明
> --- | ---
> java.naming.factory. initial | LDAP サーバ上の JNDI 検索用の初期コンテキスト com.sun.jndi.ldap.LdapCtxFactory
> java.naming.provider.url | LDAP サーバの URL とディレクトリパス情報。たとえば、次のように指定する ldap://mydomain.com:389/ou=mqobjs, o=myapp 管理対象オブジェクトは、/myapp/mqobjs ディレクトリに格納される
> java.naming.security. principal | LDAP サーバの呼び出し元を認証するための主体の識別情報。このエントリの形式は、認証スキーマによって異なる。たとえば、次のように指定する uid=fooUser, ou=People, o=mq このプロパティを指定しない場合は、LDAP サービスプロバイダによって動作が決定される
> java.naming.security. credentials | LDAP サーバの呼び出し元を認証するための主体の証明書。プロパティの値は、認証スキーマによって異なる。ハッシュ化されたパスワード、クリアテキストのパスワード、キー、証明書などが使用できる。たとえば、次のように指定する fooPasswd このプロパティを指定しない場合は、LDAP サービスプロバイダによって動作が決定される
> java.naming.security. authentication | 使用するセキュリティのレベル。値は、 none、simple、strong のどれかのキーワードになる たとえば、simple を指定した場合、値がまだ指定されていない主体または証明書の値を入力するよう要求される。これによって、識別情報をより安全に提供することが可能となる このプロパティを指定しない場合は、LDAP サービスプロバイダによって動作が決定される

> ### ファイルシステムオブジェクトストア

> Message Queue は、ファイルシステムのオブジェクトストア実装もサポートしています。ファイルシステムのオブジェクトストアは、まだ十分なテストが行われていないため、運用システムでの使用はお勧めしませんが、開発環境で使いやすいという利点があります。LDAP サーバをセットアップする必要はなく、ローカルのファイルシステム上にディレクトリを作成するだけで利用できます。

> ただし、クライアントが複数のコンピュータノードにまたがって配備されている場合は、これらのクライアントがオブジェクトストアの常駐するディレクトリに対してアクセス権を持つときにだけ、ファイルシステムストアを集中オブジェクトストアとして使用できます。さらに、このディレクトリにアクセス可能なユーザーは、Message Queue の管理ツールを使用して、管理対象オブジェクトを作成および管理することができます。

> ファイルシステムオブジェクトストアを使用している場合は、表 7-2 に示す属性を指定する必要があります。これらの属性は、次のように分類されます。

> - 初期コンテキスト : ファイルシステムオブジェクトストアの場合、この属性の値は固定である
> - ロケーション : この属性の値は、使用する管理対象オブジェクトを格納するディレクトリパスを指定する。ディレクトリが存在していて、Message Queue 管理ツールのユーザーと、ストアにアクセスするクライアントアプリケーションのユーザーは適切なアクセス権を持っている必要がある

> 表 7-2 ファイルシステムオブジェクトストアの属性

> 属性 | 説明
> --- | ---
> java.naming.factory. initial | ファイルシステムオブジェクトストアの JNDI 検索の初期コンテキスト com.sun.jndi.fscontext. RefFSContextFactory
> java.naming.provider.url | ディレクトリパス情報。たとえば、次のように指定する file:///C:/myapp/mqobjs

> ##

> 管理対象オブジェクト

> 管理対象オブジェクトの概要については、「Message Queue管理対象オブジェクト」を参照してください。

> Message Queue の管理対象オブジェクトには 2 つの基本的な種類があります。それは、コネクションファクトリと送信先です。コネクションファクトリ管理対象オブジェクトは、ブローカへのコネクションを作成するために、クライアントアプリケーションが使用します。送信先管理対象オブジェクトは、送信先を識別するために、クライアントアプリケーションが使用します。その送信先にプロデューサはメッセージを送信し、その送信先からコンシューマはメッセージを受信します。特殊な SOAP 終端管理対象オブジェクトは、SOAP メッセージングに使用されます。詳細は、『Message Queue Java Client Developer's Guide』を参照してください。

> メッセージ配信モデル (ポイントツーポイント、またはパブリッシュ / サブスクライブ) に応じて、特定タイプのコネクションファクトリおよび送信先を使用できます。たとえば、ポイントツーポイントプログラミングの場合、キューコネクションファクトリとキューの送信先を使用できます。同様に、パブリッシュおよびサブスクライブプログラミングの場合、トピックコネクションファクトリとトピックの送信先を使用できます。また、分散トランザクションをサポートするコネクションファクトリのタイプとして、不特定のコネクションファクトリと送信先管理対象オブジェクトのタイプも使用できます (すべてのサポートタイプについては、表 1-1 を参照)。

> 管理対象オブジェクトの属性は、属性と値の組み合わせで指定します。次に、これらの属性について説明します。

> ### コネクションファクトリ管理対象オブジェクトの属性

> コネクションファクトリ (および XA コネクションファクトリ) の管理対象オブジェクトには、表 7-3 に示す属性があります。主に使用する属性は、imqAddressList です。この属性を使用して、クライアントがコネクションを確立するブローカを指定します。「コネクションファクトリの追加」では、コネクションファクトリ管理対象オブジェクトをオブジェクトストアに追加する場合に、この属性を指定する方法について説明します。

> コネクションファクトリ属性の詳細およびこれらの属性の使用方法については、『Message Queue Java Client Developer's Guide』と次の Message Queue クラスに関する JavaDoc API ドキュメントを参照してください。com.sun.messaging.ConnectionConfiguration

> 表 7-3 コネクションファクトリ管理対象オブジェクトの属性

> 属性/プロパティ名 | データ型 | デフォルト値
> --- | --- | ---
> imqAckOnAcknowledge | 文字列型 | 値なし
> imqAckOnProduce | 文字列型 | 値なし
> imqAckTimeout | 文字列型 | 0 ミリ秒
> imqAddressList | 文字列型 | 値なし
> imqAddressListIterations | 整数型 | 1
> imqAddressListBehavior | 文字列型 | PRIORITY
> imqBrokerHostName (Message Queue 3.0) | 文字列型 | localhost
> imqBrokerHostPort (Message Queue 3.0) | 整数型 | 7676
> imqBrokerServicePort (Message Queue 3.0) | 整数型 | 0
> imqConfiguredClientID | 文字列型 | 値なし
> imqConnectionFlowCount | 整数型 | 100
> imqConnectionFlowLimit | 整数型 | 1000
> imqConnectionFlowLimitEnabled | ブール型 | false
> imqConnectionType (Message Queue 3.0) | 文字列型 | TCP
> imqConnectionURL (Message Queue 3.0) | 文字列型 | http://localhost/imq/ tunnel
> imqConsumerFlowLimit | 整数型 | 1000
> imqConsumerFlowThreshold | 整数型 | 50
> imqDefaultPassword | 文字列型 | guest
> imqDefaultUsername | 文字列型 | guest
> imqDisableSetClientID | ブール型 | false
> imqJMSDeliveryMode | 整数型 | 2 (持続的)
> imqJMSExpiration | ロング型 | 0 (有効期限なし)
> imqJMSPriority | 整数型 | 4 (標準)
> imqLoadMaxToServerSession | ブール型 | true
> imqOverrideJMSDeliveryMode | ブール型 | false
> imqOverrideJMSExpiration | ブール型 | false
> imqOverrideJMSHeadersTo TemporaryDestinations | ブール型 | false
> imqOverrideJMSPriority | ブール型 | false
> imqQueueBrowserMaxMessages PerRetrieve | 整数型 | 1000
> imqQueueBrowserRetrieveTimeout | ロング型 | 60,000 (ミリ秒)
> imqReconnectAttempts | 整数型 | 0
> imqReconnectEnabled | ブール型 | false
> imqReconnectInterval | ロング型 | 3000 (ミリ秒)
> imqSetJMSXAppID | ブール型 | false
> imqSetJMSXConsumerTXID | ブール型 | false
> imqSetJMSXProducerTXID | ブール型 | false
> imqSetJMSXRcvTimestamp | ブール型 | false
> imqSetJMSXUserID | ブール型 | false
> imqSSLIsHostTrusted (Message Queue 3.0) | ブール型 | true

> ### 送信先管理対象オブジェクトの属性

> 物理的なトピックやキューの送信先を指定する、送信先管理対象オブジェクトには、表 7-4 に示すような属性があります。「トピックまたはキューの追加」では、送信先管理対象オブジェクトをオブジェクトストアに追加する場合に、これらの属性を指定する方法について説明します。

> 主に使用する属性は、imqDestinationName です。これは、トピックまたはキューの管理対象オブジェクトに対応する物理的な送信先に割り当てる名前です。複数のアプリケーションをサポートするために作成するほかの送信先と区別するために、送信先の説明を指定することもできます。

> 詳細は、Message Queue クラスの com.sun.messaging.DestinationConfiguration に関する JavaDoc API ドキュメントを参照してください。

> 表 7-4 送信先管理対象オブジェクトの属性

> 属性/プロパティ名 | データ型 | デフォルト値
> --- | --- | ---
> imqDestinationDescription | 文字列型 | 送信先オブジェクトの説明
> imqDestinationName | 文字列1 | Untitled_Destination_Object

> 1送信先名には、英数字 (空白文字は含まない) だけを使用できます。送信先名は、英字や、「_」 または「$」で開始する必要があります。

> ##

> オブジェクトマネージャユーティリティ (imqobjmgr)

> オブジェクトマネージャユーティリティを使用すると、Message Queue の管理対象オブジェクトを作成および管理することができます。この節では、imqobjmgr コマンドの基本構文、サブコマンドのリスト、imqobjmgr コマンドのオプションの概要について説明します。後続の節では、imqobjmgr サブコマンドを使用して、特定のタスクを実行する方法について説明します。

> ### imqobjmgr コマンドの構文

> imqobjmgr コマンドの一般的な構文は、次のとおりです。

> imqobjmgr subcommand [options]
> imqobjmgr -h|H
> imqobjmgr -v

> -v、-h、および -H オプションを指定する場合、そのコマンド行で指定するサブコマンドは実行できません。たとえば、次のコマンドを入力すると、バージョン情報が表示されますが、list サブコマンドは実行されません。

> imqobjmgr list -v

> ### imqobjmgr のサブコマンド

> オブジェクトマネージャユーティリティ (imqobjmgr) には、次の表 7-5 に示すようなサブコマンドが含まれています。

> 表 7-5 imqobjmgr サブコマンド

> サブコマンド | 説明
> --- | ---
> add | 管理対象オブジェクトをオブジェクトストアに追加する
> delete | オブジェクトストアから管理対象オブジェクトを削除する
> list | オブジェクトストア内の管理対象オブジェクトを一覧表示する
> query | 指定された管理対象オブジェクトに関する情報を表示する
> update | オブジェクトストア内の既存の管理対象オブジェクトを変更する

> ### imqobjmgr コマンドのオプションの概要

> 表 7-6 に、imqobjmgr コマンドのオプションを示します。これらの使用方法については、タスクごとに説明した後続の節を参照してください。

> 表 7-6 imqobjmgr のオプション

> オプション | 説明
> --- | ---
> -f | ユーザーの確認なしで、アクションを実行する
> -h | 使用方法に関するヘルプを表示する。コマンド行ではそれ以外のことは実行されない
> -H | 使用方法に関するヘルプ、属性リスト、および例を表示する コマンド行ではそれ以外のことは実行されない
> -i fileName | オブジェクトタイプ、検索名、オブジェクト属性、オブジェクトストア属性などのオプションを指定するサブコマンド句の一部またはすべてを含むコマンドファイルの名前を指定する。通常、オブジェクトストア属性などの反復の多い情報に使用される
> -j attribute=value | JNDIオブジェクトストアを識別しアクセスするために必要な属性を指定する。「LDAP サーバオブジェクトストア」および「ファイルシステムオブジェクトストア」を参照
> -javahome path | 使用する代替の Java 2 互換のランタイムを指定する。デフォルトではシステム上のランタイムまたは Message Queue にバンドルされたランタイムを使用する
> -l lookupName | 管理対象オブジェクトの JNDI 検索名を指定する。この名前は、オブジェクトストアのコンテキスト内で一意であることが必要
> -o attribute=value | 管理対象オブジェクトの属性を指定する。「コネクションファクトリ管理対象オブジェクトの属性」および「送信先管理対象オブジェクトの属性」を参照
> -pre | プレビューモード。コマンドを実行せずに、実行される内容を示す
> -r read-only_state | 管理対象オブジェクトが読み取り専用オブジェクトかどうかを指定する。値 true は、管理対象オブジェクトが読み取り専用オブジェクトであることを示す。クライアントは読み取り専用管理対象オブジェクトの属性は変更できない。デフォルトでは、読み取り専用の状態は false に設定されている
> -s | サイレントモード。出力が表示されない
> -t objectType | Message Queue の管理対象オブジェクトのタイプを指定する q = queue t = topic cf = connection factory qf = queue connection factory tf = topic connection factory xcf = XA connection factory (分散トランザクション) xqf = XA queue connection factory (分散トランザクション) xtf = XA topic connection factory (分散トランザクション) e = SOAP 終端1
> -v | バージョン情報を表示する。コマンド行ではそれ以外のことは実行されない

> 1この管理対象オブジェクトのタイプは、SOAP メッセージをサポートするために使用されます (『Message Queue Java Client Developer's Guide』を参照)。

> 次に、imqobjmgr のサブコマンドを使用する場合に、設定する必要がある情報について説明します。

> ### 必要な情報

> 管理対象オブジェクトに関連する大部分のタスクを実行する場合は、imqobjmgr サブコマンドのオプションとして、次の情報を指定する必要があります。

> - 管理対象オブジェクトタイプ

> 使用可能なタイプを表 7-6 に示します。

> - 管理対象オブジェクトの JNDI 検索名

> これはオブジェクトストア内の管理対象オブジェクトを (JNDI を使用して) 参照する場合に、クライアントコードで使用される論理名です。

> - 管理対象オブジェクトの属性 (特に、add および update サブコマンドで必要)
> - 送信先の場合 : ブローカの物理的な送信先の名前。これは imqcmd create dst サブコマンドの -n オプションで指定した名前となる。この名前を指定しない場合、デフォルト名の Untitled_Destination_Object が使用されます。
> - コネクションファクトリの場合 : もっとも一般的に使用される属性は、1 つ以上のメッセージサーバアドレスをクライアントの接続先に指定するためのアドレスリスト (imqAddressList) である。この情報を指定しないと、ローカルホストとデフォルトのポート番号 (7676) が使用される。つまり、クライアントはローカルホスト上のポート 7676 のブローカに対してコネクションの確立を試みる。「コネクションファクトリの追加」では、オブジェクトの属性を指定する方法について説明する。

> その他の属性については、「コネクションファクトリ管理対象オブジェクトの属性」を参照してください。

> - オブジェクトストアの属性

> この情報は、ファイルシステムストアと LDAP サーバのどちらを使用するかによって異なりますが、次の属性を設定する必要があります。

> - JNDI 実装のタイプ (初期コンテキスト属性)。たとえば、ファイルシステムまたは LDAP
> - オブジェクトストア内の管理対象オブジェクトの場所 (プロバイダの URL 属性)。管理対象オブジェクトが存在する「フォルダ」
> - オブジェクトストアへのアクセスに必要なユーザー名、パスワード、および認証タイプ

> オブジェクトストアの属性については、「LDAP サーバオブジェクトストア」および「ファイルシステムオブジェクトストア」を参照してください。

> ### コマンドファイルの使用

> imqobjmgr コマンドを使用すると、imqobjmgr サブコマンド句のすべてまたは一部を表すために java プロパティファイルの構文を使用する、コマンドファイルの名前を指定できます。

> オブジェクトマネージャユーティリティ (imqobjmgr) と一緒にコマンドファイルを使用すると、オブジェクトストアの属性を指定する場合に特に便利です。なぜなら、オブジェクトストアの属性は複数の imqobjmgr の呼び出しにおいて、同じ内容になる可能性が高く、通常多くの入力作業が必要になるためです。また、コマンドファイルを使用すると、コマンド行で許可されている最大文字数を超えて入力してしまうのを防ぐことができます。

> imqobjmgr コマンドファイルの一般的な構文は、次のとおりです (バージョンプロパティは Message Queue 製品ではなくコマンドファイルのバージョンを示す。これはコマンド行オプションではなく、値は常に 2.0 に設定する)。

> version=2.0
> cmdtype=[ add | delete | list | query | update ]
> obj.type=[ q | t | qf | tf | cf | xqf | xtf | xcf | e ]
> obj.lookupName=lookup name
> obj.attrs.objAttrName1=value1
> obj.attrs.objAttrName2=value2
> obj.attrs.objAttrNameN=valueN
> ...
> objstore.attrs.objStoreAttrName1=value1
> objstore.attrs.objStoreAttrName2=value2
> objstore.attrs.objStoreAttrNameN=valueN
> ...

> コマンドファイルを使用する方法の例として、次の imqobjmgr コマンドを検討してください。

> imqobjmgr add
> -t qf
> -l "cn=myQCF"
> -o "imqAddressList=mq://foo:777/jms"
> -j "java.naming.factory.initial=
> com.sun.jndi.ldap.LdapCtxFactory"
> -j "java.naming.provider.url=
> ldap://mydomain.com:389/o=imq"
> -j "java.naming.security.principal=
> uid=fooUser, ou=People, o=imq"
> -j "java.naming.security.credentials=fooPasswd"
> -j "java.naming.security.authentication=simple"

> このコマンドは、次の内容を含む MyCmdFile などのファイルにカプセル化することができます。

> version=2.0
> cmdtype=add
> obj.type=qf
> obj.lookupName=cn=myQCF
> -o "imqAddressList=mq://foo:777/jms"
> objstore.attrs.java.naming.factory.initial=¥
> com.sun.jndi.ldap.LdapCtxFactory
> objstore.attrs.java.naming.provider.url=¥
> ldap://mydomain.com:389/o=imq
> objstore.attrs.java.naming.security.principal=¥
> uid=fooUser, ou=People, o=imq
> objstore.attrs.java.naming.security.credentials=fooPasswd
> objstore.attrs.java.naming.security.authentication=simple

> 次に、-i オプションを使用して、このファイルをオブジェクトマネージャユーティリティ (imqobjmgr) に渡すことができます。

> imqobjmgr -i MyCmdFile

> コマンドファイルを使用して一部のオプションを指定する一方で、コマンド行を使用してその他のオプションを指定することも可能です。このため、ユーティリティの複数の呼び出しで、同じ内容になるサブコマンド句の一部を、コマンドファイルを使用して指定することができます。たとえば、次のコマンドでは、コネクションファクトリ管理対象オブジェクトを追加する場合に必要なすべてのオプション (ただし、管理対象オブジェクトの保存場所を指定するオプションは除く) が指定されています。

> imqobjmgr add
> -t qf
> -l "cn=myQCF"
> -o "imqAddressList=mq://foo:777/jms"
> -i MyCmdFile

> この場合、MyCmdFile ファイルには次の定義が含まれます。

> version=2.0
> objstore.attrs.java.naming.factory.initial=¥
> com.sun.jndi.ldap.LdapCtxFactory
> objstore.attrs.java.naming.provider.url=¥
> ldap://mydomain.com:389/o=imq
> objstore.attrs.java.naming.security.principal=¥
> uid=fooUser, ou=People, o=imq
> objstore.attrs.java.naming.security.credentials=fooPasswd
> objstore.attrs.java.naming.security.authentication=simple

> コマンドファイルの別の例は、次の場所で参照できます。

> IMQ_HOME/demo/imqobjmgr

> ##

> 管理対象オブジェクトの追加および削除

> この節では、コネクションファクトリおよびトピックまたはキューの送信先管理対象オブジェクトをオブジェクトストアに追加する方法について説明します。

> 注 | オブジェクトマネージャユーティリティ (imqobjmgr) は、Message Queue 管理対象オブジェクトだけを一覧表示します。オブジェクトストアに、追加したい管理対象オブジェクトと同じ検索名の Message Queue 以外のオブジェクトが含まれている場合は、追加操作を実行するとエラーが表示されます。

> ### コネクションファクトリの追加

> クライアントアプリケーションがブローカへのコネクションを取得できるようにするには、クライアントアプリケーションに必要なコネクションタイプを表している管理対象オブジェクトを追加します。このタイプは、トピックコネクションファクトリかキューコネクションファクトリのどちらかになります。

> キューのコネクションファクトリを追加するには、次のようなコマンドを使用します。

> imqobjmgr add
> -t qf
> -l "cn=myQCF"
> -o "imqAddressList=mq://myHost:7272/jms"
> -j "java.naming.factoryinitial=
> com.sun.jndi.ldap.LdapCtxFactory"
> -j "java.naming.provider.url=ldap://mydomain.com:389/o=imq"
> -j "java.naming.security.principal=
> uid=fooUser, ou=People, o=imq"
> -j "java.naming.security.credentials=fooPasswd"
> -j "java.naming.security.authentication=simple"

> 上記のコマンドでは、検索名が cn=myQCF で、myHost 上で実行されているブローカに接続し、ポート 7272 で待機する管理対象オブジェクトが作成されます。この管理対象オブジェクトは、LDAP サーバに格納されます。引数としてコマンドファイルに imqobjmgr コマンドを指定すると、同じことを実行できます。詳細は、「コマンドファイルの使用」を参照してください。

> 注 | 命名規則 : LDAP サーバを使用して、管理対象オブジェクトを格納する場合、前述の例のように、接頭辞「cn=」が付いた検索名 (cn=myQCF) を割り当てることが重要です。検索名は、-l オプションを使用して指定します。ファイルシステムオブジェクトストアを使用している場合は、cn 接頭辞を使用する必要はありません。ただし、「/」を含む検索名は使用しないでください。表 7-7 を参照してください。

> 表 7-7 命名規則の例

> オブジェクトストアのタイプ | 適した名前 | 使用が禁止されている名前
> --- | --- | ---
> LDAP サーバ | cn=myQCF | myQCF
> ファイルシステム | myTopic | myObjects/myTopic

> ### トピックまたはキューの追加

> クライアントアプリケーションがブローカ上の物理的な送信先にアクセスできるようにするには、これらの送信先を指定する管理対象オブジェクトをオブジェクトストアに追加します。

> 該当する管理対象オブジェクトをオブジェクトストアに追加する前に、物理的な送信先を作成しておくことをお勧めします。コマンドユーティリティ (imqcmd) を使用して、オブジェクトストア内の送信先管理対象オブジェクトによって識別される、ブローカの物理的な送信先を作成してください。物理的な送信先の作成方法については、「コネクション情報の取得」を参照してください。

> 次のコマンドでは、検索名が myTopic で、物理的な送信先名が TestTopic のトピック送信先を識別する管理対象オブジェクトが追加されます。この管理対象オブジェクトは、LDAP サーバに格納されます。

> imqobjmgr add
> -t t
> -l "cn=myTopic"
> -o "imqDestinationName=TestTopic"
> -j "java.naming.factory.initial=
> com.sun.jndi.ldap.LdapCtxFactory"
> -j "java.naming.provider.url=
> ldap://mydomain.com:389/o=imq"
> -j "java.naming.security.principal=
> uid=fooUser, ou=People, o=imq"
> -j "java.naming.security.credentials=fooPasswd"
> -j "java.naming.security.authentication=simple"

> 次は同じコマンドです。ただし、管理対象オブジェクトが Solaris のファイルシステムに格納されるという点が異なります。

> imqobjmgr add
> -t t
> -l "cn=myTopic"
> -o "imqDestinationName=TestTopic"
> -j "java.naming.factory.initial=
> com.sun.jndi.fscontext.RefFSContextFactory"
> -j "java.naming.provider.url=
> file:///home/foo/imq_admin_objects"

> たとえば、LDAP サーバの場合、MyCmdFile というコマンドファイルを使用して、サブコマンド句を指定できます。ファイルには、次のテキストが含まれます。

> version=2.0
> cmdtype=add
> obj.type=t
> obj.lookupName=cn=myTopic
> obj.attrs.imqDestinationName=TestTopic
> objstore.attrs.java.naming.factory.initial=
> com.sun.jndi.fscontext.RefFSContextFactory
> objstore.attrs.java.naming.provider.url=
> file:///home/foo/imq_admin_objects
> objstore.attrs.java.naming.security.principal=
> uid=fooUser, ou=People, o=imq
> objstore.attrs.java.naming.security.credentials=fooPasswd
> objstore.attrs.java.naming.security.authentication=simple

> ファイルを imqobjmgr コマンドに渡す場合は、-i オプションを使用します。

> imqobjmgr -i MyCmdFile

> 注 | LDAP サーバを使用して、管理対象オブジェクトを格納する場合、前述の例のように、接頭辞「cn=」が付いた検索名を割り当てることが重要です。検索名は、-l オプションを使用して指定します。ファイルシステムのオブジェクトストアを使用する場合は、この接頭辞を使用する必要はありません。

> キューオブジェクトを追加する場合は、-t オプションに q を指定することを除いて、まったく同じコマンドを使用します。

> ### 管理対象オブジェクトの削除

> 管理対象オブジェクトを削除するには、delete サブコマンドを使用します。オブジェクトの検索名、タイプ、および場所を指定する必要があります。

> 次のコマンドでは、検索名が cn=myTopic で、LDAP サーバに格納される、トピックの管理対象オブジェクトが削除されます。

> imqobjmgr delete
> -t t
> -l "cn=myTopic"
> -j "java.naming.factory.initial=
> com.sun.jndi.ldap.LdapCtxFactory"
> -j "java.naming.provider.url=
> ldap://mydomain.com:389/o=imq"
> -j "java.naming.security.principal=
> uid=fooUser, ou=People, o=imq"
> -j "java.naming.security.credentials=fooPasswd"
> -j "java.naming.security.authentication=simple"

> ##

> 情報の入手

> オブジェクトストア内の管理対象オブジェクトを一覧表示し、個々のオブジェクトに関する情報を表示するには、list サブコマンドと query サブコマンドを使用します。

> ### 管理対象オブジェクトの一覧表示

> すべての管理対象オブジェクト、または特定タイプのすべての管理対象オブジェクトを一覧表示するには、list サブコマンドを使用します。次のサンプルコードでは、管理対象オブジェクトが LDAP サーバに格納されることを前提としています。

> 次のコマンドでは、すべてのオブジェクトが一覧表示されます。

> imqobjmgr list
> -j "java.naming.factory.initial=
> com.sun.jndi.ldap.LdapCtxFactory"
> -j "java.naming.provider.url=
> ldap://mydomain.com:389/o=imq"
> -j "java.naming.security.principal=
> uid=fooUser, ou=People, o=imq"
> -j "java.naming.security.credentials=fooPasswd"
> -j "java.naming.security.authentication=simple"

> 次のコマンドでは、queue タイプのすべてのオブジェクトが一覧表示されます。

> imqobjmgr list
> -t q
> -j "java.naming.factory.initial=
> com.sun.jndi.ldap.LdapCtxFactory"
> -j "java.naming.provider.url=
> ldap://mydomain.com:389/o=imq"
> -j "java.naming.security.principal=
> uid=fooUser, ou=People, o=imq"
> -j "java.naming.security.credentials=fooPasswd"
> -j "java.naming.security.authentication=simple"

> ### 単一オブジェクトの情報

> 管理対象オブジェクトに関する情報を入手するには、query サブコマンドを使用します。オブジェクトの検索名、および管理対象オブジェクト (初期コンテキストおよび場所など) を含むオブジェクトストアの属性を指定する必要があります。

> 次の例では、query サブコマンドを使用して、myTopic という検索名のオブジェクトに関する情報を表示します。

> imqobjmgr query
> -l "cn=myTopic"
> -j "java.naming.factory.initial=
> com.sun.jndi.ldap.LdapCtxFactory"
> -j "java.naming.provider.url=
> ldap://mydomain.com:389/o=imq"
> -j "java.naming.security.principal=
> uid=fooUser, ou=People, o=imq"
> -j "java.naming.security.credentials=fooPasswd"
> -j "java.naming.security.authentication=simple"

> ##

> 管理対象オブジェクトの更新

> 管理対象オブジェクトの属性を変更するには、update コマンドを使用します。検索名とオブジェクトの場所を指定する必要があります。-o オプションを使用して、属性値を変更します。

> このコマンドでは、トピックのコネクションファクトリを表す管理対象オブジェクトの属性が変更されます。

> imqobjmgr update
> -t tf
> -l "cn=MyTCF"
> -o imqReconnectAttempts=3
> -j "java.naming.factory.initial=
> com.sun.jndi.ldap.LdapCtxFactory"
> -j "java.naming.provider.url=
> ldap://mydomain.com:389/o=imq"
> -j "java.naming.security.principal=
> uid=fooUser, ou=People, o=imq"
> -j "java.naming.security.credentials=fooPasswd"
> -j "java.naming.security.authentication=simple"

> 前へ 目次 索引 次へ

> Copyright 2003 Sun Microsystems, Inc. All rights reserved.