|
Bulk Loader は、トレーディング パートナ管理 (TPM) データをインポート、エクスポート、および削除するために使用するコマンドライン ツールです。このデータには、トレーディング パートナ プロファイル、キーストアから取得する証明書、サービス定義、およびサービス プロファイルが含まれます。Bulk Loader では、TPM データの XML 表現がインポートされ、XML ファイルがエクスポートされます。XML 入力ドキュメントの検証は、XSD スキーマを使って行われます。Bulk Loader は、XML コンフィグレーション ファイル (blconfig.xml
) を使って、データベースと証明書キーストアに接続するためのパラメータを取得します。この処理で Bulk Loader がエラーを検出した場合は、エラー ログが作成されます。
次の節では、Bulk Loader の使用について説明します。
Bulk Loader コマンドライン ツールは、WebLogic Integration サーバが実行されていない場合のみ使用します。WebLogic Integration サーバが実行されている場合は、データベース内の TPM データに対するすべてのコンフィグレーション変更を WebLogic Integration Administration Console から実行する必要があります。WebLogic Integration Administration Console では、インポート、エクスポート、一括削除の各操作を実行することもできます。WebLogic Integration Administration Console でこれらの操作を行うことにより、WebLogic Integration ドメインで実行されている各サーバの内部 TPM メモリ キャッシュにおける TPM データの整合性が保証されます。
管理データのインポート、エクスポート、および削除の方法については、『WebLogic Integration Administration Console の使用』にある以下の節を参照してください。
リポジトリ データとトレーディング パートナ コンフィグレーションをインポートおよびエクスポートする際に、Bulk Loader によって 2 つの XSD スキーマを使ってインポートまたはエクスポートされる XML ドキュメントが検証されます。1 つはトレーディング パートナ情報を指定する TPM.xsd
、もう 1 つはデータベースとキーストアの情報およびトランザクション処理のオプションを指定する BulkLoaderConfig.xsd
です。この 2 つのスキーマは、2001 XML スキーマ定義 (XML Schema Definition : XSD) に基づいています。
TPM.xsd
スキーマと BulkLoaderConfig.xsd
スキーマは、どちらも jpd.jar
ファイル内の schema/src
ディレクトリにあります。これらのファイルは次のディレクトリにあります。
BEA_HOME/weblogic92/server/lib
上記の BEA_HOME
は、WebLogic Platform のホーム ディレクトリを表します。
TPM.xsd
ファイル内のトレーディング パートナ管理データを構成するエンティティと要素については、「TPM スキーマ」を参照してください。
BulkLoaderConfig.xsd
でのキーストア情報とトランザクション処理オプションの設定については、「トランザクション処理のオプション」および「証明書要素のインポートとエクスポート」を参照してください。
Bulk Loader は、コンフィグレーション ファイル (blconfig.xml
) を使って、データベースおよび証明書キーストアに接続するためのパラメータを取得します。Bulk Loader を使用する前に、このファイルをデータベースと一致するように変更する必要があります。
blconfig.xml
コンフィグレーション ファイルは、次のディレクトリにあります。
BEA_HOME\weblogic92\integration\bin
上記の BEA_HOME
は、WebLogic Platform 9.2 のホーム ディレクトリを表します。
<?xml version="1.0" encoding="UTF-8"?>
<bulkloader-config
xmlns="http://www.bea.com/2003/03/wli/tpm/bulkloader"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.bea.com/2003/03/wli/tpm/bulkloader BulkLoaderConfig.xsd">
<database-info>
<!-- Modify the following to match your database installation -->
<url>jdbc:pointbase://localhost:9093/workshop</url>
<driver>com.pointbase.jdbc.jdbcUniversalDriver</driver>
<userid>weblogic</userid>
<password>weblogic</password>
</database-info>
<encoding>UTF-8</encoding>
</bulkloader-config>
BEA_HOME\weblogic92\integration\bin
上記の BEA_HOME
は、WebLogic Platform 9.2 のホーム ディレクトリを表します。
bulkloader [-verbose] [-config <blconfig.xml>] [-wlibc]
-export <data.xml> [-nokeyinfo] [-select <selector.xml>]
次の表は、Bulk Loader のコマンドのオプションをまとめたものです。
|
|
-select オプションではセレクタ ファイルを指定し、selector.xml ではエクスポートされるデータの型を指定する。selector.xml ファイルを使用して、すべてのトレーディング パートナまたは選択したトレーディング パートナのみをエクスポートできる。このファイルでは、すべてのサービスまたは選択したサービスをエクスポートするように指定することもできる。このファイルは TPM.xsd スキーマに準拠していなければならない。
|
|
|
Bulk Loader を使用して、証明書データを含めたトレーティング パートナ管理情報をインポートまたはエクスポートすることができます。Bulk Loader では、TPM データの XML 表現がインポートされ、XML ファイルがエクスポートされます。証明書をインポートまたはエクスポートする場合は、事前に「証明書要素のインポートとエクスポート」の説明に従って blconfig.xml
ファイルを変更する必要があります。トレーディング パートナ情報をインポートおよびエクスポートする方法について、次のトピックで説明します。
エラーが発生した場合や大きなリポジトリを操作する場合は、BulkLoaderConfig.xsd
スキーマに含まれている 2 つの属性を使ってトランザクション処理をコントロールすることができます。2 つの属性とは、transaction-level="all"
と transaction-level="default"
です。これらは <bulkloader-config>
ルート要素の下にあります。これらのオプションによって、WebLogic Integration Administration Console で提供されている機能と同じ機能を利用できます。
属性 transaction-level="all"
を指定すると次の処理が実行されます。
属性 transaction-level="default"
を指定すると次の処理が実行されます。
selector.xml
ファイルに指定されたデータがエクスポートされる。このファイルは TPM.xml
スキーマに準拠していなければなりません。
この節では、トレーディング パートナ管理データのインポートとエクスポートについて説明します。
TPM ファイルをインポートまたはエクスポートする前に、以下の事項に該当していることを確認してください。
BEA_HOME
/weblogic92/integration/bin
上記の BEA_HOME
は、WebLogic Platform のホーム ディレクトリを表します。
bulkloader [-verbose] [-config <blconfig.xml>] [-wlibc]
-import <data.xml>
-export <data.xml> [-nokeyinfo]
[-select <selector.xml>]
次に示すのは、WebLogic Integration - Business Connect からエクスポートされたトレーディング パートナ XML ファイルをインポートする例です。
bulkloader -wlibc -import d:\tradingpartners\profiles\WorldWideTrading.xml
次に示すのは、リモート トレーディング パートナから提供されたサービスをエクスポートする例です。
bulkloader -config myconfig.xml -export exports\NationalTradingServices.xml -select selectors\NationalTradingSelector.xml
注意 : | インポートできるのはリモート トレーディング パートナの証明書だけです。ローカル トレーディング パートナの証明書はインポートできません。 |
証明書のインポートとエクスポートは、他のトレーディング パートナ プロファイル情報と同様に、XML フォーマットで行われます。証明書の XML 表現は、W3C の XML-Signature Syntax and Processing 勧告に指定されている証明書のフォーマットに準拠しています。この勧告は次の URL で公開されています。
http://www.w3.org/TR/xmldsig-core/#sec-KeyInfo
Bulk Loader では、証明書データと公開鍵のインポートとエクスポートのみがサポートされます。証明書のプライベート キーはインポートまたはエクスポートされません。プライベート キーは管理者が手動で転送する必要があります。キーストア関連情報は、Bulk Loader コンフィグレーション ファイル (blconfig.xml
) から読み込まれます。
注意 : | WebLogic Server キーストアの詳細については、『Administration Console オンライン ヘルプ』の「[WebLogic Keystore Provider] --> [一般]」を参照してください。 |
入力 XML ファイルに、トレーディング パートナの証明書要素が <ds:KeyInfo>
サブ要素と共に含まれている場合は、指定された certificate-key
データが Bulk Loader コンフィグレーション ファイルに指定されている適切なキーストアに追加されます。
Bulk Loader コンフィグレーション スキーマ (BulkLoaderConfig.xsd
) には、キーストア コンフィグレーション情報が含まれています。これはスキーマの省略可能な要素です。次に示すのは、keystore-info
要素に関するスキーマ定義からの抜粋です。
<xs:element name="keystore-info">
<xs:complexType>
<xs:sequence>
<xs:element name="path" type="xs:string"/>
<xs:element name="password" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="encoding" type="xs:string"/>
データベースとキーストアのパスワードは、最初にクリア テキストで blconfig.xml
ファイルに入力することができます。操作が正常に終了すると、Bulk Loader によってパスワードが暗号化され、blconfig.xml
ファイルに暗号化されたパスワードが再び書き込まれます。
path
要素は、Java キーストアへの絶対パスです。password 要素はキーストアのパスワードです。
次に示すのは、キーストア情報を含む Bulk Loader コンフィグレーション ファイルの例です。
<?xml version="1.0" encoding="UTF-8"?>
<bulkloader-config
xmlns="http://www.bea.com/2003/03/wli/tpm/bulkloader"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.bea.com/2003/03/wli/tpm/bulkloader
BulkLoaderConfig.xsd">
<database-info>
<url>jdbc:pointbase://localhost:9094/WLIDB</url>
<driver>com.pointbase.jdbc.jdbcUniversalDriver</driver>
<userid>PBPUBLIC</userid>
<password>PBPUBLIC</password>
</database-info>
<keystore-info>
<path>D:\test\peer1KeyStore.pks</path>
<password>peer1<password>
</keystore-info>
</bulkloader-config>
次に示すのは、インポート/エクスポート フォーマットでのクライアント証明書を伴うトレーディング パートナ情報の例です。
<trading-partner
name="ebxml-sender"
type="REMOTE"
status="ENABLED">
<client-certificate name="peer1-en">
<KeyInfo>
<KeyName>1.2.840.113549.1.9.1=#160d7065657231406265612e636f6d,
CN=localhost.peer1-en.crt,OU=ECI Division,O=BEA Systems,
ST=California,C=US
</KeyName>
<KeyValue>
<RSAKeyValue>
<Modulus>t/kDK6Jezk2e31k2nMQMagPuXsC56df18YW0KRqQa89Q7o/
H8O8m6LdOH5H0GyYEUBD+jN08lgZqCQMDAZCG6w==</Modulus>
<Exponent>AQAB</Exponent>
</RSAKeyValue>
</KeyValue>
<X509Data>
<X509SubjectName>1.2.840.113549.1.9.1=#160d7065657231406265612e636f6d,
CN=localhost.peer1-en.crt,OU=ECI Division,O=BEA Systems,
ST=California,C=US</X509SubjectName>
<X509IssuerSerial>
<X509IssuerName>1.2.840.113549.1.9.1=#1610676172696d656c73406265612e636f6,
CN=luke.bea.com,OU=WLC Luke,O=ECI Division\, BEA Systems Inc,
L=San Jose,ST=California,C=US</X509IssuerName>
<X509SerialNumber>DQ==</X509SerialNumber>
</X509IssuerSerial>
<X509Certificate>MIICQzCCAe2gAwIBAgIBDTANBgkqhkiG9w0BAQQFADCBqDELMAkGA1UEB
hMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExETAPBgNVBAcTCFNhbiBKb3NlMSYwJAYDVQQKEx1
FQ0kgRGl2aXNpb24sIEJFQSBTeXN0ZW1zIEluYzERMA8GA1UECxMIV0xDIEx1a2UxFTATBgNVB
AMTDGx1a2UuYmVhLmNvbTEfMB0GCSqGSIb3DQEJARYQZ2FyaW1lbHNAYmVhLmNvbTAeFw0wMjA
xMDEwMDAwMDBaFw0wMzAxMDEwMDAwMDBaMIGOMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2Fsa
WZvcm5pYTEUMBIGA1UEChMLQkVBIFN5c3RlbXMxFTATBgNVBAsTDEVDSSBEaXZpc2lvbjEfMB0
GA1UEAxMWbG9jYWxob3N0LnBlZXIxLWVuLmNydDEcMBoGCSqGSIb3DQEJARYNcGVlcjFAYmVhL
mNvbTBcMA0GCSqGSIb3DQEBAQUAA0sAMEgCQQC3+QMrol7OTZ7fWTacxAxqA+5ewLnp1/XxhbQ
pGpBrz1Duj8fw7ybot04fkfQbJgRQEP6M3TyWBmoJAwMBkIbrAgMBAAGjGjAYMAkGA1UdEwQCM
AAwCwYDVR0PBAQDAgXgMA0GCSqGSIb3DQEBBAUAA0EAA8QAs20bOFvebMd6mU6ui7lAYZd+5+d
OhTU0R03VgY35ZQXzyaOH7GtMHNOomFqKaRdckwAi75FZTuAfKVYJfw==
</X509Certificate>
</X509Data>
</KeyInfo>
</client-certificate>
</trading-partner>
注意 : | Bulk Loader では、WebLogic Integration - Business Connect エクスポート ファイルからの証明書のインポート、および Business Connect で使用できる形式での証明書のエクスポートも行われます。 |
Bulk Loader では、管理データを一括削除することができます。削除操作では、入力セレクタ ファイルに基づいてトレーディング パートナ情報が削除されます。選択されたリーフ要素およびその要素に関連するリンクされたすべての子要素が削除されます。たとえば、特定のトレーディング パートナをリポジトリから削除すると、子要素である証明書、バインディング、転送、認証もすべて削除されます。
<?xml version="1.0" encoding="UTF-8"?>
<trading-partner-management
xmlns="http://www.bea.com/2003/03/wli/tpm"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.bea.com/2003/03/wli/tpm TPM.xsd">
... ここに XML で削除する要素を指定する ...
</trading-partner-management>
BEA_HOME
/weblogic92/integration/bin
上記の BEA_HOME
は、WebLogic Platform のホーム ディレクトリを表します。
bulkloader [-verbose] [-config <blconfig.xml>] [-wlibc] -delete <selector.xml>
これらのオプションの説明については、表 5-1 を参照してください。