Setting Up Routing Information to Forward Redirected Client Requests

After you configure a server's [Gateway] section to redirect client requests to another server, you must then go to the server now receiving the requests (often the same server, as in many ProjectWise Gateway Service configurations) and configure the [Routing] section in its DMSKRNL.CFG file so that server will know where to forward these requests. Most often you will configure the server now receiving the requests (the gateway server) to forward requests to the routed server (the final destination of the request). In some cases, however, you may find it necessary to forward requests to another gateway server, which will then forward the request to its destination. This subtle difference affects the way you configure the [Routing] section, as you will see below.

A sample, commented out [Routing] section exists in each DMSKRNL.CFG file by default, with general instructions of usage and syntax. It is recommended that you make a copy of the delivered examples so you can use the original as a reference. The following is the entire [Routing] section as delivered in any DMSKRNL.CFG file:

;[Routing]
;This section is used by the Gateway server that this config file is installed on
;to determine where to route requests that have been sent to it on behalf of a Routed Server
;If there are multiple hops necessary to get to the Routed server, this will direct this server
;to forward to the next hop on a particular port, otherwise only the information about what
;port number the Routed server is listening on is necessary
;Format
;Routed Server = Port Number,Next Gateway Server

;Examples (shows two different scenarios)
;server1=5800,server3
;server1=5800

Note: The servers specified on both sides of the = character can be represented by the server's name or IP address.

Note: The port number specified in these examples must match the port number set as the listening port in the DMSKRNL.CFG file of the server you are forwarding the request to. 5800 is the port used in these examples because it is the default listening port on any ProjectWise Integration Server, ProjectWise Gateway Service, or ProjectWise Caching Server.

Configuring a Server to Forward Requests

Open the DMSKRNL.CFG file on the server that is receiving redirected client requests.
Uncomment the line ;[Routing] by removing the semicolon (;) from the beginning of the line.
To forward requests directly to the routed server (to forward a request to its final destination), use the following example:
```
[Routing]
INTSERVER1=5800
```
This example tells the server that if it receives any requests bound for the server called INTSERVER1, to go ahead and forward it to INTSERVER1 through port 5800.
To forward requests to another gateway server (to a server which will also forward the request) on its way to the routed server, use the following example:
```
[Routing]
INTSERVER2=5800,PGS2
```
This second example tells the server that if it receives any requests bound for the server called INTSERVER2, to forward it to the ProjectWise Gateway Service called PGS2 through port 5800. Your next step would be to open PGS2's DMSKRNL.CFG file and configure its [Routing] section to forward requests to the appropriate server.
Add additional lines for each routed server this server is forwarding requests to.