Excluding servers from link translation for HAT configuration in IAG

  • Article

Applies To: Intelligent Application Gateway (IAG)

In Whale Communications Intelligent Application Gateway (IAG) 2007 portals, you can define servers so that they are not manipulated by the IAG host address translation (HAT) mechanism (for example, if you use regular expressions to define an application but want to exclude a specific server from that application).

For more information about HAT, see About host address translation (HAT) in IAG portals.

This topic describes the parameters you configure in the Application Access Portal configuration file, in order to exclude servers from link translation.

<DONT_SIGN_SERVERS>

Description

Defines the servers that are excluded from the manipulation process.

Usage

Only one <DONT_SIGN_SERVERS> element can reside in the Application Access Portal configuration file.

Attributes & Attribute Values

None.

Child Elements

<DONT_SIGN_SERVERS> must contain one or more <SERVER> elements, described below.

[<DONT_SIGN_SERVERS>] > [<SERVER>]

<SERVER>

Description

Child element of <DONT_SIGN_SERVERS>. Defines a server that is excluded from the manipulation process.

Usage

  • At least one <SERVER> element must be nested under <DONT_SIGN_SERVERS>.

  • An unlimited number of <SERVER> elements can be nested under <DONT_SIGN_SERVERS>.

Attributes & Attribute Values

None.

Child Elements

  • One and only one <SERVER_NAME> element must be nested under <SERVER>.

  • One <PORT> element can optionally be nested under <SERVER>.

[<DONT_SIGN_SERVERS>] > [<SERVER>] > [<SERVER_NAME>]

<SERVER_NAME>

Description

Child element of <SERVER>. Name of the server that is excluded from the manipulation process.

Usage

  • One, and only one, <SERVER_NAME> element must be nested under each <SERVER> element.

  • Can be defined using one of the following methods:

    • Server name or a range of names, using regular expressions.

    • Subnet, using the mask attribute. For example:

      For subnet class A:

      <SERVER_NAME mask="255.0.0.0">63.0.0.0</SERVER_NAME>

      For subnet class B:

      <SERVER_NAME mask="255.255.0.0">160.12.0.0</SERVER_NAME>

      For subnet class C:

      <SERVER_NAME mask="255.255.255.0">192.168.1.0</SERVER_NAME>

      Note

      In this syntax, enter the actual IP address, not regular expressions.

Tip

For examples of the use of both methods in a <SERVER_NAME> element, refer to Sample Code: <DONT_SIGN_SERVERS>.

Attributes & Attribute Values

Attribute Values Type or comments

mask

subnet mask

Optional. Used to define a subnet mask.

Child Elements

None.

[<DONT_SIGN_SERVERS>] > [<SERVER>] > [<PORT>]

<PORT>

Description

Child element of <SERVER>. Specifies the port number, on the server defined in <SERVER_NAME>, that is excluded from the manipulation process.

Usage

  • Optional.

  • Only one <PORT>element can be nested under each <SERVER> element.

Attributes & Attribute Values

None.

Child Elements

None.

Sample Code: <DONT_SIGN_SERVERS>

<DONT_SIGN_SERVERS>

<SERVER>

<SERVER_NAME>www\.treemenu\.com</SERVER_NAME>

</SERVER>

<SERVER>

<SERVER_NAME>www\.myserver\.com</SERVER_NAME>

<PORT>8080</PORT>

</SERVER>

<SERVER>

<SERVER_NAME mask="255.255.255.0">192.168.1.0</

SERVER_NAME>

</SERVER>

<SERVER>

<SERVER_NAME>www\.gnu\.org</SERVER_NAME>

</SERVER>

<SERVER>

<SERVER_NAME>www\.whalecommunications\.com</SERVER_NAME>

</SERVER>

</DONT_SIGN_SERVERS>