Managing Endpoints

This section describes how to manage endpoints. The actions that can be carried out for an endpoint are as follows.

An endpoint can be added as follows.

1. Open the ESB management console.

2. Click Endpoints under Service Bus in the left navigator to open the Manage Endpoints page.

3. Click on the Add Endpoint tab.

4. Click on the endpoint type you want to add. Available types are as follows.
   
   

   • Address Endpoint  - Defines the direct URL of the service.

   • Default Endpoint  - Defines additional configuration for the default target.

   • Failover Group  - Defines the endpoints that the service will try to connect to in case of a failure. This will take place in a round robin manner.

   • HTTP Endpoint - Defines a URI template based REST service endpoint.

   • Load Balance Endpoint  - Defines groups of endpoints for replicated services. The incoming requests will be directed to these endpoints in a round robin manner. These endpoints automatically handle the fail-over cases as well.

   • Recipient List Group -  Defines the list of endpoints a message will be routed to.

   • Template Endpoint  - Allows to create a custom Endpoint template.

   • WSDL Endpoint  - Defines the WSDL, Service and Port.

   
   Enter the required information for the endpoint depending on the type you selected. Click on the relevant link above to find detailed information on how to configure the endpoint you selected.
   

5. Click Show Advanced Options if you want to configure advanced settings for the endpoint. Available advanced options are as follows. 

6. Click Add Property if you want to add any properties to an endpoint. The page will expand to display the following parameters. 
    

   See Properties Reference for more information on properties that you can add to the endpoint.

7. Click Save & Close to save the endpoint in the synapse configuration, or click Save in Registry if you want to save it as a dynamic endpoint in the Registry.

After you add an endpoint, you can edit its attributes or semantics that are followed when communicating with that endpoint. An endpoint can be edited as follows.

1. Open the ESB management console.

2. Click Endpoints under Service Bus in the left navigator to open the Manage Endpoints page.

3. Click on the Defined Endpoints tab if the endpoint you want to edit is saved in the synapse configuration. Click on the Dynamic Endpoints tab if the endpoint you want to edit is saved in the Registry. The existing endpoints saved in the synapse configuration/registry will be displayed.

4. Click Edit for the required endpoint. Make the required modifications. See Adding an Endpoint for more information.

5. Click Save & Close to save the endpoint in the synapse configuration, or click Save in Registry if you want to save it as a dynamic endpoint in the Registry.

An endpoint can be deleted as follows.

1. Open the ESB management console.

2. Click Endpoints under Service Bus in the left navigator to open the Manage Endpoints page.

3. Click on the Defined Endpoints tab if the endpoint you want to delete is saved in the synapse configuration. Click on the Dynamic Endpoints tab if the endpoint you want to delete is saved in the Registry. The existing endpoints saved in the synapse configuration/registry will be displayed.

4. Click Delete for the required endpoint. Then click Yes in the message which appears to confirm whether you want to proceed deleting the endpoint.

Statistics can be enabled or disabled as required for Address endpoints and WSDL endpoints. Note that this action can be carried out only for  defined endpoints, which are endpoints saved in the Synapse configuration. You cannot enable statistics for  dynamic endpoints, which are saved in the Registry. 

Statistics can be enabled/disabled as follows.

1. Open the ESB management console.

2. Click Endpoints under Service Bus in the left navigator to open the Manage Endpoints page.

3. Click on the Defined Endpoints tab. The Enable Statistics link will be displayed for endpoints with statistics currently disabled. The Disable Statistics link will be displayed for endpoints with statistics currently enabled.

4. If you want to enable statistics for an endpoint, click Enable Statistics in the relevant row. If you want to disable statistics for an endpoint, click Disable Statistics in the relevant row.

Having many active endpoints may result in heavy traffic, and thereby cause performance degradation. In order to prevent that, you can temporarily switch off some endpoints and switch them on again when you need them in an active state. Note that this action can be carried out only for  defined endpoints, which are endpoints saved in the Synapse configuration. You cannot enable statistics for  dynamic endpoints, which are saved in the Registry

An endpoint can be switched on/off as follows.

1. Open the ESB management console.

2. Click Endpoints under Service Bus in the left navigator to open the Manage Endpoints page.

3. Click on the Defined Endpoints tab. The Switch On link will be displayed for endpoints which are currently switched off. The Switch Off  link will be displayed for endpoints which are currently switched on.

4. If you want to activate an endpoint, click Switch On in the relevant row. If you want to deactivate an endpoint, click Switch Off in the relevant row.