Server descriptors and IceBox descriptors may specify environment variables that the node will define when starting a server. An environment variable definition uses the familiar
name=value syntax, and you can also refer to other environment variables within the value. The exact syntax for variable references depends on the platform on which the server's descriptor is deployed.
On a Unix platform, the Bourne shell syntax is required:
On a Windows platform, the syntax uses the conventional style:
In XML, the
env element supplies a definition for an environment variable:
If a value refers to an environment variable that is not defined, the reference is substituted with an empty string.
Environment variable definitions may also refer to descriptor variables and template parameters:
On Unix, an environment variable
VAR can be referenced as
}. You must be careful when using the latter syntax because IceGrid assumes
} refers to a descriptor variable or parameter and will report an error if no match is found. If you prefer to use this style to refer to environment variables, you must escape these occurrences as shown in the example below:
IceGrid does not attempt to perform substitution on
}, but rather removes the leading
$ character and then performs environment variable substitution on