Tune bus-enabled web services

Use the administrative console or a Jacl script to tune performance settings for service integration bus-enabled web services.

Bus-enabled web services dynamically use a fast-path route through the bus where possible. This fast-path route is used if the following criteria are met:

• The inbound port and outbound port for the service are on the same server.

• There are no mediations on the path from the inbound port to the outbound port.

If we migrate web services from the WebSphere Application Server v5.1 Web services gateway, then your messages use this fast-path route through the bus.

Further optimizations can be made, if the configuration also meets the following criteria:

• The inbound template WSDL URI is the same location as the Outbound Target Service WSDL location URI.

• The inbound service template WSDL service name matches the outbound WSDL service name.

• The inbound service template port name matches the outbound WSDL port name.

• The mapping of the namespaces is disabled (that is, we have set the inbound service property com.ibm.websphere.wsgw.mapSoapBodyNamespace to false).
• Operation-level security is not enabled on the outbound service.

If our web services use the fast-path route, we need not tune mediations or the service integration bus. However it is good practise to do so, because a typical environment will have at least one non-fast-path (for example, mediated) service.

To improve the performance of bus-enabled web services we can tune the following parameters:

• The Java virtual machine heap size. This helps ensure there is enough memory available to process large messages, or messages with large attachments.

• The maximum number of instances of a message-driven bean that are permitted by the activation specification for the service integration technologies resource adapter. This throttles the number of concurrent clients serviced.

• The maximum batch size for batches of messages to be delivered to a client. By default, only a single message is delivered to a message-driven bean instance at one time; we can improve performance by allowing messages to be sent in batches to a message-driven bean.

• (iSeries) The number of threads available to service requests for each client. That is, the number of threads available in the default thread pool, the web container thread pool and the mediation thread pool for a given application server.

• (iSeries) The number of threads available in the mediation thread pool. This assumes that your mediations use concurrent support where appropriate, as explained in Concurrent mediations.

If we have mediations that act on SOAP headers, we can improve performance by inserting the associated header schemas (.xsd files) into the SDO repository.

Tasks

• Optional: Use the administrative console to tune bus-enabled web services by completing the following steps:

  1. Use the topic Tune the IBM virtual machine for Java to set the JVM heap size to a larger value than the default value (256 megabytes). The value should generally be as large as possible without incurring paging.

  2. Use the topic Tune service integration messaging to tune the maximum number of instances of a message-driven bean, the maximum batch size for batches of messages for a bean, and the number of threads available to service requests for a bean.

  3. Use the topic Tune the application serving environment to tune the general application serving environment. Use the topic Tune the application serving environment to tune the general application serving environment, in particular the size of the web container thread pool. In a server that is exclusively serving requests to bus-enabled web services, the default thread pool and the web container thread pool should be the same size.

  4. (iSeries) Use the topic Configure the mediation thread pool to configure the number of threads available to concurrent mediations.

• Optional: If we have mediations that act on SOAP headers, insert the associated schemas (.xsd files) into the SDO repository as described in Including SOAP header schemas in the SDO repository.

Subtopics

• Including SOAP header schemas in the SDO repository
  Use this task to improve mediation performance by inserting the SOAP header schema into the SDO repository.

Related:

Performance tuning for mediations