| Oracle® Fusion Middleware Oracle SOA Suite開発者ガイド 11gリリース1 (11.1.1.9) B56238-11 |
|
 前 |
 次 |
この章では、SOAコンポジット・アプリケーションのデプロイメントのライフ・サイクルについて説明します。さらに、Oracle JDeveloperおよびantスクリプト・ツールを使用して1つのコンポジット、複数のコンポジット、およびWSDL、XSD、他のファイル・タイプなどの共有データを使用するコンポジットをデプロイする方法、および異なる環境の間でSOAコンポジット・アプリケーションを移動するための構成プランを作成する方法についても説明します。ここでは、デプロイメントの前提条件、パッケージ化、準備および構成タスクについても説明します。また、Oracle WebLogic Scripting Tool (WLST)ユーティリティを使用したデプロイに関するドキュメントへの参照についても記載します。
この章では、次の項目について説明します。
Oracle Enterprise Manager Fusion Middleware ControlからSOAコンポジット・アプリケーションをデプロイする手順は『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』、WLSTユーティリティを使用してSOAコンポジット・アプリケーションをデプロイする手順はOracle Fusion Middleware WebLogic Scripting Toolのコマンド・リファレンスを参照してください。
この章では、デプロイメントのライフ・サイクルに関する次の項目について説明します。
デプロイメントの前提条件
パッケージ化の詳細
コンポジットの構造
ターゲット環境の準備
ターゲット環境の構成タスク
コンポジットのデプロイメント
デプロイメント後の構成タスク
コンポジット・アプリケーションのテストおよびトラブルシューティング
デプロイメントのライフ・サイクルの詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。
この項では、SOAコンポジット・アプリケーションの作成とデプロイに必要な基本的な前提条件を説明します。
Oracle SOA Suiteコンポーネントにはスキーマが必要です。このスキーマはOracleまたはMicrosoft SQL Serverのデータベースにインストールされている必要があります。スキーマの作成とロードは、リポジトリ作成ユーティリティ(RCU)を使用してデータベース内で行います。スキーマのインストールおよび構成の詳細は、Oracle Fusion Middleware Oracle SOA Suiteインストレーション・ガイドおよび『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。
インストール後は、Oracle Fusion Middleware構成ウィザードを使用して、新しいOracle WebLogic Serverドメインを作成および構成し、そのドメイン内で構成する製品(Oracle SOA Suiteなど)を選択します。この新しいドメインには、構成する製品に応じて、管理サーバーおよびその他の管理対象サーバーが含まれます。詳細は、『Oracle Fusion Middleware Oracle SOA Suiteインストレーション・ガイド』を参照してください。
SOAコンポジット・アプリケーションはクラスタ化された環境にもデプロイできます。クラスタ化された環境の作成および構成の詳細は、『Oracle Fusion Middleware高可用性ガイド』を参照してください。
SOAコンポジット・アプリケーションのプロジェクト内で必要なすべてのアーティファクト・ファイルは、次のツールを使用してSOAアーカイブ(SAR) JARファイルに個別にパッケージ化できます。
Oracle JDeveloper
「デプロイメント・アクション」ページでのデプロイ時に、「SARにデプロイ」オプションを選択します。詳細は、第43.7.1.3項「プロファイルのデプロイ」を参照してください。
antスクリプト
ant-sca-packageスクリプトを使用して、アーティファクトをパッケージ化します。詳細は、第43.7.6.3項「コンポジットSARファイルにSOAコンポジット・アプリケーションをパッケージ化するためのantの使用方法」を参照してください。
WLSTコマンド
sca_packageスクリプトを使用して、アーティファクトをパッケージ化します。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。
SARファイルは、接頭辞sca_が必要な特別なJARファイルです(例: sca_HelloWorld_rev1.0.jar)。
さらに、Oracle JDeveloperの「デプロイメント・アクション」ページで「アプリケーション・サーバーへのデプロイ」オプションを選択してSOAコンポジット・アプリケーションをデプロイする場合、プロジェクト内で必要なすべてのアーティファクト・ファイルは次のいずれかのファイルに自動的にパッケージ化されます。
自己完結型のJARファイル(単一のSOAコンポジット・アプリケーションの場合)
自己完結型のコンポジットの詳細は、第43.7.1項「Oracle JDeveloperでの単一のSOAコンポジットのデプロイ方法」および第43.7.2項「Oracle JDeveloperでの複数のSOAコンポジット・アプリケーションのデプロイ方法」を参照してください。
メタデータを相互に共有する複数のSOAコンポジット・アプリケーションのZIPファイル
SOAコンポジット・アプリケーション間で共有データをデプロイして使用できます。共有データは、アプリケーション・サーバー上のSOAインフラストラクチャに、Oracle Metadata Services (MDS)リポジトリのアーカイブJARファイルとしてデプロイされます。このアーカイブ・ファイルには、すべての共有リソースが含まれています。詳細は、第43.7.3項「Oracle JDeveloperでの複数のSOAコンポジット・アプリケーション間の共有データのデプロイ方法および使用方法」を参照してください。
Oracle JDeveloperでSOAコンポジット・アプリケーションをデプロイすると、そのコンポジットはJARファイル(単一のコンポジット・アプリケーションの場合)またはZIPファイル(複数のSOAコンポジット・アプリケーションの場合)にパッケージ化されます。これらのファイルには、次のアーティファクトを含めることができます。
バインディング・コンポーネントおよびサービス・コンポーネント。
Oracle B2Bアグリーメント、Oracle Web Service Manager (OWSM)のポリシー、およびヒューマン・ワークフロー・タスク・フローへの参照。
WSDLファイル、XSDファイルなどの共有データ。すべての共有データは、サーバー上の既存のSOAインフラストラクチャ・パーティションにデプロイされます。このデータは、/appsネームスペースの下にデプロイされます。Oracle JDeveloperでSOA-MDS接続を使用してこのアーティファクトを参照する場合、URLには接頭辞oramdsが付加されます。
ターゲット環境とは、SOAコンポジット・アプリケーションをデプロイする先のSOAインフラストラクチャ環境です。この環境は通常、開発、テストまたは本番の環境です。あるターゲット環境から別のターゲット環境にアプリケーションを移動するときは、コンポジット・アプリケーションで使用しているコンポーネント、アイデンティティ・サービス・プロバイダおよびセキュリティ・ポリシーに応じて、追加の構成ステップが必要になる場合があります。この項では、それらのタスクについて説明します。
Java Database Connectivity (JDBC)データ・ソースは、JDBC接続のプールが含まれているJava Naming and Directory Interface (JNDI)ツリーにバインドされているオブジェクトです。アプリケーションでは、JNDIツリーでデータ・ソースを参照し、そのデータ・ソースからのデータベース接続を予約できます。送信メッセージをエンキューしたり受信メッセージをデキューするためのキューを作成します。表43-1に示すOracle JCAアダプタには、デプロイメントの前に、JDBCデータ・ソースおよびキューを構成する必要があります。
表43-1 Oracle JCAアダプタのタスク
| アダプタ | 構成タスク | 参照項目 |
|---|---|---|
|
データベース・アダプタ |
JDBCデータ・ソース |
『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』のデプロイメントに関する項 |
|
AQアダプタ |
JDBCデータ・ソース |
『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』のOracle WebLogic Server管理コンソールでのデータ・ソースの構成に関する項 |
|
JMSアダプタ |
キュー |
『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』のアダプタ構成ウィザードを使用したOracle JMSアダプタの構成に関する項 |
例43-1に、JMSリソースの作成およびJMSアダプタの再デプロイメント用のスクリプトを示します。
|
注意: このスクリプトはデモ用です。使用する環境に応じて、このスクリプトの変更が必要になる場合があります。 |
例43-1 JMSリソースの作成およびJMSアダプタの再デプロイメント用のスクリプト
# lookup the JMSModule
jmsSOASystemResource = lookup("SOAJMSModule","JMSSystemResource")
jmsResource = jmsSOASystemResource.getJMSResource()
cfbean = jmsResource.lookupConnectionFactory('DemoSupplierTopicCF')
if cfbean is None:
print "Creating DemoSupplierTopicCF connection factory"
demoConnectionFactory =
jmsResource.createConnectionFactory('DemoSupplierTopicCF')
demoConnectionFactory.setJNDIName('jms/DemoSupplierTopicCF')
demoConnectionFactory.setSubDeploymentName('SOASubDeployment')
topicbean = jmsResource.lookupTopic('DemoSupplierTopic')
if topicbean is None:
print "Creating DemoSupplierTopic jms topic"
demoJMSTopic = jmsResource.createTopic("DemoSupplierTopic")
demoJMSTopic.setJNDIName('jms/DemoSupplierTopic')
demoJMSTopic.setSubDeploymentName('SOASubDeployment')
try:
save()
# activate the changes
activate(block="true")
print "jms topic and factory for SOA Fusion Order Demo successfully created"
except:
print "Error while trying to save and/or activate!!!"
dumpStack()
print "Creating jms adapter connection factory information"
try:
redeploy('JmsAdapter', '@deployment.plan@', upload='true', stageMode='stage')
except:
print "Error while modifying jms adapter connection factory"
例43-2に、データベース・リソースの作成およびデータベース・アダプタの再デプロイメント用のスクリプトを示します。
|
注意: このスクリプトはデモ用です。使用する環境に応じて、このスクリプトの変更が必要になる場合があります。 |
例43-2 データベース・リソースの作成およびデータベース・アダプタの再デプロイメント用のスクリプト
import os
connect(userName,passWord,'t3://'+wlsHost+':'+adminServerListenPort)
edit()
startEdit()
soaJDBCSystemResource1 = create('DBAdapterTestDataSource',"JDBCSystemResource")
soaJDBCResource1 = soaJDBCSystemResource1.getJDBCResource()
soaJDBCResource1.setName('DBAdapterDataSource')
soaConnectionPoolParams1 = soaJDBCResource1.getJDBCConnectionPoolParams()
soaConnectionPoolParams1.setTestTableName("SQL SELECT 1 FROM DUAL")
soaConnectionPoolParams1.setInitialCapacity(10)
soaConnectionPoolParams1.setMaxCapacity(100)
soaDataSourceParams1 = soaJDBCResource1.getJDBCDataSourceParams()
soaDataSourceParams1.addJNDIName('jdbc/dbSample')
soaDriverParams1 = soaJDBCResource1.getJDBCDriverParams()
soaDriverParams1.setUrl('jdbc:oracle:thin:@'+db_host_name+':'+db_port+':'+db_sid)
soaDriverParams1.setDriverName('oracle.jdbc.xa.client.OracleXADataSource')
soaDriverParams1.setPassword('my_password')
soaDriverProperties1 = soaDriverParams1.getProperties()
soaProperty1 = soaDriverProperties1.createProperty("user")
soaProperty1.setValue('scott')
varSOAServerTarget = '/Servers/'+serverName
soaServerTarget = getMBean(varSOAServerTarget)
soaJDBCSystemResource1.addTarget(soaServerTarget)
dumpStack()
try :
save()
activate(block="true")
except:
print "Error while trying to save and/or activate!!!"
dumpStack()
print "Creating DB adapter resource information"
try:
redeploy('DBAdapter', '@deployment.plan@', upload='true', stageMode='stage')
except:
print "Error while modifying db adapter connection factory"
Oracle JCAアダプタは、JCA 1.5リソース・アダプタとしてOracle WebLogic Serverコンテナにデプロイされます。複数のアダプタが、JAR形式を使用してリソース・アダプタ・アーカイブ(RAR)ファイルとしてパッケージ化されます。このRARファイルはアダプタのデプロイ時に使用され、アダプタはOracle WebLogic Serverまたは中間層プラットフォームにコネクタとして登録されます。RARファイルの内容は次のとおりです。
ra.xmlファイル。これは、リソース・アダプタに関するデプロイメント固有の情報が記載されているデプロイメント・ディスクリプタXMLファイルです。
Oracle WebLogic Serverとリソース・アダプタ間の規定に関する宣言情報。
アダプタでは、コネクション・ファクトリのエンドポイントを定義するweblogic-ra.xmlテンプレート・ファイルもパッケージ化されます。
コネクション・ファクトリおよび接続プールの作成の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。
ヒューマン・ワークフローでアイデンティティ・サービス・プロバイダを使用したり、認証および認可ポリシーを添付する場合は、次の追加設定タスクを実行する必要があります。
ヒューマン・ワークフローのアイデンティティ・サービス・プロバイダ
デフォルトでは、アイデンティティ・サービスでは、Oracle WebLogic Serverの組込みLDAPサーバーがデフォルトの認証プロバイダとして使用されます。ヒューマン・ワークフローを使用する場合は、Oracle Internet Directory、Microsoft Active Directory、Oracle iPlanetなどの代替アイデンティティ・サービス・プロバイダを使用するようにOracle WebLogicを構成できます。詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドを参照してください。組込みLDAPサーバーは、クラスタ化された環境ではサポートされません。
認証プロバイダ(OWSMポリシー)
特定タイプのトークン(例: ユーザー名トークン、X.509トークン、SAMLトークンなど)を使用するポリシーには、認証プロバイダが必要です。認証プロバイダの作成および構成の詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。
認可プロバイダ(OWSMポリシー)
ユーザーが認証された後は、認可ポリシーを使用して、そのユーザーがWebサービスへのアクセスを認可されていることを検証する必要があります。認可ポリシーは、いくつかのタイプのアサーション・テンプレートを使用して作成できます。認可ポリシーおよび保護するリソースの詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。
Oracle MediatorおよびOracle BPEL Process Managerでは、設計時にSOAコンポジット・アプリケーションのインスタンス名を設定できます。インスタンス名は、Oracle Enterprise Manager Fusion Middleware ControlでSOAコンポジット・アプリケーションのインスタンス・ページの「名前」列に表示されます。Oracle Enterprise Manager Fusion Middleware Controlで、SOAコンポジット・アプリケーションまたはSOAインフラストラクチャのインスタンス・ページに検索基準を指定するときに、この名前を「名前」フィールドに指定できます。
|
注意: Oracle Enterprise Manager Fusion Middleware Controlの「SOAインフラストラクチャの共通プロパティ」ページで「監査レベル」が「オフ」に設定されている場合、関数setCompositeInstanceTitleは使用できません。この場合、次のエラー・メッセージが表示されます。
Composite instance ID is null. A composite instance may not be created based on audit trail settings. Check the user guide for detail. |
Oracle Mediatorでコンポジット・インスタンス名を設定する手順は、次のとおりです。
assignアクティビティでXPath式関数med:setCompositeInstanceTitleを使用します。例:
<assign>
<copy
target="$out.property.tracking.compositeInstanceTitle"
expression="med:setCompositeInstanceTitle("sample")"
xmlns:med="http://schemas.oracle.com/mediator/xpath"/>
</assign>
式med:setCompositeInstanceTitle("sample")は、タイトルを設定する際に関数全体を実行します。targetに指定される値はダミー値で、assignアクティビティが正しく動作するためにのみ使用されます。
XSLTマッパーで、setCompositeInstanceTitle(title) XPath式関数を使用します。
BPELプロセスにコンポジット・インスタンス名を設定する手順は、次のとおりです。
BPELプロセスにコンポジット・インスタンス名を設定する手順は、次のとおりです。
Java BPEL exec拡張要素bpelx:execを使用します。この拡張要素には組込みメソッドsetCompositeInstanceTitle(String title)が含まれており、インスタンス名を設定できます。
詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドを参照してください。
Oracle B2Bまたはヒューマン・タスクを使用する場合は、次の追加設定タスクを実行する必要があります。
取引パートナ・アグリーメントおよびタスク・フローをデプロイする手順は、次のとおりです。
取引パートナ・アグリーメントのデプロイ
取引パートナ・アグリーメントには、2つの取引パートナ、つまりイニシエータと応答者がビジネス文書を交換する際の条件が定義されています。これによって、取引パートナ、取引パートナID、ドキュメント定義およびチャネルが識別されます。アグリーメントは、設計時リポジトリから実行時リポジトリにデプロイする必要があります。詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』を参照してください。
タスク・フローのデプロイ
Oracle BPM Worklistでタスク・フローを使用するには、そのタスク・フローをデプロイする必要があります。詳細は、第43.7.1.3項「プロファイルのデプロイ」を参照してください。
データを他のコンポジットと共有しないSOAコンポジット・アプリケーションをデプロイするには、「アプリケーション・サーバー接続の作成」ウィザードを使用して、アプリケーション・サーバー接続を作成します。詳細は、第43.7.1.1項「アプリケーション・サーバー接続の作成」を参照してください。
データを他のコンポジットと共有するSOAコンポジット・アプリケーションをデプロイするには、「SOA-MDS接続の作成」ウィザードを使用して、データベース・ベースのOracle MDSリポジトリ・サーバーへの接続を作成します。詳細は、第43.7.3.4.1項「SOA-MDS接続の作成」を参照してください。
開発、テストおよび本番環境間を移動するとき、すべてのカスタマイズ・タスクを手動で実行する必要はありません。この項では、構成プランを使用して、次に進むターゲット環境に応じてSOAコンポジット・アプリケーションを自動的に構成する方法について説明します。
通常、プロジェクトをある環境から別の環境に(たとえば、テスト環境から本番環境に)移動する場合は、JDBC接続文字列や様々なサーバーのホスト名など、環境固有の値をいくつか変更する必要があります。構成プランと呼ばれる単一のテキスト(XML)ファイルを使用して、これらの値を変更できます。構成プランは、Oracle JDeveloper内で作成するか、またはWLSTコマンドを使用して作成します。プロセスのデプロイメント時に、構成プランを使用してSOAプロジェクトを検索し、プロジェクトを次に進むターゲット環境に適応させるために置換する必要がある値を検索します。
この項では、構成プランの作成方法と添付方法の概要を説明します。
次の属性やプロパティを置換できる構成プラン・ファイルを作成して編集します。
SOAコンポジット・アプリケーション・ファイル(composite.xml)内のすべてのコンポジット、サービス・コンポーネント、参照、サービスおよびバインディング・プロパティ
バインディング用の属性値(例: binding.wsの場所)
WSDLファイル内のインポートのschemaLocation属性
WSDLファイル内のインクルードのlocation属性
XSDファイル内のインクルード、インポートおよび再定義のschemaLocation属性
JCAアダプタ・ファイル内のすべてのプロパティ
次のもののためのポリシー参照
サービス・コンポーネント
サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネント
|
注意: 構成プランは、SOAコンポジット・アプリケーションのXSLTアーティファクトを変更しません。XSLを変更するには、XSLTマッパーを使用します。構成プランの使用は有効ではありません。たとえば、構成プラン・ファイルを使用してXSLの参照を変更することはできません。かわりに、テスト、開発および本番環境の間を移動するときに、Oracle JDeveloperのXSLTマッパーで参照を手動で変更する必要があります。これにより、設計時にXSLTマッパーが問題なく開きます。ただし、参照を未変更のままにしても実行時の動作に影響はありません。トランスフォーメーションおよびXSLTマッパーの詳細は、第43章「SOAコンポジット・アプリケーションのデプロイ」を参照してください。 |
デプロイメント時には、次のいずれかのツールを使用して、構成プラン・ファイルをSOAコンポジット・アプリケーションのJARファイルまたはZIPファイル(SOAバンドルをデプロイする場合)に添付します。
Oracle JDeveloper
詳細は、第43.7.1.3項「プロファイルのデプロイ」を参照してください。
antスクリプト
詳細は、第43.7.6.4項「SOAコンポジット・アプリケーションをデプロイするためのantの使用方法」を参照してください。
WLSTコマンド
詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。
デプロイメント時に、構成プラン・ファイルを使用して、SOAコンポジット・アプリケーションのJARまたはZIPファイルにあるcomposite.xml、WSDLおよびXSDファイルを検索し、プロジェクトを次に進むターゲット環境に適応させるために置換する必要がある値を検索します。
次の例は、次の項目を変更する構成プランを示しています。
コンポジットFileAdaptorCompositeのinFileFolderプロパティは、mytestserver/newinFileFolderで置換されます。
次の場所のホスト名(myserver17)は、test-serverで置換され、ポート8888は8198で置換されます。
すべてのインポートWSDL
すべての参照binding.wsの場所
composite.xmlファイルは例43-3のようになります。
例43-3 composite.xmlファイル
<composite .....> <import namespace="http://example.com/hr/" location="http://myserver17.us.example.com:8888/hrapp/HRAppService?WSDL" importType="wsdl"/> <service name="readPO"> <interface.wsdl interface="http://xmlns.oracle.com/pcbpel/adapter/file/readPO/#wsdl.interface(Read _ptt)"/> <binding.jca config="readPO_file.jca"/> <property name="inFileFolder" type="xs:string" many="false" override="may">/tmp/inFile</property> </service> <reference name="HRApp"> <interface.wsdl interface="http://example.com/hr/#wsdl.interface(HRAppService)"/> <binding.ws port="http://example.com/hr/#wsdl.endpoint(HRAppService/HRAppServiceSoapHttpPort)" location="http://myserver17.us.example.com:8888/hrapp/HRAppService?WSDL"/> <binding.java serviceName="{http://example.com/hr/}HRAppService" registryName="HRAppCodeGen_JBOServiceRegistry"/> </reference> </composite>
構成プラン・ファイルは例43-4のようになります。
例43-4 構成プラン・ファイル
<?xml version="1.0" encoding="UTF-8"?>
<SOAConfigPlan
xmlns:jca="http://platform.integration.oracle/blocks/adapter/fw/metadata"
xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"
xmlns:orawsp="http://schemas.oracle.com/ws/2006/01/policy"
xmlns:edl="http://schemas.oracle.com/events/edl"
xmlns="http://schemas.oracle.com/soa/configplan">
<composite name="FileAdaptorComposite">
<service name="readPO">
<binding type="*">
<property name="inFileFolder">
<replace>/mytestserver/newinFileFolder</replace>
</property>
</binding>
</service>
</composite>
<!-- For all composite replace host and port in all imports wsdls -->
<composite name="*">
<import>
<searchReplace>
<search>myserver17</search>
<replace>test-server</replace>
</searchReplace>
<searchReplace>
<search>8888</search>
<replace>8198</replace>
</searchReplace>
</import>
<reference name="*">
<binding type="ws">
<attribute name="location">
<searchReplace>
<search>myserver17</search>
<replace>test-server</replace>
</searchReplace>
<searchReplace>
<search>8888</search>
<replace>8198</replace>
</searchReplace>
</attribute>
</binding>
</reference>
</composite>
</SOAConfigPlan>
ポリシーは、同じURIに対するポリシーが使用可能な場合は置換されます。それ以外の場合は追加されます。これは、変更されるが追加はされないプロパティとは異なります。
次の手順では、開発環境からテスト環境に移動するときに構成プランを使用する方法の概要を説明します。
ユーザーAはSOAコンポジット・アプリケーションFooを作成します。
ユーザーAはFooを開発サーバーにデプロイし、ステージング領域でテストする準備が整うまで不具合を修正してプロセスを調整します。
ユーザーAはFoo用の構成プランを作成して編集します。これにより、テスト環境に適合するようにアプリケーション内のURLおよびプロパティを変更できます。
ユーザーAは、Oracle JDeveloperまたは一連のコマンドライン・スクリプト(WLSTベース可能)を使用して、Fooをテスト・サーバーにデプロイします。ステップ3で作成した構成プランにより、Foo内のURLおよびプロパティが変更されます。
ユーザーAは、今後、SOAコンポジット・アプリケーションBarをデプロイし、デプロイメント時に同じプランを適用します。URLおよびプロパティも変更されます。
次の手順では、環境に依存しないプロセスを作成するときに構成プランを使用する方法の概要を説明します。
|
注意: このユースケースは、独自の開発サーバー、および共通の開発およびテスト・サーバーを持つユーザーが、同じプロセスの開発を共有している場合に役立ちます。同じデプロイメント環境(つまり、同じ開発サーバー)を共有するユーザーには、このユースケースは参考にならない場合があります。 |
ユーザーAはSOAコンポジット・アプリケーションFooを作成します。
ユーザーAはFooを開発サーバーにデプロイし、ステージング領域でテストする準備が整うまで不具合を修正してプロセスを調整します。
ユーザーAはFoo用の構成プランを作成します。これにより、ユーザーAの環境の設定に適合するようにプロセス内のURLおよびプロパティを変更できます。
ユーザーAは、ソース・コントロール・システムに対して、Fooおよびステップ3で作成した構成プランをチェックインします。
ユーザーBは、ソース・コントロールからFooをチェックアウトします。
ユーザーBは、環境に適合する構成プランのコピーを作成し、新規の構成プランをFooのアーティファクトに適用します。
ユーザーBはアプリケーションをOracle JDeveloperにインポートし、いくつかの変更を行います。
ユーザーBは、Fooおよび(ユーザーBの環境に適合する)構成プランBの両方をチェックインします。
ユーザーAは、両方の構成プランとともに、Fooを再度チェックアウトします。
この項では、構成プランの作成方法と使用方法を説明します。特に、次の項目について説明します。
構成プランの作成および編集
SOAコンポジット・アプリケーションのJARファイルへの構成プランの添付
構成プランの検証
構成プランが含まれるSOAコンポジット・アプリケーションのJARまたはZIPファイルのデプロイ
Oracle JDeveloperで構成プランを作成する手順は、次のとおりです。
Oracle JDeveloperを開きます。
アプリケーション・ナビゲータで、構成プランを作成するプロジェクトのcomposite_name (composite.xml)ファイルを右クリックし、「構成プランの生成」を選択します。図43-1に詳細を示します。
図43-2に示すように、「コンポジット構成プラン・ジェネレータ」が表示されます。
表43-2に示すように、構成プラン・ファイルを作成して編集します。
表43-2 構成プランの生成
| フィールド | 説明 |
|---|---|
|
構成プランのファイル名(.xml)を指定してください |
構成プランの特定の名前を入力するか、またはデフォルト名をそのまま使用します。ファイルはプロジェクトのディレクトリ内に作成され、SOAコンポジット・アプリケーションのJARまたはZIPファイルにパッケージ化されます。 注意: デプロイメント時にプロンプトが表示された時点で、デプロイメント・ウィザードの「構成のデプロイ」ページで別の構成ファイルを指定できます。詳細は、第43.7.1.3項「プロファイルのデプロイ」を参照してください。 |
|
既存ファイルの上書き |
既存の構成プラン・ファイルをプロジェクト・ディレクトリ内の別のファイルで上書きする場合に選択します。 |
「OK」をクリックします。
これで、単一の構成プラン・ファイルが作成され、編集のために開きます。ファイルは例43-4のようになります。SOAコンポジット・アプリケーションのcomposite.xml、WSDLおよびスキーマ・ファイルのURLとプロパティを変更できます。図43-3に詳細を示します。
サーバー名、ポート番号などの値を既存の構文に追加します。また、新しい値を指定するときは、置換専用の構文を追加できます。各セクションに複数の検索コマンドや置換コマンドを追加できます。
「ファイル」メニューから「すべて保存」を選択します。
エディタの上部で、ファイル名の右側にあるxをクリックして構成プラン・ファイルを閉じます。
アプリケーション・ナビゲータで、composite_name (composite.xml)ファイルを再び右クリックし、「構成プランを検証します」を選択します。
図43-4に示すように、「コンポジット構成プラン・バリデータ」が表示されます。
検証する構成プランを選択します。この手順では、デプロイメント中に行われた検索および置換による変更がすべて識別されます。このオプションは、デバッグの目的でのみ使用します。
検証結果が記述されたレポートが作成されたディレクトリをメモし、「OK」をクリックします。
Oracle JDeveloperの「ログ」ウィンドウには、検証が成功したかどうかが表示され、SOAコンポジット・アプリケーションのデプロイメント中に実行された検索コマンドと置換コマンドがすべてリストされます。この情報は検証レポートにも書き込まれます。
|
注意: 古いcomposite.xml、WSDLおよびXSDファイルは、次に進む環境に適したURLおよびプロパティの新しい値を含むファイルに置換されません。このような置換は、SOAコンポジット・アプリケーションがデプロイされた場合のみ発生します。 |
次のいずれかの項で説明する手順に従って、SOAコンポジット・アプリケーションをデプロイします。
Oracle JDeveloperでデプロイメント中に、第43.7.1.3項「プロファイルのデプロイ」の手順4に示されている「構成のデプロイ」ページで、SOAコンポジット・アプリケーション・アーカイブを含める構成プランを選択するよう促されます。
SOAコンポジット・アプリケーションとともに含める構成プランを選択します。
「OK」をクリックします。
Oracle JDeveloperのかわりにWLSTコマンドライン・ユーティリティを使用して、次の構成プラン管理タスクを実行できます。
構成プランの生成および編集
sca_generatePlan(configPlan, sar, composite, overwrite, verbose)
SOAコンポジット・アプリケーションのJARファイルへの構成プラン・ファイルの添付
sca_attachPlan(sar, configPlan, overwrite, verbose)
構成プランの検証
sca_validatePlan(reportFile, configPlan, sar, composite, overwrite, verbose)
JARファイルにパッケージ化された構成プランの抽出および編集
sca_extractPlan(sar, configPlan, overwrite, verbose)
これらのコマンドの使用方法の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド リファレンス』を参照してください。
デプロイメント時には、Oracle JDeveloperのかわりにantスクリプトを使用して、構成プラン・ファイルをSOAコンポジット・アプリケーションのJARまたはZIPファイルに添付できます。手順は、第43.7.6.4項「SOAコンポジット・アプリケーションをデプロイするためのantの使用方法」を参照してください。
SOAコンポジット・アプリケーションの特定のURIに対してグローバル・トークン変数を定義できます。たとえば、10個の異なる構成プランでSOAコンポジット・アプリケーション名を更新するかわりに、その名前をグローバルに設定できます。値が取得され、その値で、デプロイ済SOAコンポジット・アプリケーションのcomposite.xmlファイルのコンポジット名に対するグローバル・トークン変数の値が置換されます。
詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドを参照してください。
この項では、次のタイプのSOAコンポジット・アプリケーションをデプロイする方法について説明します。
Oracle JDeveloperでの単一のコンポジットのデプロイ
Oracle JDeveloperでの複数のコンポジットのデプロイ
Oracle JDeveloperでの共有データのデプロイおよび使用
Oracle JDeveloperでの既存のSOAアーカイブのデプロイ
WLSTおよびantスクリプトを使用したSOAコンポジット・アプリケーションの管理
Oracle Enterprise Manager Fusion Middleware Controlからのデプロイ
クラスタへのSOAコンポジット・アプリケーションのデプロイ
Oracle JDeveloperでは、SOAプロジェクトとアプリケーションをOracle WebLogic Serverにデプロイするためにプロファイルを使用する必要があります。
SOAコンポジット・アプリケーションのデプロイ先となるアプリケーション・サーバーへの接続を作成する必要があります。次の手順は、Oracle WebLogic Serverへの接続の作成方法です。IBM WebSphere Serverなどの他のアプリケーション・サーバーへの接続を作成する方法は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドを参照してください。
アプリケーション・サーバー接続を作成する手順は、次のとおりです。
「ファイル」メイン・メニューから、「新規」を選択します。
「一般」リストから、「接続」を選択します。
「アプリケーション・サーバー接続」を選択し、「OK」をクリックします。
「名前とタイプ」ページが表示されます。
「接続名」フィールドに、接続の名前を入力します。
「接続タイプ」リストで「WebLogic 10.3」を選択して、Oracle WebLogic Serverへの接続を作成します。
「次へ」をクリックします。
「認証」ページが表示されます。
「ユーザー名」フィールドに、アプリケーション・サーバーにアクセスする権限があるユーザーを入力します。
「パスワード」フィールドに、このユーザーのパスワードを入力します。
「次へ」をクリックします。
「構成」ページが表示されます。
「Weblogicホスト名(管理サーバー)」フィールドに、Oracle WebLogic Serverがインストールされているホストを入力します。
「ポート」および「SSLポート」フィールドに適切なポート値を入力するか、デフォルト値を受け入れます。
Secure Sockets Layer (SSL)を使用する場合は、「常にSSLを使用」チェック・ボックスを選択します。表43-3は、このチェック・ボックスを選択したときの動作について説明しています。
表43-3 HTTPSおよびHTTPサーバーへのデプロイ
| チェック・ボックス | 動作 |
|---|---|
|
選択 |
SSLでコンポジットをデプロイするために、HTTPSサーバーURLが存在する必要があります。そうでない場合、デプロイメントは失敗します。 サーバーにHTTPのURLしかない場合も、デプロイメントが失敗します。このオプションは、SSLでのデプロイメントが非SSLのHTTP URLを介して行われないようにし、HTTPS URLのみを介して行われるようにするためのオプションです。 |
|
選択解除 |
非SSL環境にデプロイするために、HTTPサーバーURLが存在する必要があります。そうでない場合、デプロイメントは失敗します。 サーバーにHTTPSとHTTPの両方のURLがある場合、デプロイメントは非SSL接続を介して行われます。このオプションは、サーバーがSSL対応であってもOracle JDeveloperからの非SSLデプロイメントを強制的に行えるようにするためのオプションです。 |
「WebLogicドメイン」フィールドに、Oracle SOA Suiteのドメインを入力します。ドメインの指定に関する詳細は、「ヘルプ」をクリックしてください。
「次へ」をクリックします。
「接続のテスト」をクリックして、サーバー接続をテストします。
接続に成功した場合は、「終了」をクリックします。そうでない場合、「戻る」をクリックして、前のダイアログで内容を修正します。接続テストに成功しなかった場合でも接続は作成されます。
必要なデプロイメント・プロファイルは、プロジェクトに対して自動的に作成されます。アプリケーション・プロファイルには、SOAプロジェクトのJARファイルが含まれています。必要に応じて、追加のプロファイルを作成できます。
プロジェクト・デプロイメント・プロファイルを作成する手順は、次のとおりです。
「アプリケーション・ナビゲータ」で、SOAプロジェクトを右クリックします。
「プロジェクト・プロパティ」を選択します。
「プロジェクト・プロパティ」ダイアログが表示されます。
「デプロイメント」をクリックします。
「新規」をクリックします。
「デプロイメント・プロファイルの作成」ダイアログが表示されます。
表43-4に記載されている値を入力します。
表43-4 「デプロイメント・プロファイルの作成」ダイアログのフィールドと値
「OK」をクリックします。
SARデプロイメント・プロファイル・ダイアログが表示されます。
「OK」をクリックして「SARデプロイメント・プロファイルのプロパティ」ダイアログを閉じます。
図43-5に示すデプロイメント・プロファイルが、「プロジェクト・プロパティ」ダイアログに表示されます。
次に、プロジェクト・プロファイルをOracle WebLogic Serverにデプロイします。デプロイメントを実行するには、アプリケーション・サーバー接続の作成が必要です。デプロイメント時に接続を作成するには、ステップ10で「追加」アイコンをクリックします。またはデプロイメント前に接続を作成するには、第43.7.1.1項「アプリケーション・サーバー接続の作成」の手順に従います。
プロファイルをデプロイする手順は、次のとおりです。
「アプリケーション・ナビゲータ」で、SOAプロジェクトを右クリックします。
「デプロイ」→「project_name」の順に選択します。
project_nameの値は、SOAプロジェクト名です。
「Project_Nameのデプロイ」ウィザードの「デプロイメント・アクション」ページが表示されます。図43-6に例を示します。
次のいずれかのデプロイメント・オプションを選択します。
アプリケーション・サーバーへのデプロイ
選択したSOAプロジェクトのJARファイルが作成され、Oracle WebLogic Serverなどのアプリケーション・サーバーにデプロイされます。
SARへのデプロイ
選択したSOAプロジェクトのSAR (JAR)ファイルが作成されますが、Oracle WebLogic Serverなどのアプリケーション・サーバーにはデプロイされません。このオプションは次のような環境に便利です。
Oracle WebLogic Serverは実行中でないが、アーティファクトJARファイルを作成する場合。
バッチ・スクリプトから複数のJARファイルをOracle WebLogic Serverにデプロイする場合。このオプションは、Oracle JDeveloperですべてのプロジェクト・プロファイル(所有権がないものが含まれている可能性があります)を開いて、それらをデプロイする方法の代替手段として提供されています。
表示されるページは、選択内容によって異なります。
環境に適したデプロイメント・オプションを選択します。
表43-6の説明に従って、環境に適した値を指定します。アプリケーション・サーバーへのデプロイを選択した場合は、追加のフィールドがページに表示されます。
表43-6 「SOAデプロイメントと構成ダイアログ」
| フィールド | 説明 |
|---|---|
|
コンポジット・リビジョンID |
プロジェクトの詳細を展開表示します。 |
|
プロジェクト名が表示されます。 |
|
プロジェクトの現在のリビジョンIDが表示されます。 |
|
必要に応じて、SOAコンポジット・アプリケーションのリビジョンIDを変更します。 |
|
SOA構成プラン |
構成プランの詳細を展開表示します。 構成プランにより、様々な環境で使用するURLおよびプロパティ値を定義できます。プロセスのデプロイメント時に、構成プランを使用してSOAプロジェクトを検索し、プロジェクトを次に進むターゲット環境に適応させるために置換する必要がある値を検索します。 |
|
構成プランをSOAコンポジット・アプリケーションのJARファイルに含めない場合に選択します。構成プランを作成していない場合、このフィールドは無効化されています。これがデフォルトの選択です。 |
|
特定の計画を選択します。この選択を使用できるようにするには、SOAプロジェクトに構成プランが存在している必要があります。 構成プランの作成手順については、第43.6.1項「ターゲット環境に応じてSOAコンポジット・アプリケーションをカスタマイズするための構成プランの使用方法」を参照してください。 |
|
BPELモニター |
BPELモニターに関する詳細を表示する場合に展開します。 |
注意: このチェック・ボックスは、アプリケーションに少なくとも1つの |
BPELモニターのデプロイメント・エラーを表示する場合は、このチェック・ボックスの選択を解除します。このチェック・ボックスは、 |
|
コンポジット・リビジョンをデフォルトとしてマークします。 |
新規リビジョンをデフォルトにしない場合は、このボックスの選択を解除できます。デフォルトでは、新しくデプロイしたコンポジット・リビジョンがデフォルトになります。このリビジョンは、新しいリクエストを受信するとインスタンス化されます。 このオプションは、「デプロイメント・アクション」ページで「アプリケーション・サーバーへのデプロイ」を選択した場合のみ表示されます。 |
|
同じリビジョンIDで既存のコンポジットを上書きします。 |
同じリビジョン値を持つ既存のSOAコンポジット・アプリケーションを上書きする場合に選択します。 このオプションは、「デプロイメント・アクション」ページで「アプリケーション・サーバーへのデプロイ」を選択した場合のみ表示されます。 |
|
再デプロイ後にインスタンスの実行を続行します。 |
注意: このオプションはOracle JDeveloperにOracle BPM Suiteがインストールされている場合にのみ表示され、Oracle BPMコンポジットのデプロイに対してのみサポートされます。次をデプロイする場合はこのオプションを選択しないでください。
上書きされたリビジョンの既存のインスタンスを有効にして、失効にするのではなく実行を継続する場合に選択します。これらのインスタンスは、Oracle BPMコンポジット・アプリケーションの新規リビジョンで作成した新規インスタンスと並んで実行されます。 |
|
互換性のないプロセスのデプロイメントを強制します |
このオプションは、Oracle BPM Suiteコンポジットに対してのみ表示されます。 「再デプロイ後にインスタンスの実行を続行します。」が選択されている場合、このオプションが表示されます。互換性のないBPMプロセスのデプロイメントを強制するには、このチェック・ボックスを選択します。BPMプロセスを含むコンポジットが上書きされる場合、上書きされるBPMプロセスがデプロイされるプロセスと互換性があるかどうかがチェックされます。互換性がある場合、これらのプロセスのインスタンスの実行は失効としてマークされず、デプロイメントは正常に実行されます。互換性がない場合、このチェック・ボックスを選択しないとデプロイメントは失敗します。 |
|
すべてのコンポジットにSOA構成プランを使用します |
「参照」をクリックして、すべてのコンポジット・アプリケーションに対して使用する同じ構成プランを選択します。このオプションは、複数のコンポジット・アプリケーションをデプロイする場合に使用します。 |
「次へ」をクリックします。
デプロイメント対象として選択したSOAプロジェクトに、ヒューマン・タスク用に定義したタスク・フロー・プロジェクトが含まれている場合は、図43-9に示すように、「タスクフロー・デプロイメント」ダイアログが表示されます。
それ以外の場合は、ステップ10に進みます。
ヒューマン・タスクのタスク・フロー・フォームに対するEnterprise Resource Archive (EAR)ファイルを作成または構成します。EARファイルは、このダイアログの「デプロイ可能なタスクフロー・プロジェクト」表で選択したWeb Resource Archive (WAR)プロファイルで構成されます。
表43-7の説明に従って、環境に適した値を指定します。
表43-7 「タスクフロー・デプロイメント」ダイアログ
| フィールド | 説明 |
|---|---|
|
アプリケーション名 |
デプロイメントに含めるEARファイルを選択します。このリストには、現行のOracle JDeveloperアプリケーションで使用可能なすべてのEARプロファイルが表示されます。これらのEARプロファイルは、EARプロファイルを作成し、「デプロイ可能なタスクフロー・プロジェクト」表で選択したWARプロファイルに基づいてデプロイする際に、テンプレートとして使用されます。デプロイする任意のEARプロファイル名を入力することもできます。 |
|
特定のコンポジット・リビジョンおよびパーティションにデプロイ |
コンポジットのリビジョン番号をEARファイル名に追加する場合に選択します。このチェック・ボックスを選択すると、コンポジット・リビジョンがEAR名、WARプロファイルおよびコンテキスト・ルートに含められます。このオプションによって、コンポジット・リビジョン固有のアプリケーションをデプロイできます。 |
|
生成されたプロファイルをアプリケーションに追加 |
生成されたEARプロファイルを現行のSOAコンポジット・アプリケーションのEARデプロイメント・プロファイル・リストに追加する場合に選択します。生成されたEARプロファイルを保持するには、アプリケーションの保存が必要になる場合があります。デプロイメント・プロファイルが使用可能になると、「アプリケーション」→「デプロイ」の順に選択してEARプロファイルをデプロイできます。タスク・フロー・アプリケーションのデプロイメントのみが必要な場合は、このオプションを使用すると、「SOAデプロイ」ウィザードを使用する必要がありません。 |
|
既存のアプリケーションを上書き |
サーバー上のEARファイルの既存のバージョンを上書きする場合に選択します。 |
|
デプロイ可能なタスクフロー・プロジェクト |
EARファイルに含めるタスク・フロー・プロジェクトのWARプロファイルを選択します。タスク・フロー・プロジェクトのWARプロファイルは、そのタスク・フロー・プロジェクトに関連するヒューマン・タスクを含むコンポジットに従ってグループ化されます。「生成されたプロファイルをアプリケーションに追加」チェック・ボックスが選択されている場合は、WARのコンテキスト・ルートが変更されます。 注意: WARプロファイルを選択しないと、タスク・フローはデプロイされません。 |
|
「デプロイ可能なタスクフロー・プロジェクト」のリストから選択するか、または「プロジェクト」チェック・ボックスを選択して使用可能なすべてのタスク・フローを選択します。タスク・フローは、デプロイメント対象として選択したSOAプロジェクトまたはバンドルに含まれるコンポジットに基づいて表示されます。 |
|
タスク・フロー・プロジェクトのWARファイルを選択します。選択できるのは、最近作成または変更されたヒューマン・タスクのタスク・フローのみです。 |
|
WARプロファイルの選択内容に基づいて、アプリケーション・コンテキスト・ルート・ディレクトリが表示されます。 |
ヒューマン・タスク用のタスク・フォームをデプロイすると、通知の一部として、タスク・フォームの詳細が電子メールに含められます。動的なペイロードの場合、この電子メールに含まれるペイロードの内容は、特定の時点のものとなります。
タスク・フローのあるSOAコンポジット・アプリケーションの複数パーティション環境へのデプロイに関する詳細は、第43.7.1.4項「タスク・フローのあるヒューマン・タスク・コンポジットのパーティションへのデプロイに関する必知事項」を参照してください。
「次へ」をクリックします。
手順3で、アプリケーション・サーバーへのデプロイを選択した場合は、「サーバーの選択」ページが表示されます。このページでは、Oracle WebLogic Serverなどのアプリケーション・サーバーへの既存の接続をリストから選択するか、または「追加」アイコンをクリックしてサーバーへの新規接続を作成します。図43-10に詳細を示します。
それ以外の場合は、ステップ15に進みます。
「次へ」をクリックします。
このアーカイブをデプロイするターゲットSOAサーバーを選択します。複数のサーバーまたはクラスタ・ノードがある場合は、1つまたは複数のサーバーあるいはノードへのデプロイを選択します。図43-11に詳細を示します。
このアーカイブをデプロイするパーティションを選択します。サーバーにパーティションがない場合、このアーカイブはデプロイできません。また、サーバーが実行中の状態でない場合も、このアーカイブはデプロイできません。デフォルトでは、Oracle SOA Suiteには、defaultという名前のパーティションが自動的に含まれています。パーティションは、Oracle Enterprise Manager Fusion Middleware Controlの「パーティションの管理」ページで作成します。
「次へ」をクリックします。
図43-12に示されている「サマリー」ページでアーカイブの詳細を確認し、「終了」をクリックします。
手順3で、アプリケーション・サーバーへのデプロイを選択した場合は、Oracle JDeveloperの下部にあるデプロイメント・ログ・ウィンドウに表示されるメッセージを確認します。
ユーザー名とパスワードを入力し、「OK」をクリックします。
デプロイメントに成功した場合は、次の処理が実行されます。
SOAプロジェクト用のJARファイルが、Oracle JDeveloperの「deploy」フォルダの下に作成されます。命名規則はsca_composite_name_revrevision_number.jarです。
プロジェクトが、「リソース・パレット」の「application_server_connection_name」→「SOA」→「SOA_server_name」→「partition_name」の下に表示されます。
プロジェクトが、「アプリケーション・サーバー・ナビゲータ」の「application_server_connection_name」→「SOA」→「SOA_server_name」→「partition_name」の下に表示されます。
これで、Oracle Enterprise Manager Fusion Middleware Controlからアプリケーションを監視できるようになります。詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』を参照してください。
デプロイメントに失敗した場合は、デプロイメント・ログ・ウィンドウに表示されているメッセージを確認して、修正処理を実行してください。詳細は、第43.9項「テストおよびトラブルシューティング」を参照してください。
パーティションの作成の詳細は、次のドキュメントを参照してください。
Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド
Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス
|
注意: 同じバージョンのSOAコンポジット・アプリケーションを再デプロイする場合、コンポジット名は変更できません。「構成のデプロイ」ページで「同じリビジョンIDで既存のコンポジットを上書きします。」チェック・ボックスを選択した場合は、同じリビジョン番号でデプロイできます。 |
タスク・フローのあるSOAコンポジット・アプリケーションをOracle JDeveloperから複数パーティション環境にデプロイするには、デプロイ先パーティションがSOAコンポジット・アプリケーションのデプロイ先と同じであるタスク・フローを選択します。
EARプロファイル(EARデプロイヤを使用してタスク・フローをデプロイ)のみを使用してデプロイしたタスク・フローの場合、そのタスク・フローはパーティションに非対応です。したがって、生成されるEARファイルにパーティション名が含まれるように、hwtaskflow.xmlファイルを変更する必要があります(ファイルのプロジェクト・バージョンは変更されずに残ります)。このファイルはTaskFormプロジェクトのadfmsrcディレクトリの下に配置されます(例: HelpDeskRequestTaskFlow\adfmsrc\hwtaskflow.xml)。例43-5に詳細を示します。
例43-5 hwtaskflow.xmlファイルの変更
<hwTaskFlows
xmlns="http://xmlns.oracle.com/bpel/workflow/hwTaskFlowProperties">
<ApplicationName>worklist</ApplicationName>
<LookupType>LOCAL</LookupType>
<TaskFlowDeploy>false</TaskFlowDeploy>
<PartitionName>partition2</PartitionName>
なお、他のパーティションで同じタスク・フロー・プロジェクトを再利用する場合は、Webコンテキスト・ルートを変更する必要があります。
SOAバンドル・プロファイルを使用して、複数のSOAコンポジット・アプリケーションをOracle WebLogic Serverなどのアプリケーション・サーバーに同時にデプロイできます。このプロファイルにより、1つ以上のSARプロファイルをバンドルに含めて、そのバンドルをアプリケーション・サーバーにデプロイできます。
|
注意:
|
複数のSOAコンポジット・アプリケーションをデプロイする手順は、次のとおりです。
図43-13に示すように、「アプリケーション」メニューから「アプリケーション・プロパティ」を選択します。
「アプリケーション・プロパティ」ダイアログで、「デプロイメント」をクリックします。
「新規」をクリックします。
「デプロイメント・プロファイルの作成」ダイアログが表示されます。
「アーカイブ・タイプ」リストから、「SOAバンドル」を選択します。
「名前」フィールドに、名前を入力します。
図43-14に詳細を示します。
「OK」をクリックします。
左側のナビゲータで、「依存性」ノードを選択します。
図43-15に示すように、このバンドルに含めるSARを選択します。
「OK」をクリックします。
「OK」をクリックして「アプリケーション・プロパティ」ダイアログを閉じます。
「アプリケーション」メニューを再度選択し、「デプロイ」→「SOA_Bundle_Name」の順に選択します。
これによりデプロイメント・ウィザードが起動します。
指定する値に関する詳細は、ステップ3を参照してください。
この項では、複数のSOAコンポジット・アプリケーション間でWSDL、XSD、および他のファイル・タイプなど共有データをデプロイおよび使用する方法について説明します。
共有データは、アプリケーション・サーバー上のSOAインフラストラクチャにJARファイルとしてデプロイされます。JARファイルには、共有するすべてのリソースが含まれている必要があります。Oracle JDeveloperでは、共有アーティファクト・アーカイブを作成するためのJARプロファイルを作成できます。
すべての共有データは、サーバー上の既存のSOAインフラストラクチャ・パーティションにデプロイされます。このデータは、/appsネームスペースの下にデプロイされます。たとえば、JARファイルにMyProject/xsd/MySchema.xsdファイルがある場合、このファイルはサーバー上の/appsネームスペースの下にデプロイされます。Oracle JDeveloperでSOA-MDS接続を使用してこのアーティファクトを参照する場合、URLはoramds:/apps/MyProject/xsd/MySchema.xsdになります。
|
注意:
|
この項では、次のタスクの実行方法について説明します。
JARプロファイルの作成および共有するアーティファクトの組込み
JARプロファイルを組み込むSOAバンドルの作成
アプリケーション・サーバーへのSOAバンドルのデプロイ
JARプロファイルを作成し、共有するアーティファクトを組み込む手順は、次のとおりです。
「アプリケーション・ナビゲータ」で、SOAプロジェクトを右クリックします。
「プロジェクト・プロパティ」を選択します。
「プロジェクト・プロパティ」ダイアログが表示されます。
左側のナビゲーション・ツリーにある「デプロイメント」をクリックします。
「新規」をクリックします。
「デプロイメント・プロファイルの作成」ダイアログが表示されます。
「アーカイブ・タイプ」リストから、「JARファイル」を選択します。
「名前」フィールドに、名前を入力します(この例ではshared_archiveが入力されています)。
「デプロイメント・プロファイルの作成」ダイアログは、図43-16のようになります。
「OK」をクリックします。
「JARデプロイメント・プロファイルのプロパティ」ダイアログが表示されます。
左側のナビゲーション・ツリーから「JARオプション」を選択します。
図43-17に示すように、「manifestファイルを含める(META-INF/MANIFEST.MF)」の選択を解除します。
選択を解除すると、アーカイブ・ジェネレータによってmanifestファイル(META-INF/MANIFEST.MF)がJARファイルに追加されることはありません。
左側のナビゲーション・ツリーから、「ファイル・グループ」→「プロジェクトの出力」→「コントリビュータ」の順に選択します。
図43-18に示すように、「プロジェクトの出力ディレクトリ」および「プロジェクトの依存性」オプションの選択を解除します。
選択を解除すると、アーカイブ・ジェネレータによって、プロジェクトの出力およびプロジェクトの依存性の内容がアーカイブに追加されることはありません。
「追加」をクリックして、新しいコントリビュータを追加します。
「コントリビュータの追加」ダイアログが表示されます。このダイアログで、アーティファクトをアーカイブに追加できます。
「参照」をクリックします。
図43-19に示すように、アーティファクトが存在するフォルダを選択します。この選択によって、アーカイブ内のアーティファクトの階層も決まります。
「選択」をクリックして、「ディレクトリの選択」ダイアログを閉じます。
「OK」をクリックして「コントリビュータの追加」ダイアログを閉じます。
左側のナビゲーション・ツリーから、「ファイル・グループ」→「プロジェクトの出力」→「フィルタ」の順に選択します。
図43-20に示すように、アーカイブに組み込むアーティファクトのみ選択します。この例では、次のXSDファイルが含まれます。
SOADemoComposite/xsd/DemoProcess.xsd
SOADemoComposite/xsd/Quote.xsd
SOADemoComposite/xsd/VacationRequest.xsd
「OK」をクリックして、変更内容をJARデプロイメント・プロファイルに保存します。
「OK」をクリックして、新規デプロイメント・プロファイルを保存します。
「ファイル」メイン・メニューから「すべて保存」を選択します。
JARプロファイルを組み込むSOAバンドルを作成する手順は、次のとおりです。
「アプリケーション・メニュー」から、「アプリケーション・プロパティ」→「デプロイメント」の順に選択します。
「新規」をクリックして、SOAバンドル・プロファイルを作成します。
「デプロイメント・プロファイルの作成」ダイアログが表示されます。
「アーカイブ・タイプ」リストから、「SOAバンドル」を選択します。バンドルは、複数のSOAコンポジット・アプリケーションの集まりです。
「名前」フィールドに名前(例ではsharedArtifactBundle)を入力します。図43-21に詳細を示します。
「OK」をクリックします。
左側のナビゲーション・ツリーから「依存性」を選択します。
以前に作成したJARファイルおよびSOA-SARプロファイルを選択します(この例では、それぞれshared_archiveおよびsharedArtifactBundle)。JAR、SOA-SARまたは両方のいずれかを選択できます。図43-22に詳細を示します。
「OK」をクリックして、SOAバンドル・デプロイメント・プロファイルの変更内容を保存します。
「OK」をクリックして、新規デプロイメント・プロファイルを保存します。
「ファイル」メイン・メニューから「すべて保存」を選択します。
Oracle JDeveloperでSOAバンドルをデプロイする手順は、次のとおりです。
「アプリケーション」メニューを右クリックし、「デプロイ」→「SOA_Bundle_Name」の順に選択します。
これによりデプロイメント・ウィザードが起動します。
指定するレスポンスの詳細は、第43.7.1.3項「プロファイルのデプロイ」の手順3を参照してください。
これによって、SOAバンドルがアプリケーション・サーバーにデプロイされます(共有アーティファクトがOracle SOA SuiteのOracle MDSリポジトリ・データベースにデプロイされます)。
antでSOAバンドルをデプロイする手順は、次のとおりです。
この項では、第43.7.3項「Oracle JDeveloperでの複数のSOAコンポジット・アプリケーション間の共有データのデプロイ方法および使用方法」で作成した共有データを参照および選択する方法について説明します。
SOA-MDS接続を作成する手順は、次のとおりです。
「ファイル」メニューから、「新規」→「接続」→SOA-MDS接続の順に選択します。
図43-23に示す「SOA-MDS接続の作成」ダイアログが表示されます。
表43-8に示すように、環境に適した値を指定します。
表43-8 「SOA-MDS接続の作成」ダイアログ
| フィールド | 説明 |
|---|---|
|
接続の作成 |
「IDE接続」が選択されていることを確認します。このオプションによって、接続が「リソース・パレット」に表示され、複数のアプリケーションで使用可能になります。 「アプリケーション・リソース」オプションで接続を作成することはできません。この選択は無効化されています。 |
|
接続名 |
接続名を入力します。この接続の作成が正常に完了すると、この名前が「リソース・パレット」のSOA-MDSの下に表示されます。 |
|
接続タイプ |
接続タイプを選択します。Oracle MDSリポジトリはファイル・ベースまたはデータベース・ベースのいずれかです。選択内容に基づいてダイアログがリフレッシュされます。
|
|
データベース接続を選択します。 |
既存の接続を選択するか、MDSスキーマが含まれているOracle SOA Suiteデータベースへの新規接続を作成します。 |
|
MDSパーティションの選択 |
MDSパーティション(例: soa-infra)を選択します。 |
|
接続のテスト |
SOA-MDS接続をテストする場合にクリックします。 注意: 接続テストに失敗した場合でも接続は作成されます。 |
|
ステータス |
接続テストのステータスが表示されます。 |
「OK」をクリックします。
これで、「リソース・パレット」で接続を参照し、/appsノードの下に表示される共有アーティファクトを確認できます。
これで、様々なSOAコンポジット・アプリケーションから共有データを参照し、使用できる状態になりました。この例では、様々なアプリケーションにBPELプロセス・サービス・コンポーネントを作成します。
BPELプロセスを作成する手順は、次のとおりです。
様々なアプリケーションに新規BPELプロセス・サービス・コンポーネントを作成します。
「BPELプロセスの作成」ダイアログで、「入力」フィールドの右側にある「参照」アイコンをクリックします。
「タイプ・チューザ」ダイアログが表示されます。
右上隅にある「スキーマ・ファイルのインポート」アイコンをクリックします。
「スキーマ・ファイルのインポート」ダイアログが表示されます。
「URL」フィールドの右側にある「参照」アイコンをクリックします。
「SOAリソース・ブラウザ」ダイアログが表示されます。
ダイアログ上部にあるリストから、「リソース・パレット」を選択します。
図43-24に示すように、共有データを選択します。この例では、第43.7.3.1項「JARプロファイルの作成および共有するアーティファクトの組込み」の手順18でアーカイブへの組込みを選択したQuote.xsdファイルが選択されています。
「OK」をクリックします。
「スキーマ・ファイルのインポート」ダイアログで「OK」をクリックします。
「タイプ・チューザ」ダイアログで、Quote.xsdのノード(この例ではQuoteRequest)を選択し、「OK」をクリックします。
「BPELプロセスの作成」ダイアログで、「OK」をクリックして作成を完了します。
「アプリケーション・ナビゲータ」で、BPELプロセスのWSDLファイルを選択します。
「ソース」をクリックします。
WSDLファイルには、次の定義が含まれています。
<wsdl:types>
<schema xmlns="http://www.w3.org/2001/XMLSchema">
<import namespace="http://www.mycompany.com/ns/salesquote"
schemaLocation="oramds:/apps/SOADemoComposite/xsd/Quote.xsd" />
</schema>
</wsdl:types>
必要に応じて、BPELプロセスのモデル化を続行します。
BPELプロセスを組み込んだSOAコンポジット・アプリケーションをデプロイします。
Oracle JDeveloperの「アプリケーション・サーバー・ナビゲータ」から、既存のSOAアーカイブをデプロイできます。
|
注意:
|
Oracle JDeveloperから既存のSOAアーカイブをデプロイする手順は、次のとおりです。
「表示」メニューから、「アプリケーション・サーバー・ナビゲータ」を選択します。
接続名を展開します。
「SOA」フォルダを右クリックします。
「SOAアーカイブのデプロイ」を選択します。
図43-25に示す「SOAアーカイブのデプロイ」ダイアログが表示されます。
表43-9の説明に従って、環境に適した値を指定します。
表43-9 「デプロイメント・プロファイルの作成」ダイアログのフィールドと値
| フィールド | 説明 |
|---|---|
|
SOAサーバー |
アーカイブをデプロイするSOAサーバーを選択します。 |
|
パーティション |
アーカイブをデプロイするパーティションを選択します。サーバーにパーティションがない場合、このアーカイブはデプロイできません。デフォルトでは、Oracle SOA Suiteには、defaultという名前のパーティションが自動的に含まれています。 |
|
ステータス |
サーバーのステータスが表示されます。サーバーが実行中の状態でない場合、このアーカイブはデプロイできません。 |
|
サーバーURL |
サーバーのURLが表示されます。 |
|
このアーカイブをデプロイするターゲットSOAサーバーを選択します |
アーカイブをデプロイするOracle WebLogic管理サーバーを選択します。 |
|
SOAアーカイブ |
「参照」をクリックして、ビルトインのSOAコンポジット・アプリケーション・アーカイブを選択します。アーカイブは、単一アプリケーションのJARファイル、または複数のアプリケーションを含むSOAバンドルZIPファイルで構成されています。 |
|
構成プラン(オプション) |
「参照」をクリックして、SOAコンポジット・アプリケーション・アーカイブに添付する構成プランを選択します。構成プランにより、様々な環境で使用するURLおよびプロパティ値を定義できます。プロセスのデプロイメント時に、構成プランを使用してSOAプロジェクトを検索し、プロジェクトを次に進むターゲット環境に適応させるために置換する必要がある値を検索します。 構成プランの作成方法については、第43.6.1.4項「Oracle JDeveloperでの構成プランの作成方法」または第43.6.1.5項「WLSTユーティリティを使用した構成プランの作成方法」を参照してください。 |
|
コンポジット・リビジョンをデフォルトとしてマークします。 |
新規リビジョンをデフォルトにしない場合は、このボックスの選択を解除できます。デフォルトでは、新しくデプロイしたコンポジット・リビジョンがデフォルトになります。このリビジョンは、新しいリクエストを受信するとインスタンス化されます。 |
|
同じリビジョンIDで既存のコンポジットを上書きします。 |
同じリビジョンIDを持つ既存のSOAコンポジット・アプリケーションを上書き(再デプロイ)する場合に選択します。このアクションを実行すると、次のような結果になります。
|
「OK」をクリックします。
「アプリケーション・サーバー・ナビゲータ」からSOAコンポジット・アプリケーションをデプロイおよびテストする方法の詳細は、第2.8項「SOAコンポジット・アプリケーションの管理とテスト」を参照してください。
WLSTユーティリティを使用して、SOAコンポジット・アプリケーションを管理できます。このユーティリティは、自動化に適しており、既存リリースのプロセスに容易に統合できます。手順は、『Oracle Fusion Middleware WebLogic Scripting Tool Command Reference』を参照してください。
antユーティリティを使用して、SOAコンポジット・アプリケーションを管理できます。antはJavaベースのビルド・ツールであり、SOAコンポジット・アプリケーションを管理するためにOracle SOA Suiteで使用されます。構成ファイルはXMLベースであり、様々なタスクが実行されるターゲット・ツリーをコールします。ant ユーティリティは、自動化に適しており、既存リリースのプロセスに容易に統合できます。
|
注意: Oracle SOA Suiteのantスクリプトを使用する前に、setDomainEnv.shスクリプト(Linuxの場合)またはsetDomainEnv.cmdスクリプト(Windowsの場合)を実行する必要があります。このスクリプトによって、antを使用するために必要なJARファイルがクラスパスに追加されます。 |
表43-10に、Middleware_Home\SOA_Suite_Home\binディレクトリで使用可能なantスクリプトを示します。
表43-10 ant管理スクリプト
| スクリプト | 説明 |
|---|---|
|
|
SOAコンポジット・アプリケーションのテストを自動化します。 |
|
|
SOAコンポジット・アプリケーションをコンパイルします。 |
|
|
SOAコンポジット・アプリケーションをコンポジットSARファイルにパッケージ化します。 |
|
|
SOAコンポジット・アプリケーションをデプロイします。 |
|
|
SOAコンポジット・アプリケーションをアンデプロイします。 |
|
|
コンポジットをSARファイルにエクスポートします。 |
|
|
コンポジットのデプロイメント後の変更をJARファイルにエクスポートします。 |
|
|
コンポジットのデプロイメント後の変更をインポートします。 |
|
|
指定したパターンの共有データをJARファイルにエクスポートします。 |
|
|
トップレベルの共有データ・フォルダを削除します。 |
|
|
SOAコンポジット・アプリケーションを起動します。 |
|
|
SOAコンポジット・アプリケーションを停止します。 |
|
|
SOAコンポジット・アプリケーションをアクティブ化します。 |
|
|
SOAコンポジット・アプリケーションをリタイアします。 |
|
|
デフォルトのリビジョン・バージョンを割り当てます。 |
|
|
デプロイ済のSOAコンポジット・アプリケーションが一覧表示されます。 |
|
|
SOAインフラストラクチャで使用可能なすべてのパーティションが一覧表示されます。 |
|
|
パーティション内のすべてのコンポジットが一覧表示されます。 |
|
|
SOAインフラストラクチャにパーティションを作成します。 |
|
|
パーティションを削除する前に、パーティション内のすべてのコンポジットをアンデプロイします。 |
|
|
パーティション内のすべてのコンポジットを起動します。 |
|
|
パーティション内のすべてのコンポジットを停止します。 |
|
|
パーティション内のすべてのコンポジットをアクティブ化します。 |
|
|
パーティション内のすべてのコンポジットをリタイアします。 |
|
|
BPELおよびOracle Enterprise Service Bus (ESB)リリース10.1.3のメタデータをリリース11gに移行します。 注意: プロジェクト内にJavaコードが含まれている場合、11gのコンパイラで正常にコンパイルするには、コードを手動で変更する必要があります。BPELプロセスのインスタンス・データについては、10.1.3 Oracle BPEL Serverで使用されるアクティブ・データは移行されません。 |
antの詳細は、次のURLを参照してください。
http://ant.apache.org
例43-6に、テスト・ケースの実行例を示します。テスト・ケースを使用すると、SOAコンポジット・アプリケーションのテストを自動化できます。
例43-6 アプリケーションのテスト
ant -f ant-sca-test.xml -Dscatest.input=MyComposite -Djndi.properties=/home/jdoe/jndi.properties
表43-11に、構文を示します。
表43-11 antテスト・コマンド
| 引数 | 定義 |
|---|---|
|
使用可能な入力は、次のとおりです。
|
|
JNDIプロパティ・ファイルの絶対パス。これは、サーバーに接続するためのJNDIプロパティが含まれているプロパティ・ファイルです。例: java.naming.factory.initial=weblogic.jndi.WLInitialContextFactory java.naming.provider.url=t3://myserver.us.example.com:8001/soa-infra java.naming.security.principal=weblogic dedicated.connection=true dedicated.rmicontext=true (テスト・スイート内の)コンポジット・テストはSOAインフラストラクチャで実行されるため、このプロパティ・ファイルには接続情報が含まれています。この例では、これらのプロパティによって、 通常は、1つの |
SOAコンポジット・アプリケーションにおけるテストの作成方法および実行方法の詳細は、第44章「SOAコンポジット・アプリケーションのテストの自動化」および『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』を参照してください。
例43-7に、SOAコンポジット・アプリケーションのコンパイル例を示します。このコンパイルでは、アプリケーションの構造および構文が検証されます。
例43-7 アプリケーションのコンパイル
ant -f ant-sca-compile.xml -Dscac.input=/myApplication/myComposite/composite.xml
表43-12に、構文を示します。
表43-12 antコンパイル・コマンド
| 引数 | 定義 |
|---|---|
scac |
使用可能な入力は、次のとおりです。
|
例43-8に、SOAコンポジット・アプリケーションをコンポジットSARファイルにパッケージ化する例を示します。このコマンドの結果はSOAアーカイブです。結果ファイルの正確な場所については、コマンドの出力を確認してください。
例43-8 アプリケーションのパッケージ化
ant -f ant-sca-package.xml -DcompositeDir=C:\demo\end2end-105-POProcessing\po\solutions\ch9\POProcessing\POPr ocessing -DcompositeName=POProcessing -Drevision=6-cmdline -Dsca.application.home=C:\demo\end2end-105-POProcessing\po\solutions\ch9\POProces sing
表43-13に、構文を示します。
例43-9に、SOAコンポジット・アプリケーションのデプロイ例を示します。このコマンドを使用して、複数のSOAコンポジット・アプリケーション間でWSDL、XSD、および他のファイル・タイプなど共有データをデプロイすることもできます。共有データの詳細は、第43.7.3項「Oracle JDeveloperでの複数のSOAコンポジット・アプリケーション間の共有データのデプロイ方法および使用方法」を参照してください。
例43-9 アプリケーションのデプロイ
ant -f ant-sca-deploy.xml -DserverURL=http://localhost:8001 -DsarLocation=C:\demo\end2end-105-POProcessing\po\solutions\ch9\POProcessing\POPro cessing\deploy\sca_POProcessing_rev6-cmdline.jar -Doverwrite=true -Duser=weblogic -DforceDefault=true -Dconfigplan=C:\demo\end2end-105-POProcessing\po\solutions\ch9\POProcessing\POProc essing\demed_cfgplan.xml -Dscac.user.classpath=C:\jarfolder\custom.jar -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-14に、構文を示します。
表43-14 antデプロイメント・コマンド
| 引数 | 定義 |
|---|---|
|
|
SOAインフラストラクチャ・アプリケーションをホストするサーバーのURL(例: |
|
|
次のいずれかへの絶対パス。
|
|
|
オプション。サーバー上の既存のSOAコンポジット・アプリケーションを上書きするかどうかを指定します。
|
|
|
オプション。コンポジットのデプロイ実行者のサーブレットにアクセスするためのユーザー名(基本認証が構成されている場合)。 |
|
|
オプション。コンポジットのデプロイ実行者のサーブレットにアクセスするためのパスワード(基本認証が構成されている場合)。 ユーザー名を入力した場合、ここでパスワードを指定しないとパスワードの入力を求めるプロンプトが表示されます。 |
|
|
オプション。デプロイするバージョンを、そのコンポジット・アプリケーションに対するデフォルト・バージョンとして設定するかどうかを指定します。
|
|
|
指定したSARファイル、またはZIPファイルに組み込まれているすべてのSARファイルに適用される構成プランの絶対パス。 |
|
|
デバッグ用、SSL構成用など、特別なシステム・プロパティの設定に有効なシステム・プロパティ・ファイルを渡します。 ファイル名(例: javax.net.debug=all |
|
|
オプション。外部カスタム・ライブラリの名前。SOAコンポジット・アプリケーションのBPELプロセス・サービス・コンポーネントでカスタムJARファイルを参照している場合は、このプロパティを設定します。 |
|
|
オプション。SOAコンポジット・アプリケーションをデプロイするパーティションの名前。デフォルト値は |
例43-10に、SOAコンポジット・アプリケーションのアンデプロイ例を示します。
例43-10 SOAコンポジット・アプリケーションのアンデプロイ
ant -f ant-sca-deploy.xml undeploy -DserverURL=http://localhost:8001 -DcompositeName=POProcessing -Drevision=rev6-cmdline -Duser=weblogic -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-15に、構文を示します。
表43-15 antアンデプロイメント・コマンド
| 引数 | 定義 |
|---|---|
|
|
SOAインフラストラクチャ・アプリケーションをホストするサーバーのURL(例: |
|
|
SOAコンポジット・アプリケーションの名前。 |
|
|
SOAコンポジット・アプリケーションのリビジョンID。 |
|
|
オプション。コンポジットのデプロイ実行者のサーブレットにアクセスするためのユーザー名(基本認証が構成されている場合)。 ユーザー名を入力すると、対応するパスワードの入力を求めるプロンプトが表示されます。 |
|
|
オプション。コンポジットのデプロイ実行者のサーブレットにアクセスするためのパスワード(基本認証が構成されている場合)。 |
|
|
オプション。SOAコンポジット・アプリケーションが置かれているパーティションの名前。デフォルト値は |
例43-11に、SARファイルへのコンポジットのエクスポート例を示します。
例43-11 SARファイルへのコンポジットのエクスポート
ant -f ant-sca-deploy.xml exportComposite -DserverURL=server.url -DupdateType=update.type -DsarFile=sar.file -DcompositeName=composite.name -Drevision=revision -Duser=user
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-16に、構文を示します。
表43-16 antエクスポート・コマンド
| 引数 | 定義 |
|---|---|
|
|
SOAインフラストラクチャ・アプリケーションをホストするサーバーのURL(例: |
|
|
エクスポートに含めるデプロイメント後の変更のタイプ。
|
|
|
生成されるSARファイルの絶対パス。 |
|
|
エクスポートするコンポジットの名前。 |
|
|
エクスポートするコンポジットのリビジョン。 |
|
|
オプション。サーバーにアクセスするためのユーザー名(基本構成が構成されている場合)。 |
|
|
オプション。サーバーにアクセスするためのパスワード(基本構成が構成されている場合)。 |
例43-12は、デプロイメント後の変更を含めずにコンポジットをエクスポートする方法を示しています。
例43-12 コンポジットのエクスポート(デプロイメント後の変更を含めない場合)
ant -f ant-sca-deploy.xml exportComposite -DserverURL=http://myhost:8001
-DupdateType=none
-DsarFile=/tmp/sca_HelloWorld_rev1.0.jar -DcompositeName=HelloWorld
-Drevision=1.0
例43-13は、デプロイメント後のすべての変更を含めてコンポジットをエクスポートする方法を示しています。
例43-13 コンポジットのエクスポート(デプロイメント後のすべての変更を含める場合)
ant -f ant-sca-deploy.xml exportComposite -DserverURL=http://myhost:8001
-DupdateType=all
-DsarFile=/tmp/sca_HelloWorld_rev1.0-all.jar -DcompositeName=HelloWorld
-Drevision=1.0
例43-14は、デプロイメント後のプロパティ更新を含めてコンポジットをエクスポートする方法を示しています。
例43-14 コンポジットのエクスポート(デプロイメント後のプロパティ更新を含める場合)
ant -f ant-sca-deploy.xml exportComposite -DserverURL=http://myhost:8001
-DupdateType=property
-DsarFile=/tmp/sca_HelloWorld_rev1.0-prop.jar -DcompositeName=HelloWorld
-Drevision=1.0
例43-15は、デプロイメント後のランタイム/メタデータ更新を含めてコンポジットをエクスポートする方法を示しています。
例43-16に、コンポジットのデプロイメント後の変更をJARファイルにエクスポートする例を示します。
例43-16 コンポジットのデプロイメント後の変更のJARファイルへのエクスポート
ant -f ant-sca-deploy.xml exportUpdates -DserverURL=server.url -DupdateType=update.type -DjarFile=jar.file -DcompositeName=composite.name -Drevision=revision -Duser=user
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-17に、構文を示します。
表43-17 antデプロイメント後エクスポート・コマンド
| 引数 | 定義 |
|---|---|
|
|
SOAインフラストラクチャ・アプリケーションをホストするサーバーのURL(例: |
|
|
エクスポートするデプロイメント後の変更のタイプ。
|
|
|
生成されるJARファイルの絶対パス。 |
|
|
エクスポートするコンポジットの名前。 |
|
|
エクスポートするコンポジットのリビジョン。 |
|
|
オプション。サーバーにアクセスするためのユーザー名(基本構成が構成されている場合)。 |
|
|
オプション。サーバーにアクセスするためのパスワード(基本構成が構成されている場合)。 |
例43-17は、デプロイメント後のすべての更新をエクスポートする方法を示しています。
例43-17 デプロイメント後のすべての更新のエクスポート
ant -f ant-sca-deploy.xml exportUpdates -DserverURL=http://myhost:8001
-DupdateType=all
-DjarFile=/tmp/all-HelloWorld_rev1.0.jar -DcompositeName=HelloWorld
-Drevision=1.0
例43-18は、デプロイメント後のプロパティ更新をエクスポートする方法を示しています。
例43-18 デプロイメント後のプロパティ更新のエクスポート
ant -f ant-sca-deploy.xml exportUpdates -DserverURL=http://myhost:8001
-DupdateType=property
-DjarFile=/tmp/prop-HelloWorld_rev1.0.jar -DcompositeName=HelloWorld
-Drevision=1.0
例43-19は、デプロイメント後のランタイム/メタデータ更新をエクスポートする方法を示しています。
例43-20に、コンポジットのデプロイメント後の変更をインポートする例を示します。
例43-20 コンポジットのデプロイメント後の変更のインポート
ant -f ant-sca-deploy.xml importUpdates -DserverURL=server.url -DjarFile=jar.file -DcompositeName=composite.name -Drevision=revision -Duser=user
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-18に、構文を示します。
表43-18 antデプロイメント後インポート・コマンド
| 引数 | 定義 |
|---|---|
|
|
SOAインフラストラクチャ・アプリケーションをホストするサーバーのURL(例: |
|
|
デプロイメント後の変更が含まれるJARファイルの絶対パス。 |
|
|
デプロイメント後の変更をインポートするコンポジットの名前。 |
|
|
デプロイメント後の変更をインポートするコンポジットのリビジョン。 |
|
|
オプション。サーバーにアクセスするためのユーザー名(基本構成が構成されている場合)。 |
|
|
オプション。サーバーにアクセスするためのパスワード(基本構成が構成されている場合)。 |
例43-21は、コンポジットのデプロイメント後の変更をインポートする方法を示しています。
例43-22に、指定したパターンの共有データをJARファイルにエクスポートする例を示します。
例43-22 指定したパターンの共有データのJARファイルへのエクスポート
ant -f ant-sca-deploy.xml exportSharedData -DserverURL=server.url -DjarFile=jar.file -Dpattern=pattern -Duser=user
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-19に、構文を示します。
表43-19 ant共有データ・エクスポート・コマンド
| 引数 | 定義 |
|---|---|
|
|
SOAインフラストラクチャ・アプリケーションをホストするサーバーのURL(例: |
|
|
生成されるJARファイルの絶対パス。 |
|
|
Oracle MDSリポジトリ転送APIによってサポートされているファイル・パターン。複数のパターンを指定する場合はデリミタとしてセミコロン( /Project1/**;/Project2/** この例では、 |
|
|
オプション。サーバーにアクセスするためのユーザー名(基本構成が構成されている場合)。 |
|
|
サーバーにアクセスするためのパスワード(基本構成が構成されている場合)。このパラメータはオプションです。 |
例43-23は、指定したパターンの共有データをJARファイルにエクスポートする方法を示しています。
例43-24に、トップレベルの共有データ・フォルダを削除する例を示します(サービス・エンジンにデプロイされたコンポジットがある場合を含む)。
例43-24 トップレベルの共有データ・フォルダの削除
ant -f ant-sca-deploy.xml removeSharedData -DserverURL=server.url -DfolderName=folder.name -Duser=user
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-20に、構文を示します。
表43-20 ant共有データ・フォルダ削除コマンド
| 引数 | 定義 |
|---|---|
|
|
SOAインフラストラクチャ・アプリケーションをホストするサーバーのURL(例: |
|
|
削除するトップレベルの共有データ・フォルダの名前。 |
|
|
オプション。サーバーにアクセスするためのユーザー名(基本構成が構成されている場合)。 |
|
|
オプション。サーバーにアクセスするためのパスワード(基本構成が構成されている場合)。 |
例43-25は、Project1という名前のトップレベルの共有データ・フォルダを削除する方法を示しています。
例43-26に、SOAコンポジット・アプリケーションを起動する例を示します。
例43-26 SOAコンポジット・アプリケーションの起動
ant -f ant-sca-mgmt.xml startComposite -Dhost=myhost -Dport=8001 -Duser=weblogic -DcompositeName=HelloWorld -Drevision=1.0 -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-21に、構文を示します。
表43-21 ant SOAコンポジット・アプリケーション起動コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
SOAコンポジット・アプリケーションの名前。 |
|
|
SOAコンポジット・アプリケーションのリビジョン。 |
|
|
オプション。SOAコンポジット・アプリケーションのラベル。ラベルによって、アプリケーションに関連付けられているMDSアーティファクトが識別されます。ラベルを指定しない場合は、最新のラベルが検索されます。 |
|
|
オプション。SOAコンポジット・アプリケーションが置かれているパーティションの名前。デフォルト値は |
例43-27に、SOAコンポジット・アプリケーションを停止する例を示します。
ant -f ant-sca-mgmt.xml stopComposite -Dhost=myhost -Dport=8001 -Duser=weblogic -DcompositeName=HelloWorld -Drevision=1.0 -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-22に、構文を示します。
表43-22 ant SOAコンポジット・アプリケーション停止コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
SOAコンポジット・アプリケーションの名前。 |
|
|
SOAコンポジット・アプリケーションのリビジョン。 |
|
|
オプション。SOAコンポジット・アプリケーションのラベル。ラベルによって、アプリケーションに関連付けられているMDSアーティファクトが識別されます。ラベルを指定しない場合は、最新のラベルが検索されます。 |
|
|
オプション。SOAコンポジット・アプリケーションが置かれているパーティションの名前。デフォルト値は |
例43-28に、SOAコンポジット・アプリケーションをアクティブ化する例を示します。
例43-28 SOAコンポジット・アプリケーションのアクティブ化
ant -f ant-sca-mgmt.xml activateComposite -Dhost=myhost -Dport=8001 -Duser=weblogic-DcompositeName=HelloWorld -Drevision=1.0 -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-23に、構文を示します。
表43-23 ant SOAコンポジット・アプリケーション・アクティブ化コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
SOAコンポジット・アプリケーションの名前。 |
|
|
SOAコンポジット・アプリケーションのリビジョン。 |
|
|
オプション。SOAコンポジット・アプリケーションのラベル。ラベルによって、アプリケーションに関連付けられているMDSアーティファクトが識別されます。ラベルを指定しない場合は、最新のラベルが検索されます。 |
|
|
オプション。SOAコンポジット・アプリケーションが置かれているパーティションの名前。デフォルト値は |
例43-29に、SOAコンポジット・アプリケーションのリタイア例を示します。
例43-29 SOAコンポジット・アプリケーションのリタイア
ant -f ant-sca-mgmt.xml retireComposite -Dhost=myhost -Dport=8001 -Duser=weblogic -DcompositeName=HelloWorld -Drevision=1.0 -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-24に、構文を示します。
表43-24 ant SOAコンポジット・アプリケーション・リタイア・コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
SOAコンポジット・アプリケーションの名前。 |
|
|
SOAコンポジット・アプリケーションのリビジョン。 |
|
|
オプション。SOAコンポジット・アプリケーションのラベル。ラベルによって、アプリケーションに関連付けられているMDSアーティファクトが識別されます。ラベルを指定しない場合は、最新のラベルが検索されます。 |
|
|
オプション。SOAコンポジット・アプリケーションが置かれているパーティションの名前。デフォルト値は |
例43-30に、デフォルト・バージョンをSOAコンポジット・アプリケーションに割り当てる例を示します。
例43-30 SOAコンポジット・アプリケーションへのデフォルト・バージョンの割当て
ant -f ant-sca-mgmt.xml assignDefaultComposite -Dhost=myhost -Dport=8001 -Duser=weblogic -DcompositeName=HelloWorld -Drevision=1.0 -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-25に、構文を示します。
表43-25 ant SOAコンポジット・アプリケーション・デフォルト・バージョン割当てコマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
SOAコンポジット・アプリケーションの名前。 |
|
|
SOAコンポジット・アプリケーションのリビジョン。 |
|
|
オプション。SOAコンポジット・アプリケーションが置かれているパーティションの名前。デフォルト値は |
例43-31に、デプロイ済SOAコンポジット・アプリケーションを一覧表示する例を示します。
例43-31 デプロイ済SOAコンポジット・アプリケーションの一覧表示
ant -f ant-sca-mgmt.xml listDeployedComposites -Dhost=myhost -Dport=8001 -Duser=weblogic
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-26に、構文を示します。
例43-32に、SOAインフラストラクチャで使用可能なすべてのパーティションを一覧表示するための構文を示します。
例43-32 SOAインフラストラクチャで使用可能なすべてのパーティションの一覧表示
ant -f ant-sca-mgmt.xml listPartitions -Dhost=host -Dport=port -Duser=user
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-27に、構文を示します。
表43-27 ant SOAインフラストラクチャ・パーティション一覧表示コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
例43-33に、SOAインフラストラクチャで使用可能なすべてのパーティションを一覧表示する例を示します。
例43-34に、パーティション内のすべてのコンポジットを一覧表示するための構文を示します。
例43-34 パーティション内のすべてのコンポジットの一覧表示
ant -f ant-sca-mgmt.xml listCompositesInPartition -Dhost=host -Dport=port -Duser=user -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-28に、構文を示します。
表43-28 ant コンポジット・パーティション一覧表示コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
パーティションの名前。 |
例43-35に、myPartitionというパーティション内のすべてのコンポジットを一覧表示する例を示します。
例43-36に、SOAインフラストラクチャにパーティションを作成するための構文を示します。
例43-36 SOAインフラストラクチャでのパーティションの作成
ant -f ant-sca-mgmt.xml createPartition -Dhost=host -Dport=port -Duser=user
-Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-29に、構文を示します。
表43-29 antパーティション作成コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
作成するパーティションの名前。 |
例43-37に、SOAインフラストラクチャにmyPartitionというパーティションを作成する例を示します。
例43-38に、SOAインフラストラクチャのパーティションを削除するための構文を示します。このコマンドは、パーティションを削除する前に、パーティション内のすべてのコンポジットをアンデプロイします。
例43-38 SOAインフラストラクチャでのパーティションの削除
ant -f ant-sca-mgmt.xml deletePartition -Dhost=host -Dport=port -Duser=user
-Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-30に、構文を示します。
表43-30 antパーティション削除コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
削除するパーティションの名前。 |
例43-39に、SOAインフラストラクチャにあるmyPartitionというパーティションを削除する例を示します。
例43-40に、パーティション内のすべてのコンポジットを起動するための構文を示します。
例43-40 パーティション内のすべてのコンポジットの起動
ant -f ant-sca-mgmt.xml startCompositesInPartition -Dhost=host -Dport=port
-Duser=user -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-31に、構文を示します。
表43-31 antパーティション起動コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
パーティションの名前。 |
例43-41に、myPartitionというパーティション内のすべてのコンポジットを起動する例を示します。
例43-42に、パーティション内のすべてのコンポジットを停止するための構文を示します。
例43-42 パーティション内のすべてのコンポジットの停止
ant -f ant-sca-mgmt.xml stopCompositesInPartition -Dhost=host -Dport=port
-Duser=user -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-32に、構文を示します。
表43-32 antパーティション・コンポジット停止コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
パーティションの名前。 |
例43-43に、myPartitionというパーティション内のすべてのコンポジットを停止する例を示します。
例43-44に、パーティション内のすべてのコンポジットをアクティブ化するための構文を示します。
例43-44 パーティション内のすべてのコンポジットのアクティブ化
ant -f ant-sca-mgmt.xml activateCompositesInPartition -Dhost=host -Dport=port
-Duser=user -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-33に、構文を示します。
表43-33 antパーティション・コンポジット・アクティブ化コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
パーティションの名前。 |
例43-45に、myPartitionというパーティション内のすべてのコンポジットをアクティブ化する例を示します。
例43-46に、パーティション内のすべてのコンポジットをリタイアするための構文を示します。
例43-46 パーティション内のすべてのコンポジットのリタイア
ant -f ant-sca-mgmt.xml retireCompositesInPartition -Dhost=host -Dport=port
-Duser=user -Dpartition=partition.name
|
注意: ユーザー名の指定後、プロンプトが表示された場合はパスワードを入力してください。 |
表43-34に、構文を示します。
表43-34 antパーティション・コンポジット・リタイア・コマンド
| 引数 | 定義 |
|---|---|
|
|
Oracle WebLogic Serverのホスト名(例: |
|
|
Oracle WebLogic Serverのポート(例: |
|
|
実行中のサーバーに接続してMBean情報を取得するためのユーザー名(例: |
|
|
ユーザー名に対応するパスワード。 |
|
|
パーティションの名前。 |
例43-47に、myPartitionというパーティション内のすべてのコンポジットをリタイアする例を示します。
antを使用すると、SOAコンポジット・アプリケーションを10.1.3から11gにアップグレードできます。詳細は、『Oracle Fusion Middleware Oracle SOA Suite, WebCenterおよびADFアップグレード・ガイド』を参照してください。
WebLogic Fusion Order Demoアプリケーションには、antスクリプトを使用してアプリケーションをコンパイル、パッケージ化およびデプロイする例が用意されています。初期antビルド・ファイルを作成するには、「ファイル」メイン・メニューから、「新規」→「Ant」→「プロジェクトからのビルドファイル」の順に選択します。
図43-26は、build.propertiesおよびbuild.xmlファイルが、作成後に「アプリケーション・ナビゲータ」に表示された状態を示しています。
build.properties
環境を反映するために編集するファイル(例: OracleホームおよびJavaホーム・ディレクトリの指定、デプロイメントに使用するホスト名やポート番号などのサーバー・プロパティの設定、デプロイするアプリケーションの指定など)。
build.xml
antによって、build.propertiesファイルで指定したコンポジット・アプリケーションのコンパイル、ビルド、およびサーバーへのデプロイのために使用されます。
環境を反映するようにbuild.propertiesファイルを変更します。
「ビルド」メニューから、「project_nameでAntを実行」を選択します。
この結果、現在のプロジェクトのビルド・ファイルに定義されているターゲットがビルドされます。
SOAコンポジット・アプリケーションは、Oracle Enterprise Manager Fusion Middleware Controlからデプロイできます。最初に、デプロイ可能なアーカイブをOracle JDeveloperで作成するか、antやWLSTコマンドライン・ツールを使用して作成する必要があります。このアーカイブは、JARファイル内の単一のSOAコンポジット・アプリケーションのリビジョン、またはZIPファイル内の複数のコンポジット・アプリケーションのリビジョン(SOAバンドルと呼ばれます)で構成できます。詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドを参照してください。
この項では、デプロイメント後の構成タスクについて説明します。
SOAコンポジット・アプリケーションの保護の詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』を参照してください。
アプリケーション・サーバーまたはOracle MDSリポジトリに対して作成したすべての接続が、次に進むターゲット環境に適用可能なサーバーを指すように再作成されていることを確認します。詳細は、第43.7.1.1項「アプリケーション・サーバー接続の作成」および第43.7.3.4.1項「SOA-MDS接続の作成」を参照してください。
構成済のすべてのJDBCデータ・ソース、キューおよびコネクション・ファクトリの場所が、次に進むターゲット環境に適用可能であることを確認します。詳細は、第43.5.1項「データ・ソースおよびキューの作成方法」および第43.5.2項「コネクション・ファクトリおよび接続プールの作成方法」を参照してください。
この項では、SOAコンポジット・アプリケーションのテストおよびトラブルシューティングの方法について説明します。
SOAコンポジット・アプリケーションがSOAインフラストラクチャに正常にデプロイされたことを検証できます。正常にデプロイされた場合は、Oracle Enterprise Manager Fusion Middleware Controlの「SOAインフラストラクチャ」ページの「デプロイ済コンポジット」タブにデプロイされたコンポジットが表示されます。詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドを参照してください。
デプロイ済SOAコンポジット・アプリケーションのインスタンスは、Oracle Enterprise Manager Fusion Middleware Controlの「テスト・インスタンス」ページから開始できます。詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドを参照してください。
SOAコンポジット・アプリケーションのテストを自動化するテスト・ケースを作成、デプロイおよび実行できます。テスト・ケースを使用すると、本番環境へのデプロイメントの前に、SOAコンポジット・アプリケーションとWebサービス・パートナ間の相互作用をシミュレートできます。Oracle JDeveloperでテスト・ケースを作成し、SOAコンポジット・アプリケーションに組み込みます。このアプリケーションは、その後、Oracle Enterprise Manager Fusion Middleware Controlからデプロイされて管理されます。その後、Oracle Enterprise Manager Fusion Middleware Controlからテスト・ケースを実行します。
テスト・ケースの作成方法の詳細は、第44章「SOAコンポジット・アプリケーションのテストの自動化」を参照してください。
Oracle Enterprise Manager Fusion Middleware Controlからのテスト・ケースの実行の詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』を参照してください。
Oracle JDeveloperからのSOAコンポジット・アプリケーションのデプロイ時に例43-48に示すエラーを受け取った場合は、プロジェクトを再コンパイルし、コンポジットを再デプロイします。このエラーは断続的に発生するため、再度発生しないようにする必要があります。
例43-48 断続的なデプロイメント・エラー・メッセージ
Error deploying BPEL suitcase. error while attempting to deploy the BPEL component file "/scratch/aime1/work/mw9507/user_projects/domains/WLS_SOAWC/deployed-composites /ManagementChainParticipantRuleComposite_rev1.0/sca_ManagementChainParticipantR uleComposite_rev1.0/soa_59d10d76-08a5-41f0-ba89-32dcc2250002"; the exception reported is: java.lang.Exception: BPEL 1.1 compilation failed This error contained an exception thrown by the underlying deployment module. Verify the exception trace in the log (with logging level set to debug mode). at com.collaxa.cube.engine.deployment.DeploymentManager.deployComponent(Deployment Manager.java:197) at com.collaxa.cube.ejb.impl.CubeServerManagerBean._deployOrLoadComponent(CubeServ erManagerBean.java:820) at com.collaxa.cube.ejb.impl.CubeServerManagerBean.deployComponent(CubeServerManag erBean.java:119)
例43-49に示すJavaのコンパイル・エラーがサーバーのログ・ファイルに表示された場合は、Javaクラス内のコードが多すぎる可能性があります。
例43-49 Javaのコンパイル・エラー
Failed to compile bpel generated classes.
failure to compile the generated BPEL classes for BPEL process
"Review_Supply_Plan_ProcessProcess" of composite "default/Review_Supp
ly_Plan_Process!1.0*a9ca2907-8540-4375-b672-ceb560d7b826"
The class path setting is incorrect.
Ensure that the class path is set correctly. If this happens on the server
side, verify that the custom classes or jars which this BPEL process is
depending on are deployed correctly. Also verify that the runtime is using
the same release/version.
. . .
. . .
at
com.collaxa.cube.lang.compiler.template.CubeProcessGenerator.compile(CubeProce
ssGenerator.java:304)
at
com.collaxa.cube.lang.compiler.template.CubeProcessGenerator.generate(CubeProc
essGenerator.java:164)
at
com.collaxa.cube.lang.compiler.BPEL1Processor.transform(BPEL1Processor.java:25
7)
at
com.collaxa.cube.lang.compiler.BPEL1Processor.process(BPEL1Processor.java:161)
Javaのコンパイル・エラーを解決するためにJavaコード・サイズを削減する手順は、次のとおりです。
$MIDDLEWARE_HOME/user_projects/domains/domain_name/bin/SetDomainEnv.shファイル(Linux)またはSetDomainEnv.batファイル(Windows)を開きます。
このファイルでEXTRA_JAVA_PROPERTIES="-Dorabpel.codegen.density"プロパティを見つけます。このプロパティが明示的に設定されていない場合、デフォルトで64,32の値に設定されます。
次のように値を削減します。
EXTRA_JAVA_PROPERTIES="-Dorabpel.codegen.density=32,16"
これらの2つの値を削減することによって、コンパイルされたプロセス・マップに対して生成されるクラスおよびメソッドの数を増やします。デフォルト設定を使用したコンパイルのプロセスが失敗した場合は、ベスト・プラクティスとして、プロパティをより小さい値に設定します。次の値の組合せを試してみることをお薦めします。
32,16 16,8 8,4 4,2
変更内容を保存します。
サーバーを再起動します。
SOAコンポジット・アプリケーションを再コンパイルします。
この項では、デプロイメントに関する共通のエラーのトラブルシューティング方法について説明します。
コンポジット・アプリケーションに関する一般的な問題のトラブルシューティングについては、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』を参照してください。
この項では、チェックが必要なデプロイメントに関する共通の問題について説明します。
単一のコンポジット・アプリケーションをデプロイする場合は、「プロジェクト」メニューからデプロイしていることを確認してください。「アプリケーション・ナビゲータ」でプロジェクト名を右クリックし、「デプロイ」→「SOA_profile_name」の順に選択します。
複数のコンポジット・アプリケーションをデプロイする場合は、「アプリケーション」メニューからデプロイしていることを確認してください(「アプリケーション・ナビゲータ」でアプリケーション名を右クリックし、「デプロイ」→「SOA_bundle_profile_name」の順に選択します)。
「デプロイ」をクリックしてプロファイル名を選択した後は、デプロイメント・ウィザードの「デプロイメント・アクション」ページが表示されていることを確認してください。
必要に応じて、新規リビジョンID(オプション)を入力し、構成プラン(ある場合)を選択します。
デプロイするコンポジット・アプリケーションが同じリビジョンIDでサーバー上にすでに存在している場合は、デプロイメント・ウィザードの「構成のデプロイ」ページで「同じリビジョンIDで既存のコンポジットを上書きします。」チェック・ボックスを選択します。このオプションを選択しないと、デプロイメントは失敗します。
コンパイルが失敗すると、デプロイメント・エラーではなくコンパイル・エラーが発生します。このエラーは、プロジェクトのコンパイル時にのみ表示されます。
コンパイラのメッセージで不十分な場合は、コンパイラ・ログを確認してください。このログ・ファイル(scac.log)へのリンクは、「メッセージ」タブに表示されます。このメッセージは例43-50のようになります。
コンパイルが成功すると、コンポジットに対してSAR/SOAバンドル・アーカイブが作成されます。SARアーカイブの場合は、例43-51に示すメッセージが「デプロイメント」タブに表示されます。
例43-51 アーカイブ・メッセージ
Wrote Archive Module to /scratch/myhome/jdevWorkarea/mywork/Application11/FirstComposite/deploy/sca_ FirstComposite_rev1.0.jar
SOAバンドル・アーカイブの場合は、例43-52に示すメッセージが「デプロイメント」タブに表示されます。
例43-52 アーカイブ・メッセージ
Wrote Archive Module to /scratch/myhome/jdevWorkarea/mywork/Application11/SecondComposite/deploy/sca_ SecondComposite_rev1.0.jar Wrote Archive Module to /scratch/myhome/jdevWorkarea/mywork/Application11/FirstComposite/deploy/sca_ FirstComposite_rev1.0.jar Wrote Archive Module to /scratch/myhome/jdevWorkarea/mywork/Application11/deploy/soabundle1.zip
SARファイルのすべてのURLが、次の形式であることを確認します。
sca_CompositeName_revRevisionID.jar
たとえば、sca_FirstComposite_rev1.0.jarのようになります。
この後、Oracle JDeveloperはサーバーにアーカイブ・バイナリを送信します。次のメッセージが「デプロイメント」タブに表示されます。この時点で、Oracle JDeveloperのデプロイメント・ロールは終了し、サーバー(SOAインフラストラクチャ)がデプロイメントを制御します。
Deploying sca_FirstComposite_rev1.0.jar to myhost19:7001
デプロイメントが成功すると、例43-53に示すメッセージが「デプロイメント」タブに表示されます。
デプロイメントが失敗すると、例43-54に示すメッセージ、およびサーバーからのエラー・メッセージ(ある場合)が「デプロイメント」タブに表示されます。
ほとんどの場合、サーバー上で発生したエラーに関する情報はサーバーから提供されます。サーバーからのエラー・メッセージが表示されない場合は、サーバーでsoa_server1-diagnostic.logをチェックして追加情報を検索してください(soa_server1は管理対象サーバーの名前です)。このファイルは、サーバーのdomain_home/servers/soa_server1/logsにあります。
この項では、チェックが必要な構成プランに関する共通の問題について説明します。
デプロイするために選択した構成プランがサーバー上で有効にならない場合は、その構成プランが含まれているSARファイルを開きます。ファイルの場所は、Oracle JDeveloperの「デプロイメント」タブで検索できます。例43-55に詳細を示します。
JARファイルを開き、soaconfigplan.xmlファイルが含まれていることを確認します。このファイルは、選択した構成プランに基づいてデプロイメント時に生成されます。
このファイルが存在しない場合は、コンポジット・アプリケーションを再度デプロイして、デプロイメント・ウィザードの「構成のデプロイ」ページで構成プランを正しく選択したことを確認してださい。
Oracle WebLogic管理サーバーを起動せずに管理対象Oracle WebLogic Serverを起動し(独立モードでの実行と呼ばれます)、Oracle JDeveloperからSOAコンポジット・アプリケーションをデプロイしようとすると、次のエラーが発生します。
Deployment cannot continue! No SOA Configured target servers found
Oracle WebLogic管理サーバーは実行中である必要があります。デプロイメントでは、Oracle SOA Suiteを実行しているサーバーの識別にOracle WebLogic管理サーバー接続が使用されます。さらに、管理対象サーバーへのアプリケーション・サーバー接続は作成しないでください。Oracle WebLogic管理サーバーへの接続のみ作成してください。
また、SOA構成済Oracle WebLogic Serverの状態が正常でない場合も同様のエラーが発生する場合があります。この状態は、Oracle WebLogic Server管理コンソールの「サーバー」ページの「ヘルス」列に表示されます。
WLSTを使用すると、Oracle WebLogic管理サーバーを起動せずに、SOAコンポジット・アプリケーションを管理対象Oracle WebLogic Serverにデプロイできます。詳細は、第43.7.5項「WLSTユーティリティを使用したSOAコンポジット・アプリケーションの管理方法」を参照してください。
Oracle JDeveloperから双方向のSSL対応Oracle WebLogic Serverへのデプロイメントは、サポートされていません。
Oracle JDeveloperで設定したプロキシ・サーバーがホストから接続できない場合は、SOAコンポジット・アプリケーションのデプロイメント時に、図43-27に示すようなエラーが表示されます。
ネットワークの外部にあるSOAインフラストラクチャ(例: soa_server1)にアクセスするには、有効なプロキシ設定が必要です。SOAインフラストラクチャがネットワーク内にある場合は、次のいずれかの処理を実行します。
プロキシ設定を変更する手順は、次のとおりです。
「ツール」メニューから、「プリファレンス」→「Webブラウザとプロキシ」の順に選択します。
SOAサーバーがネットワーク内にある場合は、次のいずれかのタスクを実行します。
プロキシを使用せずにSOAインフラストラクチャに直接アクセスする場合は、「HTTPプロキシ・サーバーを使用」の選択を解除します。
「例外」フィールドに、接続できないSOAサーバーのホスト名を入力します。
SOAコンポジット・アプリケーションのJARファイルおよびADFタスク・フォームのEARファイルをデプロイする場合、SOA JARファイルは正常にデプロイされますが、EARファイルのデプロイ時に次のエラーが表示されます。
[wldeploy] weblogic.management.ManagementException: [Deployer:149163]The domain edit lock is owned by another session in non-exclusive mode - this deployment operation requires exclusive access to the edit lock and hence cannot proceed. If you are using "Automatically Aquire Lock and Activate Changes" in the console, then the lock will expire shortly so retry this operation.
このエラーは、EARファイルを正常にデプロイするには、最初にOracle WebLogic Server管理コンソールでロックを解放する必要があることを示しています。
ADFタスク・フォームのEARファイルのデプロイメント・エラーを解決するためにロックを解放する手順は、次のとおりです。
Oracle WebLogic Server管理コンソールにログインします。
ページの一番上にあるコンソール・バナーの下で、「プリファレンス」→「ユーザー・プリファレンス」をクリックします。
「ロックを自動取得して変更をアクティブ化」の選択を解除します。
「保存」をクリックすると、「ロックして編集」や「構成の解放」などのボタンが表示されます。
Oracle WebLogic Server管理コンソールに次の説明が表示されます。
Automatically acquire the lock that enables configuration editing and automatically activate changes as the user modifies, adds and deletes items (for example, when the user clicks the 'Save' button). This feature is not available in production mode.
このエラーは、使用しているデプロイ方法(Oracle JDeveloperを使用したデプロイや、antスクリプトを使用したデプロイなど)とは無関係に発生します。
