WebSphere Application Server for z/OS, Version 6.0.x   
             オペレーティング・システム: z/OS

             目次と検索結果のパーソナライズ化

UDDI ユーティリティー・ツール

UDDI ユーティリティー・ツールは、UDDI バージョン 2 エンティティー (子エンティティー、およびそれぞれのバージョン 2 エンティティー・キーを含みます) を、バージョン 3 の UDDI レジストリーにマイグレーション、移動、またはコピーする際に使用できる機能のスイートです。

注: UDDI バージョン 3 の公開 API は、 パブリッシャーが割り当てるキーをサポートしているため (バージョン 2 API ではサポートされていませんでした)、 通常の API 関数を使用して、バージョン 3 のレジストリー間のエンティティーの上位変換を行うことができます。 本リリースで提供されている UDDI ユーティリティー・ツールは、 機能的には、WebSphere Application Server 5.1 で提供されているバージョンと同等です。ただし、 本リリースの UDDI ユーティリティー・ツールでは、すべての機能が UDDI バージョン 2 API を使用して実行されることに留意してください。 バージョン 2 の API タイプを使用すれば、 バージョン 2 と 3 のレジストリーから (UDDI エンティティー・キーの、バ ージョン 2 の表記のみを提供して) エクスポートしたものを、バージョン 3 のレジストリーにインポートすることができます。 バージョン 3 レジストリーのエンティティーは、バージョン 2 のエンティティーとしてエクスポートされるため、その場合は、デジタル・シグニチャーなどのエレメントは存在しません。 バージョン 3 API を使用してバージョン 3 エンティティーに独自のキーを割り当てる方法の例については、 提供されたキーによるバージョン 3 エンティティーの保管のセクションを参照してください。
ツールの他の使用方法としては、 次のようなものがあります。
  • バージョン 2 キーまたは検索条件の指定による、ソース UDDI レジストリーからの エンティティーの検索と選択
  • UDDI レジストリー内の正規の tModel の公開 (子エンティティーを含む)
  • バージョン 2 キーを指定し、UDDI (バージョン 2) エンティティーを、中間 XML 表記 (エンティティーのカスタマイズ、および複数のターゲット UDDI レジストリーへのコピーに使用される) に保持
  • ターゲット UDDI レジストリー内の既存エンティティーの更新 (子エンティティーを含む)
  • バージョン 2 キーの指定による、ターゲット UDDI レジストリーからの 選択済みエンティティーの削除

UDDI ユーティリティー・ツールは、 z/OS プラットフォームではサポートされていません。ツールを使用するには、Client Development Kit for z/OS のインス トールに説明されているように、z/OS 以外のシステムに Client Developer Kit for z/OS をインストールする必要があります。 また、z/OS 以外のシステムに、別の WebSphere Application Server をイ ンストールしている場合には、インストールに付随している UDDI ユーテ ィリティー・ツールを使用することができます。

UDDI ユーティリティー・ツールを使用するには、 UDDIUtilityTools.jar ファイルを実行します。このファイルは、app_server_root/UDDIReg/scripts ディレクトリーに あります。また、UDDI ユーティリティー・ツールのすべての機能は、提供されているパブリック Java API からも 呼び出せます。

UDDI ユーティリティー・ツールには、以下の 5 つの主な関数があります。
エクスポート
エンティティー・タイプおよびキー、またはエンティティー・タイプおよびキーのリストを 指定すると、UDDI ユーティリティー・ツールは、指定したレジストリーから UDDI エンティティーを取得し、このエンティティーを UDDI エンティティー定義ファイルに書き込みます。各キーのエンティティー・タイプは、business、service、bindingTemplate、または tModel のいずれかです。 エンティティー定義ファイルには、 UDDI ユーティリティー・ツール・スキーマ (UDDI バージョン 2 スキーマが組み込まれているもの) に従い、 指定されたそれぞれのエンティティーを正確に記述する XML が含まれています。 UDDI エンティティー定義ファイルでは、エンティティーをタイプで分類しており、 指定したエンティティーにより参照される tModel を自動的に検出および記録します。 定義ファイルの「参照される tModel」セクションは、ターゲット・レジストリーに新規エンティティーをインポートする前に、参照される tModel を確実にそのレジストリーに 含めるために使用します。
インポート
インポート関数は、UDDI エンティティーのリスト (追加の編集などによりエクスポート関数で生成された UDDI エンティティー定義ファイルを使用するか、またはプログラマチックにコンテナー・オブジェクト内で入力可能) があれば、そのエンティティーがターゲット・レジストリーに存在するかどうかを検出します。また、エンティティーが存在しない場合は、指定したキーで最小エンティティー (「スタブ」) を作成します。 その後、エンティティーが公開されて、提供されたデータを使用してスタブが更新され、既存のエンティティーはユーザーの指定に従って上書きまたは無視されます。 オリジナルのキーは常に維持されることに注意してください。
プロモート
エクスポートとインポートのステップを結合して処理を行います。 つまり、単一の論理ステップで、ソース・レジストリーから指定したエンティティーを (キーによって) 抽出し、それをターゲット・レジストリーにインポートします。 この関数では、UDDI エンティティー定義ファイルの生成はオプションです。
削除
指定されたエンティティーを、ターゲット UDDI レジストリーから削除します。 削除するエンティティーは、エンティティー・タイプ、またはエンティティー・タイプのリストとして指定し、キーはエクスポート関数と同じ方法で指定します。
一致するエンティティーの検索
さまざまなエンティティー・タイプのそれぞれの UDDI 照会 API オブジェクト形式で検索条件を入力します。検索条件と一致するエンティティーのセットは、エンティティー・キーのリストの生成に使用され、さらに、エクスポート関数、プロモート関数、削除関数への入力としても使用されます。
注: この関数は、プログラマチック API からのみ使用できます。

