Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer web services - Bus enabled web services > Enable web services through the service integration bus > Configure web services for a service integration bus > Work with the web services gateway > Create a new gateway service configuration
Modify an existing gateway service configuration
Modify the configuration details for a gateway service.
When you modify an existing gateway service, you cannot modify the service name, or the request and reply destination names for the service. However you can change the mediations that act on the gateway service, and the configuration of the inbound web service enablement of the gateway service. We can also add, modify or delete target services and ports for this gateway service. We can add or delete a target service by using the admin console as described in this task, or by using the addWSGWTargetService command or the removeWSGWTargetService command.
Any new target service that you add can be either an external web service, or a service that is available internally to your organization. It must be another implementation of the same logical service, so it must conform to the service description that already exists in the gateway service WSDL document. It must also be made available at a service integration bus destination. If an additional target service is already available at a destination (for example because it has already been configured as an inbound or outbound service), provided the destination details as part of the new target service creation process. If an additional target service is not already available at a destination, or you choose not to provide the destination details, the additional target service is automatically configured to a new destination. Any target service can be located at a destination that is on a different bus to the gateway service.
To list the gateway services, and to view and modify their configuration details...
Procedure
- Start the admin console.
- In the navigation pane, click Service integration -> Buses -> bus_name -> [Additional Properties] Web service gateway instances -> instance_name -> Gateway Services . A list of gateway services is displayed in a gateway services collection form.
- Click the name of a gateway service in the list. The current settings for this gateway service are displayed.
- Modify the general properties. For information about each of these properties, see Gateway services settings.
- We cannot modify the service name, or the request and reply destination names.
- The lists of available mediations contain all mediations that are currently deployed to this service integration bus. If we have created a target selection 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 drop-down 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). To use a mediation assign it to a bus member. If you do not do this, the admin console displays an error message.
- Because you can have more than one target service, you also specify a default target service. If you want greater flexibility as to which target service is invoked in any given situation, you should create a mediation that can select the required target service. See Target services and gateway services and Choosing a target service and port through a routing mediation.
- Under the additional properties > Inbound web service enablement to modify the configuration as a web service of the inbound aspect of the gateway service. The gateway service receives and sends web service requests and responses by being configured as an inbound service. For information about configuring an inbound service, see Modify an existing inbound service configuration.
- Under the additional properties > Target service to add, modify or delete a target service for this gateway service. A list of target services for this gateway service is displayed in a target services collection form.
- To add a new target service...
- Click New. The target services settings form is displayed.
- Specify the target service name, bus name and destination name.
- Choose a target 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 Bus name field lists all available buses. The 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 admin console displays an error message.
- If the new target service is an external web service, in the additional properties section click Outbound web service enablement to create the new outbound service configuration for this target service. For information about configuring an outbound service, see Make an externally-hosted web service available internally.
- Click OK.
If the processing completes successfully, the list of target services for this gateway service is updated. Otherwise, an error message is displayed.
- To modify an existing target service, complete the following steps:
- Click the name of a target service in the list. The current target services settings for this target service are displayed.
- Modify the bus name and destination name.
- We cannot modify the target service name
- 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 Bus name field lists all available buses. The 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 admin console displays an error message.
- 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. See Modify an existing outbound service configuration.
- Click OK.
If the processing completes successfully, the list of target services for this gateway service is redisplayed. Otherwise, an error message is displayed.
- To delete one or more existing target services...
- Select the check box for every gateway service that you want to delete.
- Click Delete.
If the processing completes successfully, the list of target services for this gateway service is updated. Otherwise, an error message is displayed.
- Click Apply. The current settings for this gateway service are redisplayed.
- Click OK.
Results
If the processing completes successfully, the list of gateway services for this gateway instance is redisplayed. Otherwise, an error message is displayed.
Target services and gateway services
Related
addWSGWTargetService command
removeWSGWTargetService command
Gateway services [Settings]
Target services [Settings]