Adding endpoints to virtual services

Use the Proxy Gateway widget to add endpoints to virtual services that belong to a proxy group.

Before you begin

Use IBM Integration Designer to create a proxy gateway. Use the wizard to create a proxy gateway module, which is an SCA module containing a Gateway Endpoint Lookup mediation primitive.
Deploy the proxy gateway module to Process Server.
Create a business space containing the Proxy Gateway widget.

About this task

A proxy gateway is a module that receives web service requests and forwards them to an endpoint defined in a proxy group. Proxy groups contain virtual services that you map to real service endpoints. A virtual service can have one or more endpoints associated with it.

When you create your proxy gateway module, you define the proxy groups for the module. After you deploy your proxy gateway module, you can use the Proxy Gateway widget to add virtual services to the proxy groups. The virtual service information is stored in the built-in configuration store that exists in Process Server.

When the proxy gateway processes a client request, the virtual service name used to look up the endpoints must match the virtual service name in the client request. If you create a proxy gateway module with the default type of routing, which is URL-based, and use the URL available in the resolved WSDL, then the routing of the request occurs automatically. If you create a proxy gateway module with XPath-based routing, ensure that the message location you specify contains the correct virtual service name.

Procedure

Log in to your business space and open the page that contains the Proxy Gateway widget.
From the Proxy Gateway widget, click the pencil icon next to the proxy group that you want to work with. The Proxy Gateway widget is refreshed. If the configuration store contains virtual services for the proxy group, the virtual services are displayed. If a virtual service is associated with more than one endpoint, only the first endpoint is displayed in the table.
Select the virtual service that you want to work with by clicking the pencil icon at the end of the row. The Proxy Gateway widget refreshes and shows the following information:
- Port Type: The WSDL portType of the virtual service.
- Virtual Service Name: The name of the virtual service that is stored in the configuration store. The default name is entered for you, and is based on the service name in the resolved WSDL.
- Virtual Service URLs:
  - Proxy Gateway: The name of the proxy gateway module.
  - Endpoint: The endpoint of the virtual service.
- Enable Virtual Service: A check box that indicates whether you can send messages to the virtual service.
- Endpoint URLs: One or more network-addressable endpoints to which a message can be forwarded. If you define a list of endpoints, you can determine the order in which the services are tried. You determine the order by moving the endpoints up and down in the list.
- Advanced Service Properties: If you need to do special processing, for a particular virtual service, you might use the Advanced Service Properties. The Advanced Service Properties are key-value pairs that you want to be accessible in the mediation flow, after the Gateway Endpoint Lookup mediation primitive. For example, you might want to specify the location of the XSL style sheet that relates to this virtual service. At run time, the key-value pairs are stored in the EndpointLookupContext of the service message object (SMO).
  - Name: The name of the key.
  - Value: The value of the key.
Click Add Endpoint. to add an endpoint to the virtual service.
Save the endpoint information.

Results

The new endpoint is added to the built-in configuration store, and the Proxy Gateway widget is refreshed.

What to do next

Retrieve the WSDL that your client must use to call a virtual service. You can obtain the WSDL by entering the endpoint of the virtual service URL in a web browser, and appending the string: ?wsdl. For example, http://zzz/Gold?wsdl, where http://zzz/ is the address of the proxy gateway and Gold is the name of the virtual service.
Note: The endpoint of the virtual service URL is specified in the Endpoint field, under the Virtual Service URLs heading.
Use your client to access the proxy gateway. The proxy gateway routes your request to the real service associated with the virtual service.