F Fusion Middleware ControlでのB2B構成プロパティの設定
configmbeanutil
ユーティリティを使用してB2Bプロパティを設定する方法について説明します。
この付録の内容は次のとおりです。
Fusion Middleware Controlで設定するプロパティ
この項に、Fusion Middleware Controlで設定できるプロパティのリストを示します。
Oracle Enterprise Manager Fusion Middleware Controlでは、表F-1のプロパティを設定できます。プロパティの設定方法は、「Oracle B2Bサーバーのプロパティの構成」を参照してください。
ノート:
B2Bプロパティの変更には、SOAサーバーの再起動が必要です。
表F-1 Oracle Enterprise Manager Fusion Middleware ControlのOracle B2Bプロパティ
プロパティ | 説明 |
---|---|
b2b.addebMSHeaders |
デフォルトでは、 |
b2b.attachments.dir |
添付ディレクトリの場所を指定するには、このプロパティを設定します。 このプロパティを有効にすると、ユーザーはすべての添付が書き込まれるディレクトリを指定できます。 このプロパティの変更では、新しい値を有効にするためにサーバーを再起動する必要があります。 |
b2b.certificatevalidation |
このプロパティは、ebMSで受信した証明書の検証を有効または無効にするために使用されます。たとえば、証明書が期限切れになっていると、通常は、エラーがスローされます。ただし、このプロパティが |
b2b.checkDuplicate |
重複メッセージをチェックするには、このプロパティを このプロパティが デフォルトでは、Oracle B2Bは着信メッセージのビジネス・メッセージIDに基づいて重複メッセージをチェックします。 重複RosettaNetメッセージの処理を有効化するには、このプロパティを すべてのドキュメント・プロトコルでこの機能を使用できます。このチェックは、ビジネス・メッセージIDにのみ基づいているので注意してください。これを再現する方法の例では、次のPDFドキュメントの6ページ目にあるファイル名形式を使用します: http://www.oracle.com/technetwork/middleware/b2b-integrations/learnmore/tnb2b11g002-326857.pdf Oracle B2Bへのインバウンド(リクエスト): メッセージの送信 書式:
ファイル名の例: ビジネス・メッセージIDは |
b2b.rejectDuplicateMessage |
このプロパティが また、「レポート」ページで次のエラーがレポートされます:
このプロパティのデフォルト値は |
b2b.useJMSDataSourceCache |
JMSオブジェクトまたはSOAデータ・ソース情報がキャッシュされるかどうかを決定するには、このプロパティを設定します。 このプロパティの値は、 |
b2b.additionalDebugInfo |
値は このプロパティの値を指定する場合のみ、これらのファイルが作成されます。ロギングを無効化するには、このプロパティを削除します。 ノート: ディレクトリ名が正しくないか、ファイル作成が特定のディレクトリで失敗した場合、ファイルに書き込まれません。このプロパティを定義しているかぎり、情報が引き続きサーバー診断に情報として記録されます。 |
b2b.deploy.validation |
デプロイメント中の検証をオフにするには、このプロパティを これは、データが有効であることが確認されているアグリーメントを多数デプロイする際に役立ちます。 |
b2b.ebMS.ProtMsgId.prependHost |
このプロパティを たとえば:
ここで、 |
b2b.mdsCache.minutesToLive |
MDSキャッシュがメモリーに永続的に格納されるように指定するには、このプロパティを |
b2b.encoding |
このプロパティは、デフォルトのUTF-8以外のエンコーディングを指定するために使用できます。 |
b2b.errorsCumulativeReported |
エラーが累積で、または累積しないで報告されるように指定するには、このプロパティを エラーが累積の方式で報告されるようにするには、このプロパティを falseに設定すると、エラー・テキストおよびエラーの説明のフィールドは説明と連結されず、説明は新しい行で開始されます。 このプロパティは、EDIバッチ処理のエラー・メッセージで最も役立ちます。 |
b2b.transportCache |
トランスポート・キャッシュで、トランスポート・レイヤおよびエンジン間のトランスポート・メッセージ・オブジェクトをキャッシュするには、このプロパティを |
b2b.FailedMessagesDirectory |
|
b2b.HAInstance |
構成されているFileチャネル、FTPチャネルまたは電子メール・チャネルのポーリング・スレッドが、高可用性(HA)クラスタ内の1つのノードのみで起動されることを保証するには、このプロパティを このプロパティのデフォルト値は 各ノードを想定されるHAモードで確実に動作させるには、クラスタ内の全ノードを再起動する必要があります。 |
b2b.IDENTIFY_TP_BY_HOSTNAME |
ホスト名がマスクされるTCPベースの交換プロトコル(MLLPやGeneric TCPなど)の場合に、Oracle B2Bが各メッセージのホスト名を決定できるようにするには、この
このプロパティのデフォルト値は |
b2b.ignoreTPWithAsterisk |
B2B UIが、パートナ・プロファイル内のクライアントIPアドレスの汎用IDを使用して構成されている場合に、パートナがドキュメントの送信元になるIPアドレスの範囲をマスクの形式(たとえば、 このプロパティのデフォルト値は |
b2b.fabricRetryCount |
このプロパティは、ファブリックへのメッセージの失敗の再試行が何回試みられるかを指定します。ファブリックでは再試行数はグローバルなプロパティで、非ファブリックでは再試行数はチャネルの再試行数です。 |
b2b.fabricRetryInterval |
このプロパティは、ファブリックへのメッセージの配信を再試行するまでの秒数を指定します。 |
b2b.TPBasedSeqTarget |
チャネル名または取引パートナ名を順序付けのターゲットとして有効にするには、このプロパティを メッセージにアクション名の一部として順序付けのターゲットがある場合、そのメッセージ・プロパティに優先度が与えられます。ただし、メッセージ・レベルの順序付けのターゲットがなく、プロパティ( 順序付けを有効にする方法を次に示します。
|
b2b.showEncryptedData |
暗号化済RosettaNetメッセージが交換される場合、パック・メッセージの内容を表示するには、このプロパティを |
|
使用可能なスレッドのプールから一定期間内にアクティブになったインバウンド・スレッドおよびアウトバウンド・スレッドの数を記録するには、この機能を使用します。Oracle B2Bは、名前や最終アクティブ・ステータスなどのイベント・スレッド情報をDMSメトリックおよび診断ログに定期的にパブリッシュします。デフォルトでは、スレッド情報は30分おきにログ・レベル これらのプロパティを使用して、間隔とログ・レベルを変更できます。
この機能が動作する条件は次のとおりです。
サンプル出力:
|
b2b.addAllDocParams |
このプロパティを |
b2b.useDefaultQuery |
このプロパティを デフォルト値は |
b2b.refreshCache |
このプロパティを デフォルト値は |
b2b.commitTxnOnMsgDelivery |
このプロパティを |
|
メッセージ処理を向上させるためにスレッド数とスレッドのスリープ時間を設定するには、これらのプロパティを設定します。
Oracle B2Bがシングル・スレッド・モード(デフォルト)で実行されている場合、アウトバウンドHTTPメッセージがブロックされると、Oracle B2Bで後続のメッセージを処理できなくなる場合があります。HTTP配信のデフォルトのタイムアウトは60秒です。タイムアウトによってメッセージはエラーとなり、処理の障害はなくなります。処理の遅延をなくすには、スレッド数プロパティ
|
b2b.jmsRedeliveryLimit |
このプロパティを設定することによって、JMSキューからのメッセージの読取りに対する再試行制限を変更できます。Oracle B2Bは、指定された回数、メッセージの読取りを再試行するようになります。デフォルトの再試行制限は 制限回数に達すると、メッセージおよびヘッダーの内容はファイル・システムに書き込まれます(デフォルトの場所は
|
b2b.listening.channel.restart.wait |
Oracle B2Bは、リスニング・チャネルに対して複数のファイル・モニター・スレッドを作成する場合があります。このプロパティを使用して長い間隔を設定すると、初期化中にスレッドの競合状態を回避するのに役立ちます。 |
b2b.MaxTimeinAquiredState |
再起動後に自動スタック・ハンドラがメッセージの処理を再開しないという問題を回避するには、このプロパティを設定します。
|
|
メタデータ・サービス(MDS)インスタンスのキャッシュ・サイズを設定するには、このプロパティを設定します。
|
b2b.OutboundDispatchInterval |
ディスパッチのサイクル間の遅延を制御するには、このプロパティを使用します。このプロパティを設定して、順序付けされたメッセージのディスパッチ間で待機する時間(ミリ秒単位)を指定します。 このプロパティを有効にすると、ディスパッチのサイクル間の遅延が制御されます。このプロパティは、メッセージの順序付け機能および取引パートナ停止時間スケジュール機能とともに使用できます。 自動スタック・ハンドラの使用時は、Oracle B2Bはエラーが発生したアウトバウンド・メッセージを順番に再試行します。エンドポイントで配信準備が完了すると、順序内のすべてのメッセージが配信可能になるので、エンドポイントでメッセージ配信のオーバーロードが発生する可能性があります。負荷を軽減するために、このプロパティを使用してメッセージのディスパッチの間隔をミリ秒単位で設定できます。 |
b2b.payloadObfuscation |
ペイロードの不明瞭化をオンにするには、このプロパティを 詳細は、「ペイロードの不明瞭化」を参照してください。 |
b2b.setDynamicNameSpace |
Oracle B2B 10gのEDI Oracle B2B 10gで使用されていたEDI xmlns="NS_31CA8D0F33324F95A0BF15D85539C27E20060518215520" インバウンドEDIメッセージに対する動的ネームスペース生成をオフにするには、このプロパティを |
b2b.SyncAppDelivery |
コールアウトを使用する場合、バックエンド・メッセージ・キューへのメッセージ配信を有効化するには、このプロパティを |
b2b.setisLargePayloadPropertyForSmallMsg |
Oracle B2Bではペイロードのサイズが(構成されているサイズに比べて)大きい場合のみ このプロパティのデフォルト値は |
b2b.listening_channels.continue_reconnect |
SFTPまたはJMSなどのリソース・サーバーが停止している場合、デフォルトでは、Oracle B2Bは指定された回数のみ再接続を試みます。ただし、指定された回数以内に再接続できない場合、単に特定のリスニング・チャネルを停止します。 このプロパティが リソース・サーバーは、SFTPの場合はSFTPサーバー、JMSの場合はJMSサーバーです。 このプロパティのデフォルト値は |
b2b.reuseHttpConnections |
このプロパティの値を ただし、このプロパティが有効になるかどうかは、他のプロパティの値に依存します。HTTP接続を再利用する際に したがって、 |
b2b.deliverPingPongToBackend |
ebMSでは、Ping/Pongメッセージを使用してサーバー状態を確認できます。 このプロパティのデフォルト値は |
b2b.SingleTransactionAtInbound |
インバウンドMLLP HAの場合、ワイヤ・メッセージがデータベースにコミットされてからイベントがイベント・キューにエンキューされるまでにサーバーがクラッシュした場合、サーバーは順序マネージャ表内に永続的に停滞し、処理されません。これによって、順序付けにおけるインバウンド・メッセージ・フローがブロックされます。 MLLP HAの場合のみ、 このプロパティのデフォルト値は |
b2b.retainmsgid |
この値を この値を このプロパティのデフォルト値は |
b2b.TPACache |
このプロパティを使用して、取引パートナ・アグリーメント(TPA)レイヤー処理キャッシュを有効化または無効化します。デフォルトでは、このプロパティは有効化されていません。 プロパティの制限: TPAキャッシュは、アグリーメント・デプロイメントを使用して、値の変化をリフレッシュします。したがって、このパラメータが有効な場合、チャネル・パラメータの変更の即時取込みは機能しません。それには、アグリーメントのデプロイが必要です。このパラメータへの変更を適用するには、サーバーを再起動する必要があります。 このパラメータの有効な値は |
b2b.optimizeStorage |
このプロパティを使用して、ビジネス・インスタンス、ワイヤ・インスタンスおよびアプリケーション・インスタンス(可能な場合)の間で、ペイロードのストレージを最適化(共有)するかどうかを決定します。このプロパティを適宜設定すると、ペイロードが保持され、データベース・レイヤーのI/O負荷が軽くなります。このパラメータへの変更を適用するには、サーバーを再起動する必要があります。 このパラメータの有効な値は |
b2b.DispatcherCache |
このプロパティを使用して、ディスパッチャ処理キャッシュを有効化または無効化します。デフォルトでは、このプロパティは有効化されていません。このパラメータへの変更を適用するには、サーバーを再起動する必要があります。 このパラメータの有効な値は |
b2b.enableDeliveryHelper |
バックエンド・アプリケーションにメッセージをディスパッチするためのスレッドを個々に生成するには、このプロパティを使用します。インバウンド・ディスパッチャのパフォーマンスを向上するには、このプロパティを有効化します。このパラメータへの変更を適用するには、サーバーを再起動する必要があります。 このプロパティの有効な値は |
b2b.sequencingFetchSize |
このプロパティを使用して、順序付けフェッチのバッチ・サイズを定義します。インバウンド・ディスパッチャまたはアウトバウンド・ディスパッチャは、1回のフェッチでの特定の順序付けターゲットに対するメッセージの このパラメータの有効な値は |
b2b.fromHeaderName |
HTTPのFromメッセージ・ヘッダーにIPアドレスにマップ可能な値が格納されている場合、Oracle B2Bはその値をIPアドレスに変換します。このIPアドレスがリモート取引パートナ識別子、特にGeneric識別子に含まれていない場合、Oracle B2Bはメッセージの送信元の取引パートナを識別できません。 メッセージ受信時に、Oracle B2BがFromメッセージ・ヘッダーから抽出した値とリモート取引パートナに指定されているGeneric識別子をそのまま(IPアドレスに変換せずに)比較できるように、このプロパティを使用してヘッダー名の値を指定します。 このプロパティの値は、大文字と小文字が区別されます。したがって、ヘッダーは、メッセージで渡される値と正確に一致する必要があります。 このプロパティの値の書式を次に示します。 <header name>#<header name2>... この値には、 |
b2b.auditFileLocation b2b.maxNumAuditFile |
例: b2b.auditFileLocation=/tmp/audit.log
書式: 例: b2b.maxNumAuditFile= 10
監査ファイルはCSV形式で格納されます。 |
b2b.TreatRNIFasRNDocument |
このプロパティを使用して、RosettaNetドキュメントを指定します。このプロパティを このプロパティを |
b2b.mdnAliasesAndAlgorithm |
AS2のインバウンド・メッセージで署名MDNがリクエストされている場合、アウトバウンドMDNの署名が必要です。ただし、B2BにはMDNの署名に必要な秘密キーに関する情報がないか、使用されるアルゴリズムがありません。これは、このプロパティを使用して、AS2メッセージのネガティブMDNの署名を処理することで解決されます。このプロパティの値の書式を次に示します。 B2BHost=<default alias to sign>:<default algorithm>;<TP1>=<alias1>:<alg1>;...<TPn>=<aliasn>:<algn>
例: B2BHost=b2bs0:md5;ACME=stg_2010:md5;GLOBALCHIPS=stage2014:sha1 このプロパティはAS2交換プロトコルにのみ影響します。プロパティを有効にするために管理対象サーバーを再起動する必要はありません。 |
b2b.fromTPXPath |
このプロパティを使用して、ペイロードから取引パートナ名を抽出する必要があるXPathをインクルードします。 メッセージを受信すると、Oracle B2BはEnterprise Managementコンソールで指定されているXPathを使用してペイロードから取引パートナ名を抽出し、その値をGeneric識別子として指定されている値と比較して、メッセージの送信元の取引パートナを決定します。 ノート: XPathの末尾に |
b2b.correlateResponse |
このプロパティを使用して、Oracle B2Bでの相関付けを切り替えます。 このプロパティのデフォルト値は このプロパティを |
b2b.protMsgIdAsBmId |
このプロパティを このプロパティのデフォルト値は |
|
このプロパティを設定して、SQLダンプの時間範囲を取得します。このプロパティは、診断フレームワークの実装時に使用されます。時間は分単位です。 |
b2b.flowTraceEMURL |
Oracle B2Bがあるドメインでホストされ、Oracle SOAコンポジット(Oracle JMSアダプタとJMSオプション)が別のドメインにデプロイされている場合(Oracle Enterprise Manager Fusion Middleware Controlが別のドメインにある)、Oracle B2Bにはコンポジットがデプロイされているドメインへのリンクを提供するメカニズムが必要です。 ECIDに基づいてインスタンスのメッセージ・フローを追跡するために、このプロパティを使用してOracle SOAコンポジットのドメインURL詳細を指定します。 このプロパティの値を設定するための形式は次のとおりです。 http://<host>:<port>#<domain_name>#<domain_type>
また、Oracle B2Bコンソールを使用して、デリバリ・チャネル・レベルでこのURL詳細を指定できます。 このURLは、Oracle B2B Application Messageレポートの個々のメッセージの「フローのトレース」リンクとして使用できます。 「フローのトレース」リンクの作成時、Oracle B2Bはまずチャネル・レベルで値が指定されているかどうかを確認します。値が存在する場合は、その値を使用してURLリンクが作成されます。値が存在しない場合、Oracle B2BはOracle Enterprise Manager Fusion Middleware Controlで 『Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理』のOracle B2Bロギング・モードの構成に関する項を参照してください。 |
b2b.b2bReportsURL |
Oracle Enterprise Manager Fusion Middleware Controlがホストされているドメインでこのプロパティを( このプロパティの値を設定するための形式は次のとおりです。 http://<host>:<port>
ノート: 現在、Oracle SOA Suiteは複数のSOAドメインと1つのOracle B2Bインスタンスの追跡をサポートしています。これは、このプロパティがグローバル・レベルで設定されるからです。 |
b2b.TPAbasedebMSIdValidateAndOverride |
このプロパティにより、次が実行されます。
デフォルト値は
識別はプロファイルに構成されている識別子との照合によって実行され、ebMSヘッダーではアグリーメントに構成されている識別子が使用されます。 |
b2b.resubmitOutboundAck |
このプロパティを デフォルト値は |
b2b.defaultCustomDocTypeVersion |
AS2デリバリ・チャネルを通じてペイロードをインバウンドとして受信すると、B2Bではドキュメント・プロトコルの識別を試みますが、ペイロードに参照する識別子がないため、これは不可能です。ペイロードは、任意のフラット・ファイルまたはバイナリ・ファイルのペイロードです。プロトコルを定義するには、これをバイナリに設定します。 |
b2b.defaultCustomDocType |
AS2デリバリ・チャネルを通じてペイロードをインバウンドとして受信すると、B2Bではドキュメント・プロトコルの識別を試みますが、ペイロードに参照する識別子がないため、これは不可能です。ペイロードは、任意のフラット・ファイルまたはバイナリ・ファイルのペイロードです。プロトコルを定義するには、これを汎用に設定します。 |
b2b.httpsTrustStore |
このプロパティがtrueに設定されている場合、B2Bはhttpsデリバリ・チャネルでデフォルトの.jksファイルを使用して送信します。 |
コヒーレンス・システム・プロパティ
|
これらのシステム・プロパティを使用して、キャッシュ・サイズおよび有効期限を調整できます。 各システム・プロパティのデフォルト値を次に示します。
|
configmbeanutilユーティリティの使用
configmbeanutilユーティリティを使用してプロパティを設定することもできます。
configmbeanutilユーティリティを使用するには:
例F-1 すべてのプロパティのコンソールへの出力
java -cp $MW_HOME/soa/soa/modules/oracle.soa.b2b_11.1.1/b2b.jar:$MW_HOME /wlserver/server/lib/wljmxclient.jar:$MW_HOME/oracle_common/modules/ glassfish.el_1.2.0.0_2-2.jar oracle.tip.b2b.utility.ConfigMBeanUtility
例F-2 プロパティの追加
java -cp $MW_HOME/soa/soa/modules/oracle.soa.b2b_11.1.1/b2b.jar:$MW_HOME /wlserver/server/lib/wljmxclient.jar:$MW_HOME/oracle_common/modules/ glassfish.el_1.2.0.0_2-2.jar oracle.tip.b2b.utility.ConfigMBeanUtility add b2b.test cool ok
例F-3 プロパティの更新
java -cp $MW_HOME/soa/soa/modules/oracle.soa.b2b_11.1.1/b2b.jar:$MW_HOME /wlserver/server/lib/wljmxclient.jar:$MW_HOME/oracle_common/modules/ glassfish.el_1.2.0.0_2-2.jar oracle.tip.b2b.utility.ConfigMBeanUtility update b2b.test thru
例F-4 プロパティの削除
java -cp $MW_HOME/soa/soa/modules/oracle.soa.b2b_11.1.1/b2b.jar:$MW_HOME /wlserver/server/lib/wljmxclient.jar:$MW_HOME/oracle_common/modules/ glassfish.el_1.2.0.0_2-2.jar oracle.tip.b2b.utility.ConfigMBeanUtility remove b2b.test