3 Configuring the SOA Infrastructure

3.1 Configuring SOA Infrastructure Properties

You can configure the following properties for the SOA Infrastructure:

• Audit level

• Composite instance state to capture

• Payload validation

• Callback server and server URLs

• Instance and fault count metrics retrieval

• Universal Description, Discovery, and Integration (UDDI) registry

• Java Naming and Directory Interface (JNDI) data source

• Web service binding properties

The properties set at this level impact all deployed SOA composite applications, except those composites for which you explicitly set different audit level values at the composite application or service engine levels.

Additional advanced properties for the SOA Infrastructure can be configured through the System MBean Browser. To access these properties from the SOA Infrastructure menu, select Administration > System MBean Browser > Application Defined MBeans > oracle.as.soainfra.config.

To configure SOA Infrastructure properties:

1. Access this page through one of the following options:

   From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...	From the SOA Composite Menu...
   Select SOA Administration > Common Properties.	Right-click soa-infra. Select SOA Administration > Common Properties.	Select SOA Infrastructure Common Properties.

   
   

   The SOA Infrastructure Common Properties page displays the following properties.

   Note:

   Some property fields are designated with an icon showing green and red arrows. If you change these properties, you must restart the SOA Infrastructure.
   
   Description of the illustration soaadmin_common_props.gif
   
   

   Descriptions for the properties at the top of the page are provided in the following table.

   Element	Description
   Audit Level	Select the level of information to be collected by the message tracking infrastructure. This information is collected in the instance data store (database) associated with the SOA Infrastructure. This setting has no impact on what gets written to log files. Off: No composite instance tracking and payload tracking information is collected. No more composite instances can be created. No logging is performed. Note that no logging and display of instances in Oracle Enterprise Manager Fusion Middleware Control Console can result in a slight performance increase for processing instances. Instances are created, but are not displayed. Development: Enables both composite instance tracking and payload detail tracking. However, this setting may impact performance. This level is useful largely for testing and debugging purposes. Production: Composite instance tracking is collected, but the Oracle Mediator service engine does not collect payload details and the BPEL process service engine does not collect payload details for assign activities (payload details for other BPEL activities are collected). This level is optimal for most normal production operations.
   Capture Composite Instance State	Select to capture the SOA composite application instance state. Enabling this option may result in additional run time overhead during instance processing. This option provides for separate tracking of the running instances. All instances are captured as either running or not running. This information displays later in the State column of the composite instances tables for the SOA Infrastructure and SOA composite application, where: It shows the counts of running instances versus total instances You can also limit the view to running instances only Valid states are running, completed, faulted, recovery needed, stale, terminated, suspended, and state not available. The running and completed states are captured only if this check box is selected. Otherwise, the state is set to unknown. The conditional capturing of these states is done mainly to reduce the performance overhead on SOA Infrastructure run time. Note: If this property is disabled and you create a new instance of a SOA composite application, a new instance is created, but the instance does not display as running, faulted, stale, suspended, terminated, completed, or requiring recovery in the table of the Dashboard page of the composite application. This is because capturing the composite state of instances is a performance-intensive process. For example, if you enable this property and create an instance of a SOA composite application in the Test Web Service page, a new instance appears in the Dashboard page of the composite application. If you click Show Only Running Instances in the Dashboard page, the instance displays as running. If you then disable this property and create another instance of the same composite application, a new, running instance is created. However, if you then select Show Only Running Instances, the new instance is not listed in the table of running instances. In addition, to terminate a running instance, the instance must have a state (for example, running, faulted, suspended). This activates the Abort button on the Instances page of a SOA composite application. If this check box is not enabled before creating an instance, the Abort button is inactive, and you cannot terminate the instance.
   Payload Validation	Select to enable validation of incoming and outgoing messages. Nonschema-compliant payload data is intercepted and displayed as a fault.

   
   

