You configure each gateway service for a specific gateway instance, so you must create the gateway instance
before you can configure any gateway services for it.
The gateway service
WSDL is created from the WSDL for the first target service. If the target
service is an external Web service, it already has an associated WSDL.
If it is an internal service, create and make available a template
WSDL that describes the service. For an internal service, make the service available
at a service integration bus destination.
When you create a new gateway service, you configure a single target
service as a new Web service that seems to be provided by the gateway.
After you create your new gateway service, you can add more target services
(that is, more implementations of the same logical service) by modifying the existing gateway service configuration.
The
target service can be either an externally-provided Web service, or a service
that is available internally to your organization, and it can be located at
a destination that is on a different bus to the gateway service.
If
the target service is an internal service, the new gateway service is always
created based upon the template WSDL for the service and the bus destination
at which it is available. If it is an externally-provided Web service, the
new gateway service is usually created based upon the externally-published
WSDL for the service, and at a new bus destination. However if the target
is an externally-provided Web service that is already available at a bus destination
(for example because it has previously been configured as an outbound service)
then you should provide the destination details as part of the new gateway
service creation process. Otherwise the same external Web service is made
available at two different destinations.
You can create a new gateway service through the command line,
or through the administrative console. To create a new gateway service through
the administrative console, complete the following steps. For more information
about the new gateway service properties, see Gateway
services settings.
- Start the administrative console.
- In the navigation pane, click bus_nameinstance_name. The gateway
services collection form is displayed.
- Click New. A panel is displayed
through which you select the first target service for your new gateway service.
- Choose one of the two methods to create your gateway service (either
through a WSDL-defined Web service provider or a Service destination)
then click Next.
Note: If the target service
is an internal service, or an externally-provided Web service that is already
available at a destination, select Service destination. If the target
service is an externally-provided Web service that is not already available
at a bus destination, select WSDL-defined Web service provider and
the target service is configured to a new destination.
The New gateway service wizard is displayed for the service creation
method that you selected.
- Optional: If you selected WSDL-defined Web service
provider, complete the following steps:
- Specify the gateway service name, gateway service destinations
and mediations.
Note: - Choose a gateway service name that is unique across all gateway and proxy
services within the current gateway instance. If you enter a name that is
not unique, an error message is displayed.
- You need not provide gateway destination names. If you leave either of
these fields blank, a default name is generated for you when the wizard completes
its operation. The default names are not displayed on the panel. They are
constructed as follows:
- The request destination name is the same as the gateway service name.
For example: myGatewayService.
- The reply destination name is the same as the request destination name,
followed by "Reply". For example: myGatewayServiceReply.
- The lists of available mediations contain all mediations that are currently
deployed to this service integration bus. If you have created a mediation and deployed it to the bus, then it is available
for selection in both these lists. If you do not want to use a mediation with
this gateway service, select none from either or both selection
lists.
- Bus members are application servers or clusters that are added to
this bus. The Request mediation bus member and the Response mediation
bus member properties define the bus members to which the corresponding
mediation is assigned. If you change the Request mediation or the Response
mediation property value to (none), you should also change
the corresponding bus member property value to (none). If
you want to use a mediation, assign it to a bus member. If you do
not do this, the administrative console displays an error message.
- Locate the target service WSDL.
- Select the service from the WSDL.
Note: - This option is needed in case there is more than one service in the WSDL.
The field is filled in for you by default. If there is only one service in
the WSDL, accept the default.
- There needs to be at least one port defined in the service you select.
- Select the ports that are to be enabled for this service.
Note: - The list of available ports is the set of ports that are described in
the WSDL file.
- Select at least one port.
- Name the outbound service, the service destination and all of
the port destinations.
Note: - Default names are generated, but you can rename them. The default names
are unique within the current service integration bus. Any replacement names
that you choose must be similarly unique. If you enter a name that is not
unique, an error message is displayed.
- If you have created a port selection mediation and deployed it to the
bus, then it is available for selection in the list of mediations. If you
do not want to use a port selection mediation with this gateway service, select none from
the selection list. This list contains all mediations, including port selection
mediations, that are currently deployed to this service integration bus.
- The list of available ports is a subset of the ports that are described
in the WSDL file. You chose this subset in the previous step.
- Assign each port destination and (optionally) the port selection
mediation to a bus member.
Note: - The option to assign a port selection mediation to a bus member is only
displayed if you selected a mediation in the previous step.
- Select endpoint listeners for the inbound configuration of this
gateway service.
- Define any UDDI publication properties.
- Optional: If you selected Service destination,
complete the following steps:
- Specify the gateway service name, gateway and target service
destinations and mediations.
Note: - Choose a gateway service name that is unique across all gateway
and proxy services within the current gateway instance. If you enter a name
that is not unique, an error message is displayed.
- The target service need not be available on the same bus as the gateway
service, so specify the bus and associated service destination
at which the target service is available.
- The Target bus name field lists all available buses. The Target
destination name field lists all available destinations. When you choose
a bus and an associated destination, choose a destination that is
available on the bus that you select. If you do not do this, the administrative
console displays an error message.
- You need not provide gateway destination names. If you leave either of
these fields blank, a default name is generated for you when the wizard completes
its operation. The default names are not displayed on the panel. They are
constructed as follows:
- The request destination name is the same as the gateway service name.
For example: myGatewayService.
- The reply destination name is the same as the request destination name,
followed by "Reply". For example: myGatewayServiceReply.
- The lists of available mediations contain all mediations that are currently
deployed to this bus. If you have created a mediation and deployed it to the bus, then it is available
for selection in both these lists. If you do not want to use a mediation with
this gateway service, select none from either or both selection
lists.
- The Request mediation bus member and the Response mediation
bus member properties define the bus members to which the corresponding
mediation is assigned. If you change the Request mediation or the Response
mediation property value to (none), you should also change
the corresponding bus member property value to (none). To use a mediation,
assign it to a bus member. If you do
not do this, the administrative console displays an error message.
- Select the WSDL location.
Note: For an internal service,
the template WSDL is the service-specific WSDL file that describes the service
that is directly available at a service destination.
- Select the service from the WSDL.
Note: - This option is needed in case there is more than one service in the WSDL.
The field is filled in for you by default. If there is only one service in
the WSDL, accept the default.
- There needs to be at least one port defined in the service you select.
- Select endpoint listeners for the inbound configuration of this
gateway service.
- Define any UDDI publication properties.
- If the target service is an external Web service, the option Outbound
Web service enablement is available in the additional properties section.
Click this option to modify the outbound service configuration for this target
service. For more information, see Modifying an existing outbound service configuration.
- Click Finish.
If the processing completes successfully, the list of gateway services
for this gateway instance is updated to include the new gateway service. Otherwise,
an error message is displayed.