|
|
Harvester は、次の .zip ファイルの Oracle Enterprise Repository 10.3 のインストールにバンドルされている Harvester Solution Pack から入手できます。
<BEA_HOME>/repository103/core/tools/solutions/OER103-SOA-BPM-Harvester.zip
このマニュアルでは、OER103-SOA-BPM-Harvester.zip ファイルを展開したディレクトリを <Harvester ホーム> ディレクトリとしています。
コマンド ライン用に Harvester をコンフィグレーションするには、次の手順に従います。
<Harvester ホーム> にある IntrospectorSettings.xml という XML ファイルを開き、適切な資格を持つ Oracle Enterprise Repository インスタンスを Harvester が 参照するように変更します。
<repository>
<uri>http://localhost:7101/aler</uri>
<credentials>
<user>smith</user>
<password>oeruser</password>
</credentials>
<timeout>30000</timeout>
</repository>
また、次に示すように、コマンド ライン ユーティリティにリポジトリ接続情報をパラメータとして渡すこともできます。
C:\test\harvester> introspect -url http://localhost:7101/aler -user admin -password admin -dir c:\test\samples
Harvester は、introspect.bat ユーティリティを使用してコマンド ラインから実行できます。
表 2-1 は、Harvester コマンド ライン ユーティリティを使用して指定できるオプションを示しています。
図 2-1 は、introspect -h コマンドで表示されるコマンド ライン ユーティリティのオプションとオンライン ヘルプを示しています。
すべてのコマンド ライン オプションは必須ではありません。省略可能です。
オプションを省略すると、Harvester では、introspect.bat が格納されている <Harvester ホーム> ディレクトリにある IntrospectorSettings.xml ファイルの情報を使用します。コマンド ラインでオプションを指定すると、それらのオプションによって IntrospectorSettings.xml の設定がオーバーライドされます。
<Harvester ホーム> にある IntrospectorSettings.xml ファイルを使用して収集対象のアーティファクトを参照するには、次のように XML を変更します。
<query>
<fileQuery>
<rootDir>C:\samples</rootDir>
<files>BPEL</files>
</fileQuery>
</query>
一般的な統合開発環境 (IDE) には、Apache Ant ビルド システムとの統合がバンドルされています。このような統合には、カスタム Ant タスク (Harvester から提供されるタスクなど) を呼び出すための便利なメカニズムが用意されています。Harvester をさまざまな IDE と統合する方法の例については、Oracle Technology Network (http://www.oracle.com/technology) の記事を参照してください。
Harvester に用意されている repository.submit Ant タスクを使用すると、BPEL ファイルを収集して Oracle Enterprise Repository にインポートできます。このタスクは、<Harvester ホーム> ディレクトリ (Harvester Solution Pack の解凍先ディレクトリ) にある introspect-tasks.xml ファイルで定義できます。
表 2-2 は、introspect-tasks.xml ファイルの repository.submit Ant タスクに指定できるパラメータを示しています。
fileSet は、収集するファイルのセットの選択に使用されます。1 つまたは複数の fileSet を指定する必要があります。
Harvester では、.zip 形式のファイル (.zip、.jar、.ear の各ファイルなど) を含め、fileSet で選択されたすべてのファイルを調べます。
コード リスト 2-1 に示す Ant repository.submit タスクでは、Harvester は fileSet ディレクトリ (/tmp/components ディレクトリ) の下位にあるすべてのファイルとディレクトリを調べ、それらを Oracle Enterprise Repository にインポートします。
<repository.submit repositoryurl=”http://server.example.com:8080/oer”
repositoryusername=”myuser”
registrypassword=”mypassword”
settingsFile=”../MyCustomSettings.xml”>
<fileset dir=”/tmp/components/”>
<include name=”**/*”/>
</fileset>
</repository.submit>
Harvester Ant タスクをインポートするには、Ant XML に次の行を追加します。
<taskdef file=”${harvester.dir}/introspect-tasks.xml” />
ここで、harvester.dir は Harvester Solution Pack の解凍先の <Harvester ホーム> ディレクトリです。
コマンド ラインからの実行時には、Ant の -lib コマンド ライン スイッチを使用して、Harvester のライブラリを Ant で使用できることを確認してください。たとえば、次のように指定します。
ant -lib <Harvester ホーム> -lib <Harvester ホーム>/lib -f mybuild.xml
ここで、<Harvester ホーム> は Harvester Solution Pack の解凍先のディレクトリです。
<Harvester ホーム> ディレクトリにある XML ファイル IntrospectorSettings.xml の以下の追加のコンフィグレーション設定を必要に応じて変更できます。
Harvester では、実行されるタスクの詳細のロギングに log4j を使用します。ログ ファイルは <Harvester ホーム> ディレクトリに保存されます。ロギングのオプションは、<Harvester ホーム> ディレクトリにある log4fl.properties ファイルを更新することにより変更できます。
Harvester 機能におけるトランザクション処理は、以下のルールに基づいています。
1 つの処理が cmee.extframework.impexp.monitor.rex.maxidle (maxidle) の設定を超過すると、後続のすべての処理が失敗する可能性があります。その場合、ログの最後のエラーには「'An error occurred while attempting to rollback because a transaction has not been started.'」と記録されます。これは、トランザクション文が maxidle を超過すると、トランザクションが自動的にロールバックするためです。クライアント アプリケーションが強制的にロールバックを試行すると、トランザクションを使用できなくなり、エラーが検出されます。その結果、Harvester の処理によるデータは Oracle Enterprise Repository に追加されません。
  
|