WebSphere

Services: Attaching existing mediation policies to services

Use the Mediation Policy Administration widget, to attach existing mediation policies to service endpoints. Using mediation policies you can control service interactions, using contextual information.

Before you begin

  1. Use WebSphere® Integration Developer to create a module containing a Policy Resolution mediation primitive.
  2. Deploy the module to WebSphere Enterprise Service Bus (WebSphere ESB) or WebSphere Process Server.
  3. Ensure that WebSphere ESB or WebSphere Process Server have a definition for the WSRR that you want to use.
  4. In WSRR, load the enterprise archive (EAR) file containing your module. Also, load the WSDL documents for the services that you want to attach mediation policies to.
  5. Create a business space using the Service Administration template. The Service Administration template creates a business space that contains the widgets you need.

About this task

You can control service requests dynamically by using mediation policies to override module properties at run time. Such mediation policies are stored in WSRR. You can define one or more mediation policies for services used by your module, and each mediation policy can override one or more module properties. Optionally, you can create one or more gate conditions on each policy attachment. When service requests are processed, gate conditions are compared to the condition values in the message. All the gate conditions must be met before an associated mediation policy can be used.

Procedure
  1. Log on to Business Space.
  2. In your Service Administration business space, open a Service Administration page.
  3. From the Service Browser widget, if the correct WSRR definition is not displayed select the correct WSRR definition. If your application server has definitions for more than one instance of WSRR, you can display the services that are defined on each WSRR. The list of services is refreshed.
  4. Select the level at which you want to attach a mediation policy. You can attach a mediation policy at the level of the service, endpoint, or operation. The Mediation Policy Administration widget is refreshed. The following information is displayed:
    • The name of the service, endpoint, or operation that you selected.
    • The WSRR definition that you selected.
    • Any policy attachments that exist for the service, endpoint, or operation that you selected.
  5. Enter the name of the New policy attachment. Policy attachments associate a mediation policy with a target service. In WSRR, the mediation policy and the policy attachment are separate objects.
  6. Click Create... The Mediation Policy Administration widget is refreshed. You can now specify the group of properties you want to work with, and the name of an existing mediation policy for that group.
  7. Select a Group name. Each group contains module properties. Select the group whose property values you want to override.
  8. Click Use existing.
  9. Select a mediation policy from the Select a policy menu. The mediation policies displayed depend on the group you selected. Because a target service might be called from different modules, the mediation policy associated with the target service might not affect the service request. A mediation policy can only affect a service request if the service, endpoint, or operation that you selected is called by an appropriate module. An appropriate module is one that has properties that the mediation policy can override.
  10. Click Next... The Mediation Policy Administration widget is refreshed. You can now add gate conditions.
    Note: Using Business Space, you cannot edit mediation policy assertions after you create a mediation policy. However, because gate conditions exist on the mediation policy attachment, you can add gate conditions when you create a new policy attachment.
  11. Optional: Define one or more gate conditions. Gate conditions must be met before the policy can be used. In WSRR, gate conditions are user properties on the policy attachment object.
    1. Enter a gate condition name in the Gate condition name field. The name of a gate condition is always prefixed with the string medGate_.
    2. Enter a gate condition value in the Value field. The gate condition value is made up of the following parts: policy condition name, operation and gate value.
      • The policy condition name you enter must map to a Policy condition name in the module.
      • The operation can be: = , != , > , < , <= or >= .
      • The gate value is the value being compared, for example, country = France.
    3. Click Add Gate Condition.
  12. Click Save.

Results

In WSRR, a policy attachment is created that associates the selected mediation policy with the selected service, endpoint, or operation.

The Mediation Policy Administration widget is refreshed, and the new policy attachment is added to the list of policy attachments.


task Task topic

Terms of use | Feedback


Timestamp icon Last updated: 30 July 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v7r0mx/topic/com.ibm.bspace.help.widg.wpsesb.doc/help_medpolicywidget/help_attachpolicytoservice.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).