Release 10.1A: OpenEdge Application Server:
Administration

> ## Network Address Translation (NAT) and the WebSpeed distributed configuration

> Network Address Translation, or NAT, is an Internet standard that supports one set of Internet Protocol (IP) addresses for external traffic and a second set of addresses for internal use. A router translates these IP addresses between network domains, hiding internal addresses and generating globally unique, routable addresses. NAT, and IP Convert, are general forms to mask IP addresses, shielding this information from the Internet. In this manner, the NAT process helps promote more secure connections between clients and WebSpeed.

> OpenEdge and WebSpeed support NAT in a distributed configuration arrangement through a registration process. The value you select for the Registration Mode indicates how the WebSpeed broker identifies its hostname when the WebSpeed broker registers with its controlling NameServer. When a client application attempts to connect to an application service on a host machine that the WebSpeed broker supports, the hostname information is passed to the client application, provided that the information can be authenticated.

> The specific value you set up for the Registration mode depends on the connection arrangement you want. The following procedures identify and describe the Registration mode values.

> | To make a client connection through a NAT firewall using the Progress Explorer Tool:

> 1. Double click the WebSpeed folder on the left-hand side of the main Progress Explorer window.

> 2. Right click the broker name.

> 3. Choose Properties from the shortcut menu.

> 4. Select Broker Controlling NameServer Information to display properties associated with the WebSpeed broker.

> 5. Select the Registration Mode value you want to set. Table 13–4 defines each value.

> Table 13–4: Registration Mode connection - Progress Explorer
> Select this Registration Mode... | To Identify the hostname as...
> --- | ---
> Use Broker Host IP Address (default) | The IP address of the machine where the WebSpeed broker is located. The WebSpeed broker determines its IP address and passes this information to the NameServer when the broker registers. Clients connect to the host using the broker’s IP address.
> Use Broker LocalHost | The hostname of the machine where the WebSpeed broker is located. The WebSpeed broker determines its hostname and passes this information to the NameServer when the broker registers. Clients connect to the host using this hostname.
> Use Host Name (as defined in the unlabeled property description field) | The IP address defined. The WebSpeed broker passes the IP address value defined in the property description field to the NameServer when the broker registers. Clients connect to the host using the IP address defined.

> 6. Click the OK button.

> | To make a client connection through a NAT firewall using the ubroker.properties file:

> 1. Search the file for the broker property section, or sections, that you want to change.

> 2. Set the value of the `registrationMode` property. Table 13–5 defines the values from which you can choose to enter in the `registrationMode` property.

> Table 13–5: RegistrationMode Connection - ubroker.properties
> file
> Enter this Registration Mode... | To Identify the hostname as...
> --- | ---
> `Register-IP` (default) | The IP address of the machine where the WebSpeed broker is located. The WebSpeed broker determines its IP address and passes this information to the NameServer when the broker registers. Clients connect to the host using the broker’s IP address.
> `Register-LocalHost` | The hostname of the machine where the WebSpeed broker is located. The WebSpeed broker determines its hostname and passes this information to the NameServer when the broker registers. Clients connect to the host using this hostname.
> `Register-HostName` | A specific a hostname or IP address. You must: Enter the value `Register-HostName` in the `registrationMode` property field. Enter the hostname, or the IP address of the hostname, in the `hostName` property field to identify where the WebSpeed broker is running. Enter a description of the type of IP address you entered in the description property field. The WebSpeed broker passes either the hostname or the IP address value defined in the `hostName` property to the NameServer when the broker registers. Clients connect to the host using either the `hostName` or the IP address defined.

> Note: For more information, see the “GENERAL INSTRUCTIONS for configuring the Unified Broker and NameServer for WebSpeed and AppServers” in the `ubroker.properties` file.

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095