Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer web services - Reliable messaging (WS-ReliableMessaging) > Administer reliable web services > Attach and binding a WS-ReliableMessaging policy set to a web service application by


Attach and binding a WS-ReliableMessaging policy set to a web service application by using wsadmin

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 wsadmin.sh to attach the policy set to the application, and (for managed qualities of service) to define bindings to a service integration bus and messaging engine.

We can attach a WS-ReliableMessaging policy set and define bindings by using wsadmin as described in this task, or you can attach and bind a WS-ReliableMessaging policy set by using the administrative console.

This task assumes that we have already developed and installed the web service application to which to attach a policy set.

The following default policy sets work with WS-ReliableMessaging applications:

See WS-ReliableMessaging default policy sets.

If you can use any of these default policy sets, or we have configured your own reliable messaging policy set, then you are ready to complete this task.

Use this task to complete the following broad actions:

  1. Attach a reliable messaging policy set (either a default policy set or one that we have created) to an aspect of the application (that is, application level or web service level). Policy sets define the reliability level (quality of service) and other configuration options to apply to your reliable messaging application.
  2. Define the bindings for each attachment to a policy set that specifies a managed quality of service. That is, choose the service integration bus and messaging engine to use to maintain the state for the managed persistent and managed non-persistent qualities of service.

To attach a WS-ReliableMessaging policy set and define bindings by using wsadmin...


Procedure

  1. Attach a policy set to your reliable messaging application at either application level or service level.

    Use the createPolicySetAttachment command as described in Create policy set attachments by using wsadmin. Set the -policySet parameter to the name of the reliable messaging policy set to use. For example: WS-I RSP ND

    • We can attach one policy set at each level.
    • We can only apply a WS-ReliableMessaging policy at application level or service level.

    • If you apply reliable messaging at service level, then all services must use the same WS-ReliableMessaging policy and bindings values.
    • We can attach any policy set at operation level. For a policy set that includes the WS-ReliableMessaging policy, attachment at the operation level configures the other components of the policy set (for example WS-Security and WS-Addressing) but any WS-ReliableMessaging configuration at operation level is ignored.

    This command returns an attachment ID number. If your chosen policy set specifies a managed quality of service, make a note of this number. In the next step you use it to define the binding.

  2. If your chosen policy set specifies a managed quality of service, define bindings to a service integration bus and messaging engine.

    If the policy set instance specifies managed non-persistent or managed persistent quality of service, choose the service integration bus and messaging engine that is to manage the WS-ReliableMessaging state. Use the setBinding command as described in Create policy set attachments using wsadmin. Set the -policyType parameter to WSReliableMessaging. Set the bus name and the messaging engine name by using the following syntax for the -attributes parameter: 

    -attributes "[[busName ReliableMessagingBus]
             [messagingEngineName messaging_engine_name]]"
    The messaging engine name is in the format nodeName.serverName-busName for a messaging engine on a single server, or clusterName.nnn-busName for a messaging engine in a cluster.

    When many applications use the same messaging engine, it can impact performance. Factors to consider include the number of applications that are already binding to the messaging engine, the CPU utilization, and the message throughput.

    To improve performance for a single server configuration, create a new messaging engine to bind to the application.

  3. Save your changes to the master configuration.

    To save the configuration changes, run: 

    AdminConfig.save()


Add assured delivery to web services through WS-ReliableMessaging
WS-ReliableMessaging
Detecting and fixing problems with WS-ReliableMessaging
Attach and binding a WS-ReliableMessaging policy set to a web service application by


Related


Messaging engines [Collection]
Configure application and system policy sets for web services by using scripting

+

Search Tips   |   Advanced Search