関数間、入力と出力、およびソースとターゲットの UDDI レジストリーの関係は、概念的な総括ダイアグラム に示されています。

構成ファイルのセットアップ

UDDI ユーティリティー・ツールの構成データは、構成プロパティー・ファイル内にあります。構成プロパティー・ファイルには、ランタイム環境、UDDI とデータベースの場所とアクセス情報、ロギング情報、セキュリティー構成、エンティティー定義ファイルの場所、および、参照されるエンティティーのインポートや上書きを制御するその他のフラグが記述されています。

UDDI ユーティリティー・ツールは、構成プロパティー・ファイルのサンプル (UDDIUtilityTools.properties) とともに配布され、デフォルトではプロパティーのパスが指定されなければ現在のディレクトリーの中で検索されます。デフォルトでは、このファイルは app_server_root/UDDIReg/scripts ディレクトリーに あります。このサンプル・ファイルを、ユーザーが書き込むことのできるロケーションにコピーします。 以下の リストに従ってこのファイルを変更し、ユーティリティー・ツールを実行する際に、この変更したファイルを 指定します。
  • クラスパスを設定します。クラスパスには現行ディレクトリー (.) と UDDIUtilityTools.jar、 およびすべての従属 JAR (このトピックで後述する『前提条件』セクションに記載) を 組み込む必要があります。クラスパスには、データベース・ドライバー JAR (db2java.zip など) を組み込む必要があります。

    [バージョン 6.0.2] JSSE プロバイダーを 構成している場合は、プロバイダーを含む .jar ファイルをクラスパスに 追加します。JSSE プロバイダーの構成はオプションで、jsse.provider プロパティーを設定することによって実行します。 デフォルト値は、com.ibm.jsse.IBMJSSEProvider です。FIPS JSSE プロバイダーを指定するには、jsse.provider プロパティーの値を com.ibm.fips.jsse.IBMJSSEFIPSProvider に設定します。

  • その他のプロパティーを設定します。これについては、以下に示すサンプル・ファイル UDDIUtilityTools.properties で コメントしています。
  • localhost をサーバーの名前に変更します。
  • ポート番号 9080 をご使用の内部 HTTP ポートに変更します。

##############################################
# Runtime environment                        #
# (if invoking via java -jar...)             #
# "X Y" required around paths with spaces    #
# Replace WAS_HOME with your WAS home path.  #
# db2java.zip is for DB2 - replace this with #
# appropriate database driver file.          #
##############################################
classpath=.;WAS_HOME/UDDIReg/scripts/UDDIUtilityTools.jar;WAS_HOME/lib/soap.jar;WAS_HOME/lib/uddi4jv2.jar;WAS_HOME/lib/j2ee.jar;"C:/Program Files/IBM/SQLLIB/java/db2java.zip"

##############################################
# SOAP entry points for source UDDI          #
############################################## 
fromInquiryURL=http://localhost:9080/uddisoap/inquiryapi
fromGetURL=http://localhost:9080/uddisoap/get

##############################################
# SOAP entry points for target UDDI          #
############################################## 
toInquiryURL=http://localhost:9080/uddisoap/inquiryapi
toPublishURL=http://localhost:9080/uddisoap/publishapi

##############################################
# UDDI registry user information             #
#                                            #
# Note: this must match the user information #
# that was used to publish the entities on   #
# the target UDDI registry.                  #
############################################## 
userID=UNAUTHENTICATED
password=NONE

##############################################
# Configuration for destination UDDI DB      #
############################################## 
dbDriver=COM.ibm.db2.jdbc.app.DB2Driver
dbUrl=jdbc:db2:uddi20
dbUser=db2admin
dbPasswd=db2admin

##############################################
# Security provider configuration            #
##############################################
# Indicates whether security is required on the target registry
secure.connection=true

# The location of the truststore if security is required
trustStore.fileName=c:/websphere/appserver/etc/DummyClientTrustFile.jks

# The password for the trust store
trustStore.password=WebAS

# The JSSE Provider class name
jsse.provider=com.ibm.jsse.IBMJSSEProvider

##############################################
# Trace and message logging configuration    #
############################################## 
# detail level of message output (all functions)
verbose=true

# detail level of trace output.
# 1: severe
# 2: normal
# 3: detail
traceLevel=3

# path to message log file (relative or absolute)
messageLogFileName=logs/messages.log

