To configure a Web service application to use WS-ReliableMessaging, you attach a policy set that contains a WS-ReliableMessaging policy type. This policy type offers a range of qualities of service: managed persistent, managed non-persistent, or unmanaged non-persistent. Use command
scripts to configure a policy set for reliable messaging.
About this task
To configure a reliable messaging policy set using the wsadmin tool,
complete the following steps:
Procedure
- Create a policy set. Use the createPolicySet command
to create a new policy set, or the copyPolicySet command
to copy and rename an existing policy set - either one that you have previously
created, or one of the two WS-ReliableMessaging default policy sets. For more
information, see Creating and
copying policy sets using the wsadmin tool.
- If the policy set does not include both the policy types WSReliableMessaging and WSAddressing, add these policy types using the addPolicyType command
as described in Creating and copying
policy sets using the wsadmin tool. For example:
AdminTask.addPolicyType('[-policySet PolicySet1 -policyType WSReliableMessaging]')
AdminTask.addPolicyType('[-policySet PolicySet1 -policyType WSAddressing]')
These policy types contain the configuration options that support WS-ReliableMessaging. WS-Addressing provides the asynchronous request and reply capabilities for WS-ReliableMessaging. Note: If you want to use secure conversation and reliable messaging policies in the same policy set, the secure conversation bindings must be configured to require that the reliable messaging headers are signed. The RAMP policy set is specifically designed and configured to use secure conversation and reliable messaging policies in the same policy set. If you use a copy of the RAMP policy set, no further configuration of the secure conversation bindings is required. Otherwise, see Configuring WS-SecureConversation to work with WS-ReliableMessaging.
- Configure the WS-ReliableMessaging policy type attributes.
For the WS-ReliableMessaging policy you can configure the version of the WS-ReliableMessaging standard that you want to use, the option to use the WS-MakeConnection protocol for synchronous two-way message exchange, the order in which messages are delivered, and the required quality of service (the reliability level) for message delivery. For detailed
information about these configurable attributes, see WS-ReliableMessaging settings.
Use
the
setPolicyType command to configure these attributes.
For example:
AdminTask.setPolicyType('-policySet PolicySet1 -policyType WSReliableMessaging -attributes "[[useMakeConnection false][inOrderDelivery false][specLevel 1.0][enabled true][qualityOfService managedPersistent][type WSReliableMessaging]]" -replace'
- Save your changes to the master configuration.
To save your configuration changes, enter the following command:
AdminConfig.save()