cdx.properties

This is a file based configuration mechanism which allows you to load new system properties into the runtime environment. The operation of may components can be configured by setting system properties and this approach allows for a hierarchical approach for specifying and over-writing properties.

There are several components which are configured via system properties, at least initially. The Loader searches the following locations for a cdx.properties file:

1. Class Path - The first instance of the cdx.properties file found on the class path.
2. User's Home Directory - The home directory of the user running the Java runtime process
3. User Defined Directory - what ever directory is specified in the cfg.dir system property
4. Current Working Directory - The working directory for the Java runtime process

It is possible that each of these locations contain a cdx.properties file. if more than one file is found, subsequent loads will over-write the previous settings. This means any values found in the current working directory will over-write those found in the class path.

Proxy Settings

The cdx.properties file is a good location for setting proxy data.

• http.proxyUser - user name to present to the proxy for authentication
• http.proxyPassword - Password to present to the proxy for authentication
• http.proxyHost - The hostname, or address, of the proxy server
• http.proxyPort - The port number of the proxy server.
• http.proxyDomain - use to define support for NTLM (Microsoft) proxy authentication.

Symbol Table

All system properties are loaded into the Symbol Table for use in the Template capability. It is therefore possible to specify data in configuration file (and on the command line with the -Dprefix) which can be used in many other parts of the toolkit.