Configuring the connection to iHub Server
Visualization Platform client provides the ability to connect to iHub Server, a volume, and manage reports on remote systems. Configure the repository, network, and Message Distribution service for Visualization Platform client using parameters in web.xml. These parameters control Visualization Platform client’s connection to iHub and the volume. Table 2‑7 describes the configuration parameters for networking with iHub.
Table 2‑7 iHub connection web.xml parameters
Parameter name
Description
AUTO_SAVE_DASHBOARD_DELAY
Controls how long, in seconds, the dashboard engine should wait before sending a save message to persist the personal dashboard file. To disable auto save, set this value to 0.
DASHBOARD_SHARED_RESOURCES
Specifies the path for the shared dashboard and gadget resources on the 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 Visualization Platform client connections to BIRT iHub. 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 Visualization Platform client load balancing.
MDS_REFRESH_FREQUENCY_SECONDS
Indicates, in seconds, how quickly Visualization Platform client detects an offline or new node in a cluster. If MDS_ENABLED is True, Visualization Platform client refreshes the list of available nodes from BIRT iHub 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.
SERVER_QUERY_
TIMEOUT
Specifies how long iHub Visualization Platform client waits for a response before the socket times out for the BIRT iHub connection. Its default value is eight seconds.
TEMP_FOLDER_LOCATION
Specifies the directory Visualization Platform client uses to temporarily store files from a volume if viewing the file requires a location on the web server. If the value is not an absolute directory path name, Visualization Platform client locates the directory in the Visualization Platform client home directory. The default value is temp in the Visualization Platform client home directory. The Visualization Platform client user must have write permission for the directory. When deploying more than one Visualization Platform client application instance or context root on the same machine, you must set a unique path for each.
VOLUME_PROFILE_LOCATION
Path to the volume profile configuration file from the context root. Default value is /WEB-INF/VolumeProfile.xml.