F Setting B2B Configuration Properties in Fusion Middleware Control
configmbeanutil
utility.
The appendix includes the following sections:
Properties to Set in Fusion Middleware Control
The section lists the properties that can be set in Fusion Middleware control.
The properties in Table F-1 can be set in Oracle Enterprise Manager Fusion Middleware Control. See Configuring Oracle B2B Server Properties for how to set the properties.
Note:
Restarting the SOA Server is required for changes to B2B properties.
Table F-1 Oracle B2B Properties in Oracle Enterprise Manager Fusion Middleware Control
Property | Description |
---|---|
b2b.addebMSHeaders |
Used to add the incoming ebMS message details of By default only the |
b2b.attachments.dir |
To specify an attachments directory location, set this property. If enabled, this property allows users to specify a directory into which all of the attachments will be written. Changes to this property require a server restart for the new value to take effect. |
b2b.certificatevalidation |
This property is used to enable or disable the validation of the certificate received on ebMS. For example, an expired certificate normally throws an error; however, if the property is set to |
b2b.checkDuplicate |
To check for duplicate messages, set this property to If this property is set to By default, Oracle B2B checks for duplicate messages based on the business message ID of the incoming message. This property needs to be set to All document protocols can use this feature. Note that this checking is based on business message ID only. An example on how to reproduce this is using the file name format in this PDF document, on page 6: http://www.oracle.com/technetwork/middleware/b2b-integrations/learnmore/tnb2b11g002-326857.pdf Inbound to Oracle B2B (Request): sending a message Format:
Filename example: The business message ID is |
b2b.rejectDuplicateMessage |
When this property is set to Also, in the Reports page, the following error is reported:
The default value of this property is |
b2b.useJMSDataSourceCache |
Set this property to determine whether JMS objects or SOA datasource information is cached. The value of the property is either |
b2b.additionalDebugInfo |
The value is These files are created only if you specify a value for this property. To disable logging, remove this property. Note: In case of an incorrect directory name or a file creation failed in the given directory, then no file is written. As long as the this property is defined, the information is still logged in the server diagnostic as information. |
b2b.deploy.validation |
To turn off validation during deployment, set this property to This is useful when deploying a large number of agreements where you are certain that the data is valid. |
b2b.ebMS.ProtMsgId.prependHost |
When this property is set to For example: When
When
wherein |
b2b.mdsCache.minutesToLive |
Set this property to |
b2b.encoding |
This property can be used to specify encoding other than default UTF-8. |
b2b.errorsCumulativeReported |
To indicate whether reported errors are cumulative or not, set this property to Set this property to If set to false, the error text and error description fields are not concatenated with the description starting on a new line. This property is most useful with EDI batching error messages. |
b2b.transportCache |
Set this property to |
b2b.FailedMessagesDirectory |
To change the location of the failed application message that is written to the file system, when |
b2b.HAInstance |
Set this property to The default value of this property is A restart of all the nodes in the cluster is required to ensure each node works in the expected HA Mode. |
b2b.IDENTIFY_TP_BY_HOSTNAME |
In cases of TCP-based exchange protocols, such as MLLP and Generic TCP, where the host name is masked, to enable Oracle B2B to determine the host name of each message, set this If set to If set to The default value for this property is |
b2b.ignoreTPWithAsterisk |
In cases where the B2B UI is configured with a generic identifier as a client IP address in the partner profile and the partner has provided a range of IP addresses in the form of a mask (for example, The default value for this property is |
b2b.fabricRetryCount |
This property specifies how many times retry of a failed message to fabric is attempted. For fabric, retry count is a global property and for non-fabric it is a channel retry count. |
b2b.fabricRetryInterval |
This property specifies the number of seconds between attempts to retry delivery of a message to fabric. |
b2b.TPBasedSeqTarget |
To enable a channel name or a trading partner name as a sequence target, set this property to If a message has a sequence target as a part of the action name, then priority is be given to that message property. However, if there is no message level sequence target, and the property ( To enable sequencing in case of:
|
b2b.showEncryptedData |
For an encrypted RosettaNet message being exchanged, set this property to |
|
Use this feature to log the number of active inbound and outbound threads from the available pool of threads during a periodic interval. Oracle B2B publishes event thread information such as name, last active status at periodic intervals to DMS metrics and diagnostic logs. By default, thread information are published at a 30 minute interval and the log level is Users can change the interval and log level using these properties. Possible values for For the feature to work:
Sample Output:
|
b2b.addAllDocParams |
Set this property to |
b2b.useDefaultQuery |
Set this property to The default value is |
b2b.refreshCache |
Set this property to The default value is |
b2b.commitTxnOnMsgDelivery |
Set this property to |
|
Set these properties to set the number of threads and thread sleep time to improve message processing. The recommended values for If Oracle B2B is running in a single thread mode (default), then a blocked outbound HTTP message could cause failure in Oracle B2B to process the subsequent message. The HTTP delivery has a default timeout of 60 seconds, and the timeout would push the message to error and unblock the processing. To avoid delays in processing, it is recommended that you increase the thread count property If The |
b2b.jmsRedeliveryLimit |
You can change the retry limit for reading messages from the JMS queue by setting this property, causing Oracle B2B to retry reading the message for the number of times specified there. The default retry limit is When the limit count expires, the message and the header contents are written into the file system (the default location is the You can specify the location for failed messages by setting |
b2b.listening.channel.restart.wait |
Sometimes Oracle B2B creates multiple file monitor threads for a listening channel. Setting a longer interval using this property helps to avoid the race condition of threads during initialization. |
b2b.MaxTimeinAquiredState |
Set this property to avoid an issue in which the autostack handler does not resume processing of messages after restart. The time unit value of |
|
To set the Metadata Service (MDS) instance cache size, set this property. A ratio of 5:1 is recommended for the |
b2b.OutboundDispatchInterval |
To control the delay between every cycle of dispatch, use this property. Set this property to specify the amount of time to wait (in milliseconds) between dispatching of sequenced messages. If enabled, the property will control the delay between every cycle of dispatch. The property can be used along with Message Sequencing and Trading Partner Downtime Schedule features. When auto stack handler is used, then Oracle B2B retries the outbound failed messages in sequence. after the endpoint is reached for delivery, all messages in the sequence will be eligible for delivery and this may cause an overload of message delivery at the endpoint. To reduce the load, this property can be used to set the interval between dispatch of messages in milliseconds. |
b2b.payloadObfuscation |
To turn on payload obfuscation, set this property to For more information, see Payload Obfuscation. |
b2b.setDynamicNameSpace |
To use EDI When using EDI xmlns="NS_31CA8D0F33324F95A0BF15D85539C27E20060518215520" To turn off dynamic namespace generation for inbound EDI messages, set this property to |
b2b.SyncAppDelivery |
When using callouts, to enable delivery of messages to the back-end message queue, set this property to |
b2b.setisLargePayloadPropertyForSmallMsg |
Oracle B2B sets the By default, the value of the property is |
b2b.listening_channels.continue_reconnect |
By default, if the resource server, such as SFTP or JMS is down, Oracle B2B tries to reconnect only a specified number of times. However, if Oracle B2B cannot reconnect within the specified retries, it simply stops the particular listening channel. When this property is set to In case of SFTP, the resource server is an SFTP server, and in case of JMS, the resource server is an JMS server. By default, the value of the property is |
b2b.reuseHttpConnections |
Set the value of this property to However, this property depends on other property values to take effect. If you call So you need to compare |
b2b.deliverPingPongToBackend |
In ebMS, you can check the server state by using a set of messages called 'Ping and Pong'. Set the By default, the value of the property is |
b2b.SingleTransactionAtInbound |
In the case of an inbound MLLP HA, if the server crashes after wire message has been committed to the database but before the event gets enqueued to Event Queue, it is perpetually stuck in the Sequence Manager table and is not processed. This blocks the inbound message flow in the sequencing case. Set the The default value of the property is |
b2b.retainmsgid |
When this value is set to If this value is set to The default value for this property is |
b2b.TPACache |
Use this property to enable or disable Trading Partner Agreement (TPA) layer processing cache. By default, this property is not enabled. Limitation of the property: The TPA cache relies on agreement deployments to refresh the change in values. So, when this parameter is enabled, hot uptake of channel parameter changes does not work. It would require the agreements to be deployed. You need to restart the server for applying any changes to this parameter. The valid value for this parameter is |
b2b.optimizeStorage |
Use this property to determine whether the storage of payloads would be optimized (shared) across Business, Wire, and Application instances, if applicable. Setting this property accordingly reduces the I/O load at the database layer due to persistence of payloads. You need to restart the server for applying any changes to this parameter. The valid values for the parameter are |
b2b.DispatcherCache |
Use this property to enable or disable the Dispatcher processing cache. By default, this property is not enabled. You need to restart the server for applying any changes to this parameter. The valid value for this parameter is |
b2b.enableDeliveryHelper |
Use this property to spawn a separate thread for dispatching messages to the back-end application. Enable this property to improve the performance of the inbound dispatcher. You need to restart the server for applying any changes to this parameter. The valid values for this property are |
b2b.sequencingFetchSize |
Use this property to define the batch size for sequencing fetches. The Inbound or outbound Dispatcher attempt to pick The valid value for this parameter is |
b2b.fromHeaderName |
If the HTTP From message header contains a value that can be mapped to an IP Address, then Oracle B2B converts the value to an IP Address. If the remote Trading Partner identifiers, specifically, Generic Identifier, does not contain that IP Address, then Oracle B2B fails to identify that the message came from which Trading Partner. Use this property to specify a value for the header name so that when a message arrives, Oracle B2B does an exact match (no IP Address conversion) of the value extracted from the From message header with the Generic Identifier specified for the remote Trading Partner. The value of this property is case-sensitive. So, the header must match exactly with the value that is provided in the message. The value for this property takes the following format: <header name>#<header name2>... The value can contain multiple header names separated by |
b2b.auditFileLocation b2b.maxNumAuditFile |
Use Example: b2b.auditFileLocation=/tmp/audit.log Use Format: Example: b2b.maxNumAuditFile= 10
The audit file is stored in the CSV format. |
b2b.TreatRNIFasRNDocument |
Use this property to identify a RosettaNet document. If you set this property to If you set this property to |
b2b.mdnAliasesAndAlgorithm |
If an inbound AS2 message has requested the sign MDN, the outbound MDN needs to be signed. However, B2B does not have information about the private key that is needed to sign the MDN nor does it have the algorithm used. This is solved by using this property to handle signing of negative MDN for AS2 messages. The property takes its value in the following format: B2BHost=<default alias to sign>:<default algorithm>;<TP1>=<alias1>:<alg1>;...<TPn>=<aliasn>:<algn>
Example: B2BHost=b2bs0:md5;ACME=stg_2010:md5;GLOBALCHIPS=stage2014:sha1 This property only affects the AS2 Exchange protocol. The managed server does not need to be re-started for the property to take effect. |
b2b.fromTPXPath |
Use this property to include XPath from where the Trading Partner name has to be extracted from the payload. When a message comes, Oracle B2B uses the XPath specified in the Enterprise Management console to extract the Trading Partner name from the payload, and then Oracle B2B compares that value to the value specified as a Generic Identifier to determine which Trading Partner has sent the message. Note: Do not include |
b2b.correlateResponse |
Use this property to toggle correlation in Oracle B2B. The default value for this property is If you set this property to |
b2b.protMsgIdAsBmId |
Set this property to The default value for this property is |
|
Set this property to get the time range for SQL dumps. This property is used during the Diagnostic Framework implementation. The time is specified in minutes. |
b2b.flowTraceEMURL |
When Oracle B2B is hosted in one domain and the Oracle SOA composite (Oracle B2B adapter with the JMS option) is deployed in a different domain (Oracle Enterprise Manager Fusion Middleware Control in a different domain), Oracle B2B needs a mechanism to provide the link to the domain where the composite is deployed. Use this property to provide the domain URL details of the Oracle SOA composite for tracking the instance message flow based on the ECID. The format for setting the value of this property is: http://<host>:<port>#<domain_name>#<domain_type>
You can also specify this URL details at the Delivery Channel level by using the Oracle B2B console. This URL is available as a Flow Trace link for individual messages in the Oracle B2B Application Message reports. While creating the Flow Trace link, Oracle B2B first checks if the value is provided at the channel level. If the value is present, it is used to construct the URL link. If the value is not present, Oracle B2B checks whether See Configuring Oracle B2B Logging Mode in Administering Oracle SOA Suite and Oracle Business Process Management Suite. |
b2b.b2bReportsURL |
Set this property (along with The format for setting the value of this property is: http://<host>:<port>
Note: Currently, Oracle SOA Suite supports tracking of multiple SOA domains and one Oracle B2B instance. This is because this property is set at the global level. |
b2b.TPAbasedebMSIdValidateAndOverride |
This property enables:
The default value is If
If The Identification is done against the configured Identifier in the profile, and the configured Identifier in the Agreement is used in ebMS headers. |
b2b.resubmitOutboundAck |
Set this property to The default value is |
b2b.defaultCustomDocTypeVersion |
When the payload comes in as inbound over AS2 delivery channel, B2B tries to identify the document protocol which is not possible because there is no identifier in the payload to look at. The payload can be any flat file or binary file payload. Set this to binary to define the protocol. |
b2b.defaultCustomDocType |
When the payload comes in as inbound over AS2 delivery channel, B2B tries to identify the document protocol which is not possible because there is no identifier in the payload to look at. The payload can be any flat file or binary file payload. Set this to generic to define the protocol. |
b2b.httpsTrustStore |
If this property is set to true, then B2B uses the default .jks file to send for the https delivery channel. |
Coherence system properties
|
These system properties help you to tune the cache size and expiry durations. The following are the default values of the system properties:
|
Using the configmbeanutil Utility
You can also use the configmbeanutil utility to set properties.
To use the configmbeanutil utility:
Example F-1 To Print All Properties to the Console
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
Example F-2 To Add a Property
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
Example F-3 To Update a Property
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
Example F-4 To Remove a Property
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
Example F-1, Example F-2, Example F-3, and Example F-4 show uses for this utility.