# path to trace log file (relative or absolute)
traceLogFileName=logs/trace.log

############################################## 
# Miscellaneous Options                      #
############################################## 
# indicates if existing entities are overwritten (import/promote)
# Note: tModels in referencedTModels section are never overwritten, 
#       regardless of this setting. To overwrite tModels, they must 
#       be present in the tModels section.
overwrite=false

# indicates if referenced entities will be imported (import/promote)
importReferencedEntities=true

# location of entity definition file, used for (export/import)
UddiEntityDefinitionFile=C:/definitions/entities01.xml

# namespace prefix to use in definition file (export)
namespacePrefix=promote

前提条件

UDDI ユーティリティー・ツール を実行するには、WebSphere Application Server で提供されている Java コード用の IBM Development Kit を 使用する必要があります。この Development Kit は、app_server_root/java/bin にあります。

次の .jar ファイルが UDDI ユーティリティー・ツールで使用できることを 確認してください。.jar ファイルの場所は、UDDI ユーティリティー・ツールのプロパティー・ファイルのクラスパス・プロパティーで指定します。
UDDIUtilityTools.jar
これは、ツールの JAR そのものであり、app_server_root/UDDIReg/scripts にあります。
uddi4jv2.jar
このファイルは UDDI4J クラスを含み、app_server_root/lib 内にあります。
j2ee.jar
このファイルはいくつかの必須 J2EE クラスを含み、app_server_root/lib 内にあります。
soap.jar
これは、Apache SOAP 実装であり、app_server_root/lib 内にあります。
DbDriver
これは、UDDIUtilityTool をターゲット・データベースに接続するために必要なドライバーです。 以下のテーブルは、選択したデータベースに指定する必要のある値です。
  DB2

Cloudscape

 
z/OS プラットフォームの クラスパスの DBDriverLocation DB2_HOME/jcc/classes/db2jcc.jar、DB2_HOME/jcc/classes/db2jcc_license_cisuz.jar

app_server_root/cloudscape/lib/otherJars/db2jcc.jar、app_server_root/cloudscape/lib/db2jcc_license_c.jar

 
z/OS プラットフォームのドライバー com.ibm.db2.jcc.DB2Driver com.ibm.db2.jcc.DB2Driver  
z/OS プラットフォームの URL jdbc:db2://host:database_port/database_location jdbc:db2j:net://host:1527/database_name (以下の注を参照)  
各部の意味は、次のとおりです。
  • app_server_root は、 WebSphere Application Server のディレクトリー位置です。
  • DB2_HOME は、DB2 のディレクトリー位置 (例、c:¥Program Files¥SQLLIB¥java12¥) です。
  • database_port は、ユーザーの DB2 データベースが listen されているポートです。
  • database_name は、Cloudscape データベースの名前です。database_name に データベースへのパス (profile_root/databases/com.ibm.uddi/UDDI30 など) が含まれていることを確認してください。
注:
  • Cloudscape を使用している場合、データベース・ネットワークが 複数の接続の処理を可能となるようにします。この方法について詳しくは、Cloudscape バージョン 5.1.60x の構成を参照してください。
  • DB2 を使用する場合は、DB2_HOME/icc/lib を、 LD_PATH_LIBRARY (または LD_LIBRARY_PATH) 環境変数と LIBPATH 環境変数に追加します。

上記のプロパティー・ファイル内のセキュリティー・プロバイダー構成セクションには、デフォルトの DummyClientTrustFile.jks ファイルの位置が示されています。独自のトラストストアを使用する場合は、そのトラストストアがこの場所にあることを確認してください。

UDDI ユーティリティー・ツールでは UDDI バージョン 2 SOAP 照会および公開インターフェースを使用します。 UDDI レジストリー・インターフェースのアクセス制御で説明されているように、これらの API は保護されています。UDDI ユーティリティー・ツールは、データベース・ドライバーを介しても UDDI レジストリー・データベースにアクセスでき、データベースへのアクセスはデータベース管理システムによって 制御されます。

UDDI エンティティー定義ファイル

このファイルは、エクスポート関数およびプロモート関数を使用して生成するか、手動、または UDDI ユーティリティー・ツールからエクスポート関数を指定して出力されるファイルのバージョンを変更することによって、作成することができます。これは、インポート関数への入力です。
注: 「削除された」属性を追加する uddi:tModel タイプへの拡張は、現在、UDDI ユーティリティー・ツールでは使用されていません。
ファイルは以下のように、正しい形式で作成されているか、UDDI ユーティリティー・ツールのスキーマに準拠しているかが検証されます。
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema id="uddiPromote" attributeFormDefault="unqualified" elementFormDefault="qualified"
 targetNamespace="http://www.ibm.com/xmlns/prod/WebSphere/UDDIUtilityTools" xmlns:xsd="http://www.w3.org
                  /2001/XMLSchema" 