2. Make changes appropriate to your environment.

   The UDDI Registry Properties section displays the following properties. You can integrate SOA composite applications running in the SOA Infrastructure with the UDDI registry. The UDDI registry provides a standards-based foundation for locating published services and managing metadata about services (security, transport, or quality of service). You can browse and select published services that meet your needs.

   The User and Password properties are applicable if the UDDI registry is secured. These are only used for the secure HTTP configuration of Oracle Service Registry (OSR). The Inquiry URL property is public.

   Element	Description	Example
   Inquiry URL	Enter the URL of the master registry you want to query. The URL must not refer to the slave registry itself. Otherwise, you can lose some data. The inquiry URL obtains full-standard UDDI version 3 structures. This is the same UDDI inquiry URL that you specified in the Create UDDI Registry Connection wizard.	http://master.mycompany.com:8888/registry/uddi/inquiry
   User	Enter the registry inquiry user.	admin
   Password	Enter the password for the master registry inquiry user.	Enter a password that utilizes good security practices.

   
   

   For more information about the UDDI registry, visit the following URL:

   http://www.oracle.com/technology/tech/soa/uddi/index.html
   

   For information about setting the endpoint reference and service key, see Section 33.1.3, "Changing the Endpoint Reference and Service Key for Oracle Service Registry Integration."

3. Make changes appropriate to your environment.

   The Server URLs section displays the following properties. If not explicitly set here, these values are determined at run time by querying the Oracle WebLogic Server cluster, the Web server, or the local server properties.

   Element	Description
   Callback Server URL	Enter the callback server URL. This URL is sent by the server as part of the invocation to a foreign service provider.
   Server URL	Enter the server URL. This URL is published as part of the SOAP address of a service in the concrete WSDL file. Note: In previous releases, you manually configured SOAP optimization with the optSoapShortcut property. For this release, SOAP optimization is automatically configured. Therefore, if you upgrade to 11g R1 and are using the optimized shortcut approach in existing applications, note that optimized calls are activated only when the host name value (as referred to in the WSDL URL in the composite.xml file) matches the Server URL value. Either set both values to the host name (for example, myhost) or to the full domain name (for example, myhost.domain.com). If these values do not match, a regular SOAP call is performed instead of an optimized local call.

   
   

   Note:

   If you change the Callback Server URL and Server URL values (for example, when moving from a test to a production environment), you must restart Oracle WebLogic Server for the WSDLs to be regenerated.

4. Make changes appropriate to your environment.

   The Display Data Counts section enables you to disable the retrieval of instance and fault count metrics that display on various pages and dialogs, such as the Dashboard pages of the SOA Infrastructure, SOA composite applications, service engines, and service components, and the Delete with Options: Instances dialog. Instead, these metrics are replaced with links that you click to retrieve the instance and fault count metrics when you need this information. This setting can improve the time it takes to load pages. For additional details, see Section 3.1.1, "Disabling Instance and Fault Count Metrics Retrieval with the System MBean Browser" for changing this property from the System MBean Browser and Section B.2, "Optimizing the Loading of Pages with Instance and Faults Metrics."

   Note:

   Any changes to this property impact all SOA farms associated with this Oracle Enterprise Manager instance.

5. Select the check box.

6. Expand the Advanced section.

   
   Description of the illustration soaadmin_common_props2.gif
   
   

   The Data Sources section displays the following properties. A data source enables you to retrieve a connection to a database server.

   Element	Description	Example
   Server Data Source JNDI	Displays the JNDI location for the server data source. Click Configure to go to the data source configuration page of the Oracle WebLogic Server Administration Console. Global transaction support should be disabled for this data source.	jdbc/SOALocalTxDataSource
   Server Transaction Data Source JNDI	Displays the JNDI location for the server transactional data source. Click Configure to go to the data source configuration page of the Oracle WebLogic Server Administration Console. You must configure the data source for global transactions.	jdbc/SOADataSource
   Nonfatal Connection Retry Count	Enter the maximum number of times a nonfatal connection error can be retried before failing. These type of errors occur for any connection error with the dehydration store (for example, Oracle Real Application Clusters failover, database shutdown, and so on).	10

   
   

7. Make changes appropriate to your environment.

   The Web Service Binding Properties section displays the following options.

   Element	Description	Example
   Oracle SSL Ciphers	Enter the list of supported Oracle ciphers. A cipher suite is a set of algorithms that provide security for data transmissions. Before data can flow through an SSL connection, both sides of the connection must negotiate common algorithms to use.	SSL_RSA_WITH_RC4_128_MD5
   Oracle Wallet Password	Enter the wallet password for the keystore.	Enter a password that utilizes good security practices.
   Use Chunking	Select to enable chunking of data for SOAP over HTTP deliveries.	- -
   Chunk Size	Specify a chunk size. The value must be less than or equal to 999. The size is used for SOAP over HTTP deliveries and is specified in bytes.	500

   
   

8. Make changes appropriate to your environment.

9. Click Apply.

10. If you make changes and want to reset these properties to their previous values, click Revert.

