HP Remote Graphics 4.2.0 User's Guide

Properties

Remote Graphics Software has a configuration mechanism that allows specifying many controls. This configuration mechanism is called Properties. Properties are name/value pairs. Properties are created with default values and can enable or disable window borders, set the codec quality, set the audio quality, adjust the connection timeouts, etc.

Properties are set in a configuration file, on the command line, or using the RGS Enterprise Service. Properties specified on the command line override properties set in a configuration file or RGS Enterprise Service.

Syntax

Properties are name/value pairs and can contain any non whitespace characters except "=" and "#". The property name and property value are separated by an "=". For example:

Rgreceiver.Network.Timeout.Warning=10

The name of this property is Rgreceiver.Network.Timeout.Warning, and the value of the property is 10.

All RGS Receiver properties begin with "Rgreceiver". All RGS Sender properties begin with "Rgsender". Property values cannot contain the "=" or "#" characters.

Properties can contain values of the following types: string, int, bool, string vector and int vector. Properties of type bool are set to either "1" or "0" - representing true or false.

Any property set to an empty value,

Rgreceiver.Browser.Name=

initializes as follows: if the value of the property is of type STRING, the value will be set to an empty string. If the value of the property is of type INT or BOOL, the value will be set to "0". This can be used to initialize properties in a configuration file or on the command line.

Configuration Files

All RGS properties can be set in a configuration file. The RGS Receiver uses a file named rgreceiverconfig to read for its properties. The RGS Sender uses a file named rgsenderconfig to read for its properties. On Windows these files are installed in the directory where RGS is installed. On Linux and HP-UX these files are installed in /etc/opt/hpremote/rgreceiver and /opt/opt/hpremote/rgsender respectively.

The configuration files contain properties (name/value pairs) with only one property per line. Empty lines (containing only whitespace characters) are ignored. The "#" character begins a comment on the line extending to the end of the line. If a property is listed more than once, the value of the last entry is used.

74