xmlns:uddi="urn:uddi-org:api_v2" xmlns="http://www.ibm.com/xmlns/prod/WebSphere/UDDIUtilityTools"
xmlns:promote="http://www.ibm.com/xmlns/prod/WebSphere/UDDIUtilityTools">

	<xsd:import namespace="http://www.w3.org/XML/1998/namespace" schemaLocation="xml.xsd" />
	<xsd:import namespace="urn:uddi-org:api_v2" schemaLocation="uddi_v2.xsd" />

	<!-- define a type to represent state of a tModel -->
	<xsd:simpleType name="tModelDeleted">
		<xsd:restriction base="xsd:NMTOKEN">
			<xsd:enumeration value="true" />
			<xsd:enumeration value="false" />
		</xsd:restriction>
	</xsd:simpleType>

	<!-- extend tModel with additional attribute of type tModelDeleted -->
	<!-- This is restricted to values true or false -->
	<xsd:complexType name="tModel">
	<xsd:complexContent>
			<xsd:extension base="uddi:tModel">
				<xsd:attribute name="deleted" type="promote:tModelDeleted" use="optional" />
		</xsd:extension>
	</xsd:complexContent>
	</xsd:complexType>


	<!-- Top level element definitions -->
	<xsd:element name="uddiEntities" type="promote:uddiEntities" />
	<xsd:complexType name="uddiEntities">
		<xsd:sequence>
			<xsd:element ref="promote:tModels" minOccurs="0" maxOccurs="1" />
			<xsd:element ref="promote:businesses" minOccurs="0" maxOccurs="1" />
			<xsd:element ref="promote:services" minOccurs="0" maxOccurs="1" />
			<xsd:element ref="promote:bindings" minOccurs="0" maxOccurs="1" />
			<xsd:element ref="promote:referencedTModels" minOccurs="0" maxOccurs="1" />
		</xsd:sequence>
	</xsd:complexType>

	<xsd:element name="businesses" type="promote:businesses" />
	<xsd:complexType name="businesses">
		<xsd:sequence>
			<xsd:element ref="uddi:businessEntity" minOccurs="0" maxOccurs="unbounded" />
		</xsd:sequence>
	</xsd:complexType>

	<xsd:element name="tModels" type="promote:tModels" />
	<xsd:complexType name="tModels">
		<xsd:sequence>
			<xsd:element ref="uddi:tModel" minOccurs="0" maxOccurs="unbounded" />
		</xsd:sequence>
	</xsd:complexType>

	<xsd:element name="services" type="promote:services" />
	<xsd:complexType name="services">
		<xsd:sequence>
			<xsd:element ref="uddi:businessService" minOccurs="0" maxOccurs="unbounded" />
		</xsd:sequence>
	</xsd:complexType>

	<xsd:element name="bindings" type="promote:bindings" />
	<xsd:complexType name="bindings">
		<xsd:sequence>
			<xsd:element ref="uddi:bindingTemplate" minOccurs="0" maxOccurs="unbounded" />
		</xsd:sequence>
	</xsd:complexType>

	<xsd:element name="referencedTModels" type="promote:referencedTModels" />
	<xsd:complexType name="referencedTModels">
		<xsd:sequence>
			<xsd:element ref="uddi:tModel" minOccurs="0" maxOccurs="unbounded" />
		</xsd:sequence>
	</xsd:complexType>
</xsd:schema>

標準 tModel の UDDI エンティティー定義ファイルの例

以下のエンティティー定義ファイルの例は、5 つのメイン・セクション (tModels、businesses、services、bindings、および referencedTModels) を示しています。

UDDI ユーティリティー・ツールを使用すると、 ターゲットの UDDI レジストリー内に新規の UDDI エンティティーを作成することができます。 この典型的な例は、公に知られている tModel キーを持つ新規の正規 tModel の導入です。


<?xml version="1.0" encoding="UTF-8"?>
<promote:uddiEntities xmlns="urn:uddi-org:api_v2" xmlns:promote="http://www.ibm.com/xmlns/prod/WebSphere/
                      UDDIUtilityTools">

  <!-- tModels -->
  <promote:tModels>

    <tModel tModelKey="uuid:ee3966a8-faa5-416e-9772-128554343571" >
      <name>http://schemas.xmlsoap.org/ws/2002/07/policytmodel</name>
      <description>WS-PolicyAttachment policy expression</description>
    </tModel>

    <tModel tModelKey="uuid:ad61de98-4db8-31b2-a299-a2373dc97212" >
      <name>uddi-org:wsdl:address</name>
	<description xml:lang="en">
This tModel is used to specify the URL fact that the address must be obtained from the WSDL deployment 
ファイル。      </description>
      <overviewDoc>
        <overviewURL>
http://www.oasis-open.org/committees/uddi-spec/doc/tn/uddi-spec-tc-tn-wsdl-v2.htm#Address 
        </overviewURL>
      </overviewDoc>
    </tModel>

  </promote:tModels>

  <!-- businesses -->
  <promote:businesses>
  </promote:businesses>

  <!-- services -->
  <promote:services>
  </promote:services>

  <!-- bindings -->
  <promote:bindings>
  </promote:bindings>

  <!-- referenced tModels -->
  <promote:referencedTModels>
  </promote:referencedTModels>

</promote:uddiEntities>

