Entering content frameBackground documentation ~agate_routing Locate the document in its SAP Library structure

Description

Specifies the AGate server or process to which a request should be sent in load balanced configurations.

The ITS supports load balanced configurations where:

  • Multiple AGate servers are attached to one ITS instance
  • Multiple AGate processes are attached to one AGate

Load balancing between multiple AGates means that the WGate routes every HTTP request from a user’s Web browser to one AGate server or process, but there is no way to tell which one.

When you are performing tasks such as debugging and administration, you sometimes need to override load balancing by routing requests explicitly to a particular AGate server or process.

To do this, you use the ~agate_routing parameter, which has the format:

~agate_routing=<AGate host>[:<process index>]

  • The value of AGate host is the host name exactly as it appears in the <agate> subsection of the wgate.conf file, which stores configuration information
  • The value of process index (optional) is the number of the AGate process in the case of multiple AGate processes. Possible values range from 0 to the value of maxAGates -1.

The wgate.conf file specifies whether an AGate server contains multiple processes in the multiprocess parameter, which can have the values yes or no . The only way to find out the actual number of AGate processes is by reading the Windows NT registry key maxAGates under

HKEY_LOCAL_MACHINE/software/SAP/its/2.0/
<instance>/Instances

In most cases, you use ~agate_routing in URL requests, as shown in the examples below.

Set by

Request.

Values

Name of any valid AGate server or process.

Examples

If you want to send a request to an AGate server called itshost , you could specify a URL similar to the following URL:

  • http://MyWebServer:MyPort/scripts/wgate/
    myservice/!?~agate_routing=itshost

If the AGate server itshost has multiple processes and you want to send a request to process 1 , you could specify a URL similar to the following:

  • http://MyWebServer:MyPort/scripts/wgate/
    myservice/!?~agate_routing=itshost:1

Valid from

Release 4.6DC3.

Leaving content frame