Within each service integration bus you can create multiple gateway
instances. You create Web services gateway instances to partition the total
set of gateway and proxy services into
logical groups to allow simpler management. The gateway provides you with
a single point of control, access and validation of Web service requests,
and allows you to control which Web services are available to different groups
of Web service users.
Before you begin
Why and when to perform this task
Bus destinations are already partitioned by the service integration
bus, so each gateway instance is limited to gateway and proxy services within
the same bus. However, gateway services can then map to target services that
are available on other buses.
To create a new gateway instance, complete
the following steps:
Steps for this task
- Start the administrative console.
- In the navigation pane, click bus_name. The gateway
instances collection form is displayed.
- Click New. The gateway
instances settings form is displayed.
- Type the following general properties:
- Name
- Type the name by which the gateway instance is known. This name must be
unique, and it must follow the following syntax rules:
- It must not start with "." (a period).
- It must not start or end with a space.
- It must not contain any of the following characters: \ / , # $
@ : ; " * ? < > | = + & % '
- Description
- Type the (optional) description of the gateway instance.
- Gateway namespace
- Type the namespace that you want to use for the gateway services in exported
WSDL documents. There is no fixed syntax for the gateway namespace, but whatever
name you choose is likely to be more effective if it observes the following
guidelines:
- Default proxy WSDL URL
Type the location (Web address) of the default proxy
WSDL file.
A gateway service that runs
in proxy mode has no actual target services and therefore no WSDL document
that the gateway can use to configure the service invocation. A generic template
WSDL file is used to configure the basic parameters for the invocation call. For more information, see JAX-RPC handlers and proxy operation.
The
supplied template WSDL file is located here:
http://host_name:port_number/SIBWS/proxywsdl/ProxyServiceTemplate.wsdl
where
host_name and
port_number are the host name and port
number for this application server. For example
http://your.server.name:9080/SIBWS/proxywsdl/ProxyServiceTemplate.wsdl
Alternatively, you can supply the Web address of your own equivalent template
WSDL file.
- Click OK.
If the processing completes successfully, the list of gateway instances
is updated to include the new gateway instance. Otherwise, an error message
is displayed.
You are now ready to create a gateway service or create a proxy service for this gateway instance.