コマンド・プロンプトにおける UDDI ユーティリティー・ツールの始動

WebSphere Application Server とともに提供される Java コードを組み込むように PATH ステートメントを設定して、 使用している Java コードのレベルが正しいことを確認します。 例えば、コマンド行から以下のように入力します。
export PATH=app_server_root/java/bin:$PATH
UDDI ユーティリティー・ツールは、以下のコマンドを使用して始動することができます。
java - jar UDDIUtilityTools.jar <function> [options]
このコマンドにより、指定したプロパティー・ファイルを使用して、 クラスパスおよび他のパラメーターをセットアップします。 または、以下のコマンドを使用しても起動できます。
java CommandLineProcessor
ここで、CommandLineProcessor は、UDDI ユーティリティー・ツールのコマンド行引数を 処理し、構成をセットアップし、適切な関数を 呼び出すクラスです。
注: コマンド行で、UDDIUtilityTools.jar を実行する前に、UDDIUtilityTools.properties ファイルを編集したことを確認してください。このプロパティー・ファイルを、UDDIUtilityTools.jar ファイルが入っているディレクトリー以外のディレクトリーに保存した場合、コマンド行引数の一部として、プロパティー・ファイルのロケーションを必ず指定してください。 詳しくは、このトピックより前の構成ファイルのセットアップのセクションを参照してください。

使用方法は以下のとおりです。

Usage: java -jar UDDIUtilityTools.jar {function} [options]

function:
  -promote <entity source>   Promote entities between registries
  -export <entity source>    Extract entities from registry to XML
  -delete <entity source>    Delete entities from registry
  -import                    Create entities from XML to registry

where <entity source> is one of:
  -tmodel|-business|-service|-binding <key> Specify single entity type and key
  -keysFile | -f <filename>  Specify file containing entity types and keys

options:
  -properties <filename>     Specify path to configuration file
  -overwrite | -o            Overwrite an entity if it already exists
  -log | -v                  Output verbose messages
  -definitionFile <filename> Specify path to UDDI entity definition file
  -importReferenced          Import entities referenced by source entities

The following options override property settings in configuration file:
  -overwrite
  -log
  -definitionFile
  -importReferenced

Example: java -jar UDDIUtilityTools.jar -promote -keysFile /uddikeys.txt

以下は、一連の UDDI ユーティリティー・ツールのコマンド行の例です

単一の business を、現在のディレクトリー内のプロパティー・ファイル で指定された EDF ファイルにエクスポートするには。
java -jar UDDIUtilityTools.jar -export -business 28B8B928-2B2E-4EC9-A647-1E40651E4752
上と同じですが、今度はキー・ファイルを使用してエクスポートするエンティティーを指定します。
java -jar UDDIUtilityTools.jar -export -keysFile /myKeyFiles/keyFile01.txt
上と同じですが、コマンド行への詳細出力の表示も指定します。
java -jar UDDIUtilityTools.jar -export -keysFile /myKeyFiles/keyFile02.txt -v
現在のディレクトリー内の UDDIUtilitiyTools.properties ファイルで指定された、デフォルトの EDF の内容をインポートするには。
java -jar UDDIUtilityTools.jar -import
上と同じですが、参照される tModel のターゲット・レジストリーへのインポートも指定します。
java -jar UDDIUtilityTools.jar -import -importReferenced
指定された場所の EDF からエンティティーをインポートするには。
java -jar UDDIUtilityTools.jar -import -definitionFile /myEDFs/entities01.xml
参照される tModel を含め、デフォルトの EDF からエンティティーをインポートするには。overwrite は、ターゲット・レジストリー内にある、参照される tModel を含まないエンティティーを、すべて上書きするように指定します。
java -jar UDDIUtilityTools.jar -import -overwrite -importReferenced
指定された場所にあるプロパティー・ファイルを使用して、ソースからの単一の service をターゲット・レジストリーにプロモートするには。
java -jar UDDIUtilityTools.jar -promote -service 67961D67-330F-4F14-8210-E74A58E710F3
-properties /UUT/myUUTProps.properties
キー・ファイル内で指定されたエンティティーのセットをプロモートするには。
java -jar UDDIUtilityTools.jar -promote -keysFile /myKeyFiles/keyFile03.txt
上と同じですが、ターゲット・レジストリー内の既存のエンティティーを上書きするように指定します。
java -jar UDDIUtilityTools.jar -promote -keysFile /myKeyFiles/keyFile04.txt -overwrite
参照される tModel を含め、キー・ファイル内で指定されたエンティティーのセットをプロモートするには。
java -jar UDDIUtilityTools.jar -promote -keysFile /myKeyFiles/keyFile05.txt -importReferenced
キー・ファイル内で指定されたエンティティーのセットをプロモートし、さらに、プロモートされたエンティティーを含む EDF を作成するには。
java -jar UDDIUtilityTools.jar -promote -keysFile /myKeyFiles/keyFile06.txt 
-definitionFile /myEDFs/entities02.xml
単一の tModel を論理的に削除するには。tModel を物理的に削除することはできない点に注意してください。
java -jar UDDIUtilityTools.jar -delete -tModel UUID:1E2B9D1E-E53D-4D36-9D46-6CCC176C466A
キー・ファイル内で指定されたすべてのエンティティーを削除するには。 例外の tModel を除き、その他のエンティティーは物理的にターゲット・レジストリーから削除される点に注意してください。
java -jar UDDIUtilityTools.jar -delete -keysFile /myKeyFiles/keyFile04.txt

