The Central Configuration Console is the administrator tool to modify the configuration data. This page describes the GUI version of this tool. For the command line interface look here.
The main window is divided in two panes. The tree control on the left contains all configuration objects. It is possible to create new configuration objects, copy configuration objects or remove configuration objects in this tree control. This can be done from the main menu, or by right-clicking an object to invoke its context menu. Once a configuration is selected, the right pane shows the properties for that configuration. These properties can then be modified.
There are two classes of configuration objects:
Smart configurations also have a defaulting mechanism to avoid that a lot of configuration objects must be stored in the central configuration store. It is no longer necessary to enter configurations for each machine or user. There is always one default configuration that is used by all machines and users for which no specific configuration is defined. This default configuration is represented by the root node in the configuration tree control. An example is the Logging node. If this default configuration is modified is will have effect for all machines, users and applications. If you want to change this configuration for a specific machine, user or application, you have to add a new configuration under this root node, by choosing the Add Machine, Add User or Add Application action.
It is possible to make more specific configurations. For example if a configuration exists for a specific machine then it is possible to add a new configuration for a specific user on that machine. To make it even more complex, it is also possible to add a new configuration for a specific application under this user configuration. The latter means that this configuration will only be used when the specific application is used by the specific user on the specific machine.
The following tree shows the possible configurations:
default default configuration
+- application configuration for this application
+- user configuration for this user
| +- application configuration for this application run by user
+- machine configuration for this machine
+- application configuration for this application on this machine
+- user configuration for this user on this machine
+- application configuration for this application, run by this user on this machine
If you run an application and want to know which configuration is used then you can use the search action. This pops up the search dialog in which you can enter machine, user and application name. The search result will be selected in the configuration tree control. The smart search algorithm will search for the configuration in the following order, the first one with matching names will be used, the * will match any name (i.e. is the default):
| nr | machine name |
user name |
application name |
|---|---|---|---|
| 1 | machine | user | application |
| 2 | * | user | application |
| 3 | machine | * | application |
| 4 | * | * | application |
| 5 | machine | user | * |
| 6 | * | user | * |
| 7 | machine | * | * |
| 8 | * | * | * |
To change a specific configuration back to the default settings, you must just remove that configuration. It is advised to keep the number of configuration as small as possible. Only add new configurations for exceptional cases, for example to turn on logging for a certain machine.
The following actions can be performed from the Central Configuration Console's main menu, toolbar or popup menu:
All configuration objects have one or more common properties. Because they are common, they are described here, rather than mentioning them for each configuration type.