With the Configuration Manager the handling of configurations have changed to the preferences format. In order to use or existing crystalclear.properties files, they have to be imported.
Distributing a configuration to other machines can be done via the export function.
If the import is started, you have to select a *.properties file from your local file system. If you have chosen one, a dialog appears where you have to enter a name and optionally a description. If you want another target scope than the one the import was started from, a new scope can be selected too.
The import starts immediately and creates a new configuration with the properties from the selected file. If a subsequent search will find some DLL settings, a new dialog with a table of all included DLLs is shown. There you can choose the driver for each DLL that should be converted to the data source format. A DLL can only be imported with one driver or be ignored. It is also possible to select a different target scope for each DLL.
If you select a DLL, the properties of the chosen driver are shown in the lower panel. This will help you to find the right driver for conversion.
Clicking the OK button will convert the selected DLLs which can be found in the Data Source Manager afterwards.
A click on the Cancel button won't import any data source.
If you do not want (or are not able) to use the Configuration Manager GUI for importing your crystalclear.properties files, you can do the same via the command line.
The program argument -importConfig will start the import process without displaying any window.
java -jar core/CrystalClear.jar -importConfig <name> <file>
In the argument <name> you must specify the scope and name of the configuration that is to be created, e.g. “System/Default” or “User/myConfig”. Only scopes “System” and “User” are allowed.
The argument <file> must contain the path to a readable and valid properties file, e.g. crystalclear.properties.
The program argument -forceImportConfig start the import process of the properties file and replace a configuration that exists with the same name in the specified scope, e.g.:
java -jar core/CrystalClear.jar -forceImportConfig "USER/MyConfig C:\crystalclear.properties"
Please note that the import by command line will not convert any DLL-properties to data sources. This can only be done by using the Configuration Manager.
In order to backup your existing configurations or to use them on another machine, they can be saved in your file system via the export functionality. The settings are saved in a file with the .properties extension and in the format key=value.
With the import button or above command line arguments, the created files can be imported in any other Configuration Manager.
i‑net software strives to provide accurate product documentation. Please give us your feedback using the form below.
NOTE: This form is for documentation feedback only. For technical assistance, please send an email to crystalclear@inetsoftware.de.