キー・ファイルの例

以下は、ターゲット・レジストリーからエクスポート、プロモート、または削除されるキーの例です。
#
# Keys of entities to be exported, promoted from source registry or deleted from target registry
#
# Note: keys must be comma separated and on SAME line
# Note: property names are case sensitive. ('tmodels=' will be ignored)

businesses=97C77097-AC6C-4CA0-A6C4-452F7045C470, 4975E949-581F-4FCA-AD5F-E08280E05F9F
services=BB3864BB-1578-4833-8179-14391F14791F
bindings=
tModels=273F1727-7BFF-4FB5-A1FD-BA5C45BAFD9C

注: importReferenced プロパティーを true に設定した場合、referencedTModels セクション内の tModel のリストがターゲット・レジストリーにインポートされます。referencedTModel が新規に作成される場合は、最小エンティティーが作成されます。 referencedTModel がすでに存在している場合は、overwrite プロパティーの 値に関わらず、上書きされません。 これは、カテゴリー化 tModel などの頻繁に参照される tModel を、 不必要に最新の状態に保たないようにするためです。

referencedTModel を更新する必要がある場合は、エンティティー定義ファイル内の referencedTModel 定義を tModels セクションに手動で移動し、overwrite プロパティーを true に設定します。

ログ・ファイルの内容

以下は、ツールを実行することで作成される、2 つのログ・ファイルの内容の例です。ログ・ファイルの中で、大括弧で一部のコメントが加えられている点と、重要なポイントをイタリックで強調表示している点に注意してください。最初のものは、エクスポート、インポート、および削除関数で成功した操作と失敗した操作を示している messages.log です。
[29/07/04 17:39:57:531 BST] CWUDU0002I: ********** Starting UDDI Utility Tools ********** [timestamp and
 eyecatcher indicate when tool is run]
[29/07/04 17:39:57:531 BST] CWUDU0009I: Exporting entities...
[29/07/04 17:39:57:531 BST] CWUDU0015I: Exported 14 entities.
[29/07/04 17:39:57:531 BST] CWUDU0029I: Serializing...
[29/07/04 17:39:57:531 BST] CWUDU0030I: Serialized entities.
[29/07/04 17:39:57:531 BST] CWUDU0016I: Importing entities...
[29/07/04 17:39:57:531 BST] CWUDU0124I: Created tModel minimal entity with tModelKey [uuid:667e2766-4781-
4151-b3a0-809f7180a096].
[29/07/04 17:39:57:531 BST] CWUDU0121I: Created business minimal entity with businessKey [263f5526-8708-4
834-9f5d-8f8c878f5d6e].
[29/07/04 17:39:57:531 BST] CWUDU0122I: Created service minimal entity with serviceKey [0af2a30a-be70-401
f-a027-331a6c332712].
[29/07/04 17:39:57:531 BST] CWUDU0122I: Created service minimal entity with serviceKey [61012761-d02c-4c7
0-ae98-435ffd4398f9].
[29/07/04 17:39:57:531 BST] CWUDU0123I: Created binding template minimal entity with bindingKey [f97af9f9
-7cb7-47bd-8b90-b55e4db590df].
[29/07/04 17:39:57:531 BST] CWUDU0123I: Created binding template minimal entity with bindingKey [17e4c017
-d273-43ec-af4a-f9b841f94a30].
[29/07/04 17:39:57:531 BST] CWUDU0123I: Created binding template minimal entity with bindingKey [9e2c239e
-3b30-40a9-9c25-ce64edce25b9].
[29/07/04 17:39:57:531 BST] CWUDU0121I: Created business minimal entity with businessKey [49bb6949-4b0e-4
e81-88a7-e26bfbe2a7f1].
[29/07/04 17:39:57:531 BST] CWUDU0122I: Created service minimal entity with serviceKey [003d2b00-f6c0-407
1-8b84-f235a2f28445].
[29/07/04 17:39:57:531 BST] CWUDU0123I: Created binding template minimal entity with bindingKey [df1019df
-2d2f-4f32-bf18-4f21274f1835].
[29/07/04 17:39:57:531 BST] CWUDU0123I: Created binding template minimal entity with bindingKey [b229aeb2
-f2b1-4115-a06f-536753536f10].
[29/07/04 17:39:57:531 BST] CWUDU0122I: Created service minimal entity with serviceKey [84d8e584-2510-409
9-9b2a-6023f1602a0a].
[29/07/04 17:39:57:531 BST] CWUDU0123I: Created binding template minimal entity with bindingKey [62a9a762
-7fff-4f7a-8463-af0c79af63ee].
[29/07/04 17:39:57:531 BST] CWUDU0123I: Created binding template minimal entity with bindingKey [e08654e0
-b212-42c0-bcf3-655e9765f392].
[29/07/04 17:39:57:531 BST] CWUDU0115I: Imported 7 entities and 0 referenced entities. [this kind of message indicates the operation worked!]
[29/07/04 17:39:57:531 BST] CWUDU0002I: ********** Starting UDDI Utility Tools **********
[29/07/04 17:39:57:531 BST] CWUDU0023I: Deleting entities...
[29/07/04 17:39:57:531 BST] CWUDU0028I: Deleted 7 entities.

