Configuring the connection to iServer

The Information Console provides the ability to connect to iServer, an Encyclopedia volume, and manage reports on remote systems. Configure the repository, network, and Message Distribution Service for the Information Console using parameters in web.xml. These parameters control the Information Console’s connection to iServer and the Encyclopedia volume. Table 4-6 describes the configuration parameters for networking with iServer.

**Table 4-6** iServer connection web.xml parameters
Parameter name	Description
DASHBOARD_SHARED_RESOURCES	Specifies the path for the shared dashboard and gadget resources on the Encyclopedia volume. The gadget gallery displays the contents of this folder under the shared folder and is the default location when sharing dashboards.
MAX_CONNECTIONS_PER_SERVER	Indicates the maximum number of Actuate Information Console connections to Actuate BIRT iServer. Actuate pools connections to increase efficiency. Choose a number of connections that satisfies the most requests concurrently without requiring an unreasonable amount of memory. Begin with a value equal to the number of threads available in your application server. The value for this parameter must be greater than 0. The default value is 150.
MDS_ENABLED	Indicates whether to enable the Message Distribution Service. The default value is True, which enables the Message Distribution Service. For more information about the Message Distribution Service, see Understanding Actuate Information Console load balancing.
MDS_REFRESH_FREQUENCY_SECONDS	Indicates, in seconds, how quickly Actuate Information Console detects an offline or new node in a cluster. If MDS_ENABLED is True, Information Console refreshes the list of available nodes from Actuate BIRT iServer at the time interval specified. The default value is 300 seconds.
REPOSITORY_CACHE_TIMEOUT_SEC	Specifies how long a repository cache remains valid. When the cache becomes invalid, any user actions refresh the cache for the time-out duration. The default value is 900 seconds.
TEMP_FOLDER_LOCATION	Specifies the directory the Information Console uses to temporarily store files from an Encyclopedia volume if viewing the file requires a location on the web server. If the value is not an absolute directory path name, Actuate Information Console locates the directory in the Information Console home directory. The default value is temp in the Information Console home directory. The Information Console user must have write permission for the directory. When deploying more than one context root or separate server, set a unique path for each.
VOLUME_PROFILE_LOCATION	Path to the volume profile configuration file from the context root. Default value is /WBE-INF/VolumeProfile.xml.