11. To change advanced parameters, click More SOA Infra Advanced Configuration Properties. This opens the System MBean Browser. Properties that display include the following. Descriptions are provided for each property.

    • GlobalTxMaxRetry — The maximum number of times an invocation exception can be retried.

    • GlobalTxRetryInterval — The number of seconds between retries for an invocation exception.

    • HttpProxyAuthRealm — The HTTP proxy authentication realm.

    • HttpProxyAuthType — The HTTP proxy authentication type.

    • HttpProxyHost — The HTTP proxy host.

    • HttpProxyPassword — The password for HTTP proxies that require authentication.

    • HttpProxyPort — The HTTP proxy port number.

    • HttpProxyUsername — The user name for HTTP proxies that require authentication.

    • HttpServerURL — The HTTP protocol URL published as part of the SOAP address of a process in the WSDL file.

    • HttpsServerURL — The HTTPS protocol URL published as part of the SOAP address of a process in the WSDL file.

    • KeystoreLocation — The path to the Oracle SOA Suite keystore.

    • UddiCacheLifetime — The UDDI endpoint cache life span.

3.2 Stopping and Starting the SOA Infrastructure

You can stop and start the SOA Infrastructure for maintenance or for configuration restarts.

To start and stop the SOA Infrastructure:

1. To shut down the SOA Infrastructure, select Shut Down.

2. Click OK when prompted to shut down the SOA Infrastructure.

3. Wait for SOA Infrastructure shutdown to complete.

4. To start the SOA Infrastructure, select Start Up.

soa-infra runtime connection error  An error happened while connecting to
soa-infra runtime at  t3://152.61.150.106:8001/soa-infra.

Caused By: java.security.UnrecoverableKeyException: Password verification 
failed 
        at 
sun.security.provider.JavaKeyStore.engineLoad(JavaKeyStore.java:769) 
        at 
sun.security.provider.JavaKeyStore$JKS.engineLoad(JavaKeyStore.java:38) 
        at java.security.KeyStore.load(KeyStore.java:1185) 
        at oracle.j2ee.ws.saaj.util.SSLUtil.loadKeyStore(SSLUtil.java:73) 
        at 
oracle.j2ee.ws.saaj.util.SSLUtil.getKeyManagerFactory(SSLUtil.java:88) 
        at oracle.j2ee.ws.saaj.util.SSLUtil.getKeyManagers(SSLUtil.java:97) 
        at 
oracle.j2ee.ws.saaj.util.SSLUtil.createSSLSocketFactory(SSLUtil.java:50) 
        at 
oracle.integration.platform.common.SSLSocketFactoryManagerImpl.getSSLSocketFac 
tory(SSLSocketFactoryManagerImpl.java:58) 
        at oracle.fabric.common.wsdl.WSDLManager.init(WSDLManager.java:356) 
        at oracle.fabric.common.wsdl.WSDLManager.<init>(WSDLManager.java:101) 
        at 
oracle.fabric.common.metadata.MetadataManagerImpl.getWSDLManager(MetadataManag 
erImpl.java:283) 
        at 