2 番目は、エクスポートの典型的なトレース・ログ・ファイル項目を示しているログ・ファイルです。
[29/07/04 17:39:57:531 BST] ********** Starting UDDI Utility Tools ********** [eyecatcher and timestamp indicate when tool is run]
[29/07/04 17:39:57:531 BST] > com.ibm.uddi.promoter.PromoterAPI.setUddiEntities()  [the '>' indicates 
entry to the constructor of this class]
[29/07/04 17:39:57:531 BST] > com.ibm.uddi.promoter.export.KeyFileReader() 
[29/07/04 17:39:57:531 BST]   com.ibm.uddi.promoter.export.KeyFileReader() loaded tModel keys
[29/07/04 17:39:57:531 BST]   com.ibm.uddi.promoter.export.KeyFileReader() loaded business keys
TransformConfiguration:
  nameSpacePrefix=promote
  uddiEntityDefinitionFile=C:¥temp/MigToolFiles/Results/Promote_api_EDF_1.xml

ExportConfiguration:
  fromGetURL=http://yottskry:9080/uddisoap/
  fromInquiryURL=http://yottskry:9080/uddisoap/inquiryAPI

ImportConfiguration:
  overwrite=true
  uddiEntityDefinitionFile=C:¥temp/MigToolFiles/Results/Promote_api_EDF_1.xml
  importReferencedEntities=true

PublishConfiguration:
  toInquiryURL=http://davep:9080/uddisoap/inquiryAPI
  toPublishURL=http://yottskry:9080/uddisoap/publishAPI
  userID=Publisher1
  trustStoreFileName=C:¥WebSphere600/AppServer/etc/DummyClientTrustFile.jks
  secureConnection=false

DatabaseConfiguration:
  dbDriver=COM.ibm.db2.jcc.DB2Driver
  dbURL=jdbc:db2:LOC1
  dbUser=db2admin

LoggerConfiguration:
  messageStream=null
  messageLogFileName=C:¥temp/MigToolFiles/logs/message.log
  traceLogFileName=C:¥temp/MigToolFiles/logs/trace.log
  traceLevel=3
  verbose=true


[29/07/04 17:39:57:531 BST] < com.ibm.uddi.promoter.PromoterAPI() 
[29/07/04 17:39:57:531 BST] ********** Starting UDDI Utility Tools **********
[29/07/04 17:39:57:531 BST] > com.ibm.uddi.promoter.PromoterAPI.setUddiEntities() 
[29/07/04 17:39:57:531 BST] > com.ibm.uddi.promoter.export.KeyFileReader() 
[29/07/04 17:39:57:531 BST]   com.ibm.uddi.promoter.export.KeyFileReader() loaded tModel keys [ log
entries without a '>' or '<' are status messages only ]
[29/07/04 17:39:57:531 BST]   com.ibm.uddi.promoter.export.KeyFileReader() loaded business keys
[29/07/04 17:39:57:531 BST]   com.ibm.uddi.promoter.export.KeyFileReader() loaded service keys
[29/07/04 17:39:57:531 BST]   com.ibm.uddi.promoter.export.KeyFileReader() loaded binding keys
[29/07/04 17:39:57:531 BST] > com.ibm.uddi.promoter.UddiEntityKeys() 
[29/07/04 17:39:57:531 BST] < com.ibm.uddi.promoter.UddiEntityKeys() [the '<' indicates exit from the constructor]
[29/07/04 17:39:57:531 BST]   com.ibm.uddi.promoter.export.KeyFileReader() removed duplicate, empty and null keys
[29/07/04 17:39:57:531 BST] < com.ibm.uddi.promoter.export.KeyFileReader() 
[29/07/04 17:39:57:531 BST] < com.ibm.uddi.promoter.PromoterAPI.setUddiEntities() 
[29/07/04 17:39:57:531 BST] > com.ibm.uddi.promoter.PromoterAPI.deleteEntities() 
[29/07/04 17:39:57:531 BST] > com.ibm.uddi.promoter.publish.EntityDeleter() 
[29/07/04 17:39:57:531 BST] < com.ibm.uddi.promoter.publish.EntityDeleter() 
[29/07/04 17:39:57:531 BST] > com.ibm.uddi.promoter.UDDIClient() 
[29/07/04 17:39:57:531 BST]   com.ibm.uddi.promoter.UDDIClient() client type: 1

API からの UDDI ユーティリティー・ツールの始動

