|
Oracle Registry Repository Exchange Utility を使用して Oracle Enterprise Repository メタデータを Oracle Service Registry との間でパブリッシュしたり受信したりする前に、以下に示すコンフィグレーションの手順を完了しておく必要があります。
デフォルトでは、Oracle Enterprise Repository のインストール時に、Oracle Registry Repository Exchange Utility ファイルは次の場所にインストールされます。
<BEA_HOME>\repository103\core\tools\solutions.
Oracle Enterprise Repository 10.3 用の Oracle Registry Repository Exchange Utility ファイルは以下のとおりです。
OER103-RR-ExchangeUtility.zip は、Oracle Enterprise Repository をインストールしたファイル システム上のディレクトリ (通常は、BEA_HOME\repository103) に解凍することができます。Oracle Registry Repository Exchange Utility を格納する zip ファイルは、ファイル システムに解凍され、次の構造を作成します。
alrrx<Exchange Utility ツールのホーム>
|
lib
<Exchange Utility ツールのホーム> ディレクトリ内には、Oracle Registry Repository Exchange Utility ファイル (alrrx.xml、UDDIMappings.xml、alrrx.properties、alrrx.bat、encrypt.bat など) が格納されます。
必須の Registry Repository Exchange Utility Solution Pack は、OER103-RR-ExchangeUtility.zip にバンドルされます。Oracle Enterprise Repository に Registry Repository Exchange Utility Solution Pack (OER103-RR-ExchangeUtility-Solution-Pack.zip) をインポートするには、次の手順に従います。
OER103-RR-ExchangeUtility.zip ファイルをファイル システムに解凍します。<Exchange Utility ツールのホーム>\datapack ディレクトリに移動します。OER103-RR-ExchangeUtility-Solution-Pack.zip を選択します。
UDDI サーバと Web サービスのプラグインが有効であることを確認します。
| 注意 : | [UDDI] を検索することもできます。 |
システム設定のコンフィグレーションの詳細については、『Oracle Enterprise Repository Administration Guide』を参照してください。
Oracle Enterprise Repository Type Manager を使用して、種類が「サービス」と「SOA ビジネス エンティティ」のアセットの UDDI オプションを次の手順で有効にします。
Type Manager の使い方の詳細については、『Oracle Enterprise Repository Registrar Guide』を参照してください。
この節では、Oracle Registry Repository Exchange Utility のコンフィグレーション ファイルを環境に合わせてコンフィグレーションする方法について説明します。
<Exchange Utility ツールのホーム> にある alrrx.xml ファイルを開き、次の XML セクションを変更して、適切な資格を持つ Oracle Enterprise Repository インスタンスを参照するようにします。
<repository>
<uri>http://localhost:7101/oer</uri>
<credentials>
<user>admin</user>
<password>admin</password>
</credentials>
</repository>
ここで、URI には Oracle Enterprise Repository URI を次の形式で指定します。 http://<ホスト>:<ポート>/<Oracle Enterprise Repository Web アプリケーション名>
セキュリティを強化するために、「コンフィグレーション ファイルのパスワードの暗号化」の説明に従ってパスワードを暗号化することができます。
Oracle Registry Repository Exchange Utility では、1 つまたは複数のレジストリにパブリッシュしたり、複数のレジストリから読み込んだりできます (各レジストリからの読み込みには個別のトランザクションが必要です)。最初の手順は、次に示すように、接続情報を格納する <registry> ノードをもう 1 つ作成することです。
<registries>
<registry name="osr">
<inquiryURI>http://localhost:7001/registry/uddi/inquiry</inquiryURI>
<publishURI>http://localhost:7001/registry/uddi/publishing</publishURI>
<securityURI>http://localhost:7001/registry/uddi/security</securityURI>
<credentials>
<user>admin</user>
<password>admin</password>
</credentials>
</registry>
<registry name="osr2">
<inquiryURI>http://localhost:7201/registry/uddi/inquiry</inquiryURI>
<publishURI>http://localhost:7201/registry/uddi/publishing</publishURI>
<securityURI>http://localhost:7201/registry/uddi/security</securityURI>
<credentials>
<user>admin</user>
<password>admin</password>
</credentials>
</registry>
</registries>
以下に示すコンフィグレーション コードは、Oracle Enterprise Repository に対して実行するクエリを作成し、Oracle Service Registry にパブリッシュする必要のあるサービスのリストを受け取る方法を示しています。これにより、Oracle Service Registry にプッシュされるサービスがクエリの形式でフィルタ処理されます。サービスに対してクエリを実行する方法はいくつか存在するため、1 つまたは複数のクエリを作成することができます。
<services> 要素をコンフィグレーションすると、指定されたサービス名が Oracle Service Registry にパブリッシュされます。ただし、Oracle Enterprise Repository REX API での制限により、追加できる <services> 要素は 1 つだけです。
<query>
<repositoryQuery>
<services>
<service name="HelloWorld" />
</services>
<registrationStatus></registrationStatus>
<serviceCategorizations type=”AssetLifecycleStage” value=””/>
<endpointAssetLifecycleStatus></endpointAssetLifecycleStatus>
<registrationStatus> 要素をコンフィグレーションすると、指定された登録状態のサービスのみパブリッシュされます。たとえば、このフィールドを Registered に設定すると、登録済みのサービスだけが Oracle Service Registry にパブリッシュされます。一致するその他のサービスのうち、それ以外の状態のものはすべて無視されます。
<registrationStatus>Registered</registrationStatus>
<serviceCategorizations> 要素をコンフィグレーションすると、指定されたカテゴリのサービスのみパブリッシュされます。たとえば、次のカテゴリを使用すると、Recommended サービスだけが Oracle Service Registry にパブリッシュされます。
<serviceCategorizations type="classification" value="Recommended"/>
<endpointAssetLifecycleStatus> 要素をコンフィグレーションすると、一致するサービスのエンドポイントを、エンドポイントの指定されたアセット ライフサイクルに基づいてフィルタ処理できます。これにより、一致するエンドポイントだけが Oracle Service Registry にパブリッシュされます。たとえば、サービスにアタッチされるエンドポイントが 2 つ (アセット ライフサイクル ステージが Stage 3 – Build のエンドポイントと Stage 4 – Release のエンドポイント) ある場合は、Stage 3 – Build Asset Lifecycle のエンドポイントのみパブリッシュされます。
<endpointAssetLifecycleStatus>Stage 3 - Build</endpointAssetLifecycleStatus>
このクエリは、ステージングされたエンドポイントとプロダクション エンドポイントを格納するための 2 つのレジストリが存在する場合に役立ちます。
次のコンフィグレーション コードは、<destinationRegistries> 要素を使用して、一致する Oracle Enterprise Repository サービスを格納する 1 つまたは複数の送り先レジストリをコンフィグレーションする方法を示しています。これらのレジストリは、Oracle Enterprise Repository からサービスが選択されて、Oracle Service Registry に移動されるとき (つまり、Oracle Enterprise Repository > Oracle Service Registry) に使用されます。
<destinationRegistries>
<destinationRegistry>osr</destinationRegistry>
<destinationRegistry>osr2</destinationRegistry>
</destinationRegistries>
次のコンフィグレーション コードは、<registryQuery> 要素を使用して、Oracle Service Registry に対して実行するクエリを作成し、Oracle Service Registry から取得して Oracle Enterprise Repository に配置する必要のあるサービスのリストを受け取る方法を示しています。
<registryQuery>
<businessEntities>
<businessEntity name=”Account Services”/>
</businessEntities>
<services>
<service name="AddCustomerService%" />
</services>
<qualifiers>
<qualifier>approximateMatch</qualifier>
</qualifiers>
<sourceRegistry>osr</sourceRegistry>
</registryQuery>| 警告 : | ビジネス エンティティ クエリとサービス クエリの両方が指定される場合は、ビジネス エンティティ クエリがサービス クエリをオーバーライドします。 |
<sourceRegistry> 要素には、Oracle Enterprise Repository に配置するサービスの選択元のレジストリを指定します。このレジストリは、Oracle Service Registry からサービスが選択されて、Oracle Enterprise Repository に移動されるとき (つまり、Oracle Service Registry > Oracle Enterprise Repository) に使用されます。
<sourceRegistry>osr</sourceRegistry>
次の XML コードに示すように、アセットを Oracle Service Registry にパブリッシュする前に、<Exchange Utility ツールのホーム> ディレクトリに格納されている UDDI マッピング ファイル (UDDIMappings.xml) に Oracle Enterprise Repository のカテゴリがマップされます。
<uddi:uddiSettings xmlns:uddi=”http://www.bea.com/aler/integration/config/uddi”>
<categorizationMappings>
<categorizationType alerCategorizationTypeName="AssetLifecycleStage" alerCategorizationTypeId="112" uddiCategoryTModelKey="uddi:bea.com:aler:categorization:AssetLifecycleStage">
<categorization alerCategorization="Stage 1 - Propose" uddiKeyName="Stage 1 - Propose" uddiKeyValue="Stage 1 - Propose" />
<categorization alerCategorization="Stage 2 - Plan" uddiKeyName="Stage 2 - Plan" uddiKeyValue="Stage 2 - Plan" />
<categorization alerCategorization="Stage 3 - Build" uddiKeyName="Stage 3 - Build" uddiKeyValue="Stage 3 - Build" />
<categorization alerCategorization="Stage 4 - Release" uddiKeyName="Stage 4 - Release" uddiKeyValue="Stage 4 - Release" />
<categorization alerCategorization="Stage 5 - Target For Retirement" uddiKeyName="Stage 5 - Target For Retirement" uddiKeyValue="Stage 5 - Target For Retirement" />
<categorization alerCategorization="Stage 6 - Retirement" uddiKeyName="Stage 6 - Retirement" uddiKeyValue="Stage 6 - Retirement" />
Oracle Enterprise Repository のカテゴリは、対応するマッピングが UDDI マッピング ファイルに存在する場合にのみ Oracle Service Registry で受け付けられます。それ以外の場合、カテゴリは無視されます。そのため、Oracle Enterprise Repository で新しいアセット カテゴリが作成される場合は、UDDI マッピング ファイルを再生成して、そのカテゴリが Oracle Service Registry で受け付けられるようにする必要があります。
この節では、<Exchange Utility ツールのホーム> ディレクトリに格納されているプロパティ ファイル (alrrx.properties) 内のプロパティについて説明します。一部のプロパティはすでに Oracle Enterprise Repository の [System Settings] に存在します。また、Oracle Registry Repository Exchange Utility 用の新しいプロパティもあります。
cmee.uddi.service.endpoint.relationship=Deployment-Deployed - サービスとエンドポイントとの関係。cmee.import.uddi.business.assettype=SOA - Business Entity - 種類が「ビジネス エンティティ」のアセット。cmee.import.uddi.accesspoint.assettype=Endpoint: Web Service - 種類が「エンドポイント」のアセット。cmee.import.uddi.artifactwsdl.relationship=Sync-Defines - サービスと WSDL アーティファクトとの関係。cmee.import.uddi.receiver.batch.size=100 - Oracle Service Registry から受信する場合にのみ、このプロパティはバッチ サイズを指定します。| 警告 : | 以下のプロパティは、対応するプロパティが Oracle Enterprise Repository の [System Settings] で設定されていない場合にのみ使用されます。Oracle Enterprise Repository の [System Settings] のプロパティがコンフィグレーションされている場合は、その設定によって alrrx.properties ファイルのプロパティがオーバーライドされます。 |
Oracle Enterprise Repository のその他のシステム設定の詳細については、『Oracle Enterprise Repository Administration Guide』を参照してください。
セキュリティを強化するために、パスワード暗号化ツール (encrypt.bat) を使用して、Oracle Registry Repository Exchange Utility のコンフィグレーション (alrrx.xml) ファイルに格納されているパスワードを暗号化することができます。
|