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
- Use IBM Integration Designer to create a module containing a Policy
Resolution mediation primitive.
- Deploy the module to Process Server.
- Ensure that Process Server has a definition for the WSRR that
you want to use.
- 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.
- Create a business space that contains the administration widgets
you need, including the Service Browser and Mediation
Policy Administration widgets.
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
- Log in to your business space and navigate to the space
that you created for administering services.
- 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.
- 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.
- 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.
- 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.
- Select a Group name. Each
group contains module properties. Select the group whose property
values you want to override.
- Click Use existing.
- 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.
- Click Next The Mediation
Policy Administration widget is refreshed. You can now
add gate conditions.
Note: You cannot edit mediation policy assertions
in a business space 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.
- 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.
- Enter a gate condition name in the Gate condition
name field. The name of a gate condition is
always prefixed with the string medGate_.
- 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.
- Click Add Gate Condition.
- 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.