UDDI ユーティリティー・ツールは、UDDI エンティティーのエクスポート、インポート、プロモート、検索、削除の関数にパブリック API を提供します。 これらの関数はすべて、PromoterAPI クラスを使用して起動できます。これらの関数を実行するこのクラスは、 通常、以下の目的で使用します。
  1. 構成オブジェクトを作成し、プロパティー・オブジェクトまたは構成プロパティー・ファイルから移植します。
  2. PromoterAPI オブジェクトを作成し、コンストラクター内の構成を渡します。
  3. キーを基にした関数 (エクスポート、削除、およびプロモート) の場合、UDDIEntityKeys オブジェクトやキー・ファイルの場所を提供するか、単一のエンティティーの場合はエンティティー・タイプとキー値を指定して、キーを設定します。
  4. 必要な関数 (exportEntities、promoteEntities(boolean)、importEntities、deleteEntities または extractKeysFromInquiry(FindTModel、FindBusiness、FindService、FindBinding、FindRelatedBusinesses)) に対応するメソッドを呼び出します。

UDDI ユーティリティー・ツールには、 API クラスの使用の実例を説明するサンプル・コードがいくつかあり、 Samples Central から入手できます。

このリリースでは、 「低レベルの」API クラスとメソッドは使用すべきではありません。 詳しくは、API 資料を参照してください。

UDDI ユーティリティー・ツールに関する既知の制限と予備手段

UDDI ユーティリティー・ツールには幾つかの既知の制限があり、それぞれに予備手段があります。 詳しくは、UDDI トラブルシューティングのヒントを参照してください。

組み込み Cloudscape の制限事項

組み込み Cloudscape データベースを使用してソース・レジストリーを参照する場合の「エクスポート」および「削除」機能がサポートされています。ただし、ターゲット・レジストリーを 参照している場合の「インポート」および「プロモート」機能は、組み込み Cloudscape データ ベースを使用する際の UDDI レジストリーの制限があるため、 サポートされていません。「プロモート」および「インポート」機能を有効にするには、 組み込み Cloudscape データベースでネットワークを使用可能にする必要がありますCloudscape バージョン 5.1.60x の構成を 参照してください

指定されたキーによるバージョン 3 エンティティーの保管

バージョン 3 のビジネスを定義済みキーを使用して保管する場合の例を以下に示します。

<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
  <Body>
    <save_business xmlns="urn:uddi-org:api_v3">
      <authInfo>a399c4a3-6387-47cd-a1bd-91f7bb91bdd7</authInfo>
      <businessEntity businessKey="uddi:mycompany-p1.com:computers">
        <name xml:lang="en">WithKey</name>
      </businessEntity>
    </save_business>
  </Body>
</Envelope>

UDDI ユーティリティー・ツールに関する既知の制限と予備手段

UDDI ユーティリティー・ツールには既知の制限があり、それぞれの制限事項には回避策があります。
  • PublisherAssertions はサポートされていないので、プロモートされません。

    回避策: 関連のあるビジネスをプロモートした後に、 publisherAssertion の関係を再作成してください。

  • サービスの展開で参照されるビジネスは、 参照される tModels と同じ方法では自動的に EDF に追加されません。

    次善策: 計画されるサービスを「所有」することになる参照ビジネスを EDF に追加します。 ターゲット・レジストリーにビジネスが存在しない場合は、EDF でサービスがビジネスを所有する前に、 ビジネスを配置する必要があります。

  • サービスの展開のサイクル検出は、 参照される tModels と同じ方法では検出されません。

    次善策: 2 つ以上のサービスの展開の間に循環参照が存在する場合は、 展開のうちの 1 つを一時的に除去することによりサイクルを中断し、インポートを実行し、 変更されたエンティティーを更新してターゲット・レジストリーにサイクルを再確立します。

  • ソース・レジストリー内で (論理的な意味で) 削除された tModel は、ターゲット・レジストリーにインポートされ、 削除の取り消しとしてプロモートされます。これは、UDDI バージョン 2 仕様では、 tModel の削除状態は API 呼び出しとして公開されないためです。

    次善策: tModel のインポートの後に、削除を実行してください。 これは、UDDI ユーティリティー・ツールの削除機能、または、 その他の UDDI レジストリー API アクセス・メソッドを使用して実行します。

  • hostingRedirectors が参照する BindingTemplates は、 参照される tModel と同じ方法では自動的に EDF に追加されません。

    次善策: 参照される bindingTemplate を EDF に追加します。

  • 'owningBusiness' keyedReference が参照するビジネスは、 自動的には EDF に追加されません。

    次善策: ビジネスを参照する tModel をインポートする前に、 参照されるビジネスをターゲット・レジストリーにインポートします。

  • [バージョン 6.0] [バージョン 6.0.1] JSSE プロバイダー・クラスは構成できません。 このクラスは com.ibm.jsse.IBMJSSEProvider でなければなりません。
  • コマンド行引数のいくつかの組み合わせは、その妥当性を検査されて阻止されることはありません。例えば、同一コマンドで -import-keysFile <path to file> を指定することができますが、-keysFile は無視されます。



関連タスク
UDDI レジストリーの使用
関連資料
UDDI レジストリー管理インターフェース
参照トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 10:52:11 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/rwsu_utility_tool.html