Back to Contents | GAS Configuration File Overview

Interface to DVM - Configuration Reference

The INTERFACE_TO_DVM element in the Genero Application Server (GAS) configuration file specifies the connection between the GAS and the Dynamic Virtual Machine (DVM). This element specifies the address of the host where the GAS daemon (gasd) runs, the range of valid ports for each launched DVM to connect, and a list of excluded ports on which a DVM cannot connect.

There can only be one INTERFACE_TO_DVM element specified in a given Genero Application Server configuration file.

Syntax:

<INTERFACE_TO_DVM>
  <ADDRESS> address </ADDRESS>
  <TCP_BASE_PORT> port </TCP_BASE_PORT>
  <TCP_PORT_RANGE> range </TCP_PORT_RANGE>
  [ <EXCLUDED_PORT> exclPort </EXCLUDED_PORT> ] [...]
</INTERFACE_TO_DVM>

Notes:

The INTERFACE_TO_DVM element may contain the following child elements (described below):

  1. One ADDRESS element (required).
  2. One TCP_BASE_PORT element (required).
  3. One TCP_PORT_RANGE element (required).
  4. Zero to many EXCLUDED_PORT elements (optional).

Example:

<INTERFACE_TO_DVM>
  <ADDRESS>app_server</ADDRESS>
  <TCP_BASE_PORT>6420</TCP_BASE_PORT>
  <TCP_PORT_RANGE>10000</TCP_PORT_RANGE>
  <EXCLUDED_PORT>6667</EXCLUDED_PORT>
  <EXCLUDED_PORT>7200</EXCLUDED_PORT>
  <EXCLUDED_PORT>8080</EXCLUDED_PORT> 
</INTERFACE_TO_DVM>

In this example, valid port numbers on which a DVM can be started to service an application range from 6420 to 16423 (TCP_BASE_PORT + TCP_PORT_RANGE + number of excluded ports), excluding those ports specified in EXCLUDED_PORT elements (ports 6667,7200, and 8080).

ADDRESS

The ADDRESS element specifies the name or IP address of the machine where the Genero Application Server daemon (gasd) runs. This address is used by the DVM to set (build) the FGLSERVER environment variable. If the DVMs are running locally, this should be set to localhost.

Usage Examples:

  <ADDRESS>app_server</ADDRESS>
  <ADDRESS>192.127.45.17</ADDRESS>
  <ADDRESS>localhost</ADDRESS>

Back to the top

TCP_BASE_PORT

The TCP_BASE_PORT element specifies the port from where the Genero Application Server will start listening to Virtual Machines. In other words, the port specified is the first available port for the GAS daemon (gasd) to open for a DVM.

Usage Example:

  <TCP_BASE_PORT>6420</TCP_BASE_PORT>

Back to the top

TCP_PORT_RANGE

The TCP_BASE_RANGE specifies the range of ports the Genero Application Server can use to bind ports. In other words, this element specifies the range of valid ports for the GAS daemon (gasd) to open for a DVM, starting from the first available port specified by the value set by TCP_BASE_RANGE.

Usage Example:

  <TCP_BASE_RANGE>10000</TCP_BASE_RANGE>

Back to the top

EXCLUDED_PORT

The EXCLUDED_PORT element specifies an excluded port value - a port that the Genero Application Server will not try to bind when running as a server with the Virtual Machine. Each EXCLUDED_PORT element specifies a single port to exclude; to exclude multiple ports, you must provide multiple EXLUDED_PORT elements.

Usage Example:

  <EXCLUDED_PORT>7200</EXCLUDED_PORT>
  <EXCLUDED_PORT>8080</EXCLUDED_PORT>

Back to the top