oracle.fabric.composite.model.CompositeModel.getWSDLManager(CompositeM 

3.3 Changing the SOA Infrastructure Server URL Property Port

You can change the SOA Infrastructure ServerURL property port from Oracle Enterprise Manager Fusion Middleware Control Console.

When changing the port, note the following details:

• If the SOA Infrastructure and managed Oracle WebLogic Server port numbers are different, you receive a ConnectException error when trying to connect to the Oracle BPM Worklist. Ensure that these port numbers match.

• You cannot change the SOA Infrastructure port from the Oracle WebLogic Server Administration Console. Only the port for the managed Oracle WebLogic Server can be changed from the Oracle WebLogic Server Administration Console.

To change the SOA Infrastructure port:

1. From the SOA Infrastructure menu, select Administration > System MBean Browser.

2. Under Application Defined MBeans, expand oracle.as.soainfra.config > Server: server_soa > SoaInfraConfig > soa-infra.

   where server_soa is the name of the server provided during post installation configuration. By default, this name is soa_server1.

3. In the Name column, click ServerURL.

   The Attribute: ServerURL page appears.

   
   Description of the illustration hwf_wlist_port.gif
   
   

4. In the Value field, change the port.

5. Click Apply.

6. Change the managed Oracle WebLogic Server port in the Oracle WebLogic Server Administration Console to the same value.

   In environments in which a load balancer is used in front of an Oracle WebLogic Server cluster, the ServerURL property host and port can be different from the Oracle WebLogic Server server host and port. This is typical for enterprise deployment environments in which a load balancer distributes requests across the managed servers in the Oracle WebLogic Server cluster. For more details, see Oracle Fusion Middleware Enterprise Deployment Guide for Oracle SOA Suite.

3.4 Configuring Log Files

Oracle SOA Suite components generate log files containing messages that record all types of events, including startup and shutdown information, errors, warning messages, access information on HTTP requests, and additional information.

To configure log files:

1. Access this page through one of the following options:

   From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
   Select Logs > Log Configuration.	Right-click soa-infra. Select Logs > Log Configuration.

   
   

   The Log Configuration page displays the following details:

   • A View list for selecting the type of loggers for which to view information:

     • Persistent: Loggers that become active when a component is started. Their configuration details are saved in a file and their log levels are persisted across component restarts.

     • Active run time: Loggers that are automatically created during run time and become active when a particular feature area is exercised (for example, oracle.soa.b2b or oracle.soa.bpel). Their log levels are not persisted across component restarts.

   • A table that displays the logger name, Oracle Diagnostic Logging (ODL) level for setting the amount and type of information to write to a log file, the log file, and the log level state.

   
   Description of the illustration sca_logconfig.gif
   
   

2. Perform the following log file tasks on this page:

   1. In the Logger Name column, expand a logger name. This action enables you to specify more specific logging levels within a component.

   2. In the Oracle Diagnostic Logging Level columns, select the level and type of information to write to a log file.

   3. In the Log File column, click a specific log file to create and edit log file configurations.

      For more information about ODL log files and the level and type of logging information to write to a log file, see Oracle Fusion Middleware Administrator's Guide.

3. Click the Log Files tab.

   This page enables you to create and edit log file configurations, including the log file in which the log messages are logged, the format of the log messages, the rotation policies used, and other parameters based on the log file configuration class.

   
   Description of the illustration sca_logfiles.gif
   
   

   For more information, see Oracle Fusion Middleware Administrator's Guide.

<?xml version='1.0'?>
<logging_configuration>
 <log_handlers>
  <log_handler name='wls-domain'
 class='oracle.core.ojdl.weblogic.DomainLogHandler' level='WARNING'/>
  <log_handler name='oracle-soa-handler'
 class='oracle.core.ojdl.logging.ODLHandlerFactory'>
   <property name='path' value='c:\soa1210.1411\user_
projects\domains\soa/servers/server_soa/logs/soa-diagnostic.log'/>
   <property name='maxFileSize' value='10485760'/>
   <property name='maxLogSize' value='104857600'/>
   <property name='supplementalAttributes' value='J2EE_APP.name,J2EE_
MODULE.name,WEBSERVICE.name,WEBSERVICE_PORT.name,composite_instance_id,component_
instance_id,composite_name,component_name'/>
    <property name='encoding' value='UTF-8'/>   
  </log_handler>
 </log_handlers>
...

3.5 Changing the Driver Name to Support XA Drivers

If your data sources require support for XA drivers, you must change the driver name on Oracle WebLogic Server. This is particularly true for environments in which BPEL processes assume XA is present when calling database adapters and JMS adapters.

Change the driver name through one of the following methods.

• Edit in Oracle WebLogic Server Administration Console.

  1. Log into Oracle WebLogic Server Administration Console.

  2. In the left pane, select Domain Structure.

  3. Select Services > JDBC > Data Source > SOADataSource > Connection Pool.

  4. For the Driver Class Name, change the value to oracle.jdbc.xa.client.OracleXADataSource.

     This provides support for the XA driver.

  5. Restart the server.

• Edit the SOADataSource-jdbc.xml file.

  1. Open the soaDataSource-jdbc.xml file on Oracle WebLogic Server.

  2. Change the SOADataSource driver name from oracle.jdbc.OracleDriver to oracle.jdbc.xa.client.OracleXADataSource.

     <?xml version="1.0" encoding="UTF-8"?>
     <jdbc-data-source
     /. . .
     . . .
     /  <name>SOADataSource</name>
      <jdbc-driver-params>
           <url>jdbc:oracle:thin:@adc60086fems.us.oracle.com:1537:co0yd570</url>
           <driver-name>*oracle.jdbc.xa.client.OracleXADataSource*</driver-name>
        <properties>
          <property>
            <name>user</name>
            <value>fusion_soainfra</value>
          </property>
        </properties>
     /  . . .
      . . ./
      </jdbc-driver-params>
     /. . .
     . . ./
     </jdbc-data-source>