The Role of the Magic.ini and ifs.ini Files (Magic xpi 4.13)
This technical note explains the roles of the Magic xpi's Magic.ini and ifs.ini files.
Magic xpi installation contains both the Magic.ini file, which is the main configuration file, as well as the ifs.ini file for the Server.
The Magic.ini file contains all Magic xpi's variable configuration information and is a free format text file that you can edit using any external text editor. For Magic xpi to be able to start up, the Magic.ini file must be located in the <Magic xpi installation>\Runtime\Magic xpa folder.
You can make most of the configurations directly in the Magic xpi Studio, and the Magic.ini file is updated automatically. You can also access the Magic.ini file from the Programs menu by selecting Magic xpi x.x > Configuration File > Magic.ini.
The ifs.ini files contain some sections and properties that are identical to those in the main Magic.ini file. If you change a setting in the ifs.ini file so that it differs from the information in the Magic.ini file, the information in the Magic.ini file is overridden and Magic xpi runs according to the configuration in the ifs.ini file.
|
| The ifs.ini file always takes precedence over the Magic.ini file, both in the Studio and in Runtime. Since version: 4.5 |
The Magic.ini file is read every time Magic xpi is started, and that is when any settings changes take effect. The ifs.ini file is read every time the respective Magic xpi module is started. The MAGIC sections of the .ini files are used by Magic xpi’s underlying Magic xpa engine.
-
Although they have some identical sections, the module .ini files have different structures from that of the Magic.ini file.
-
A line that starts with a semicolon is ignored when Magic xpi runs and is said to be “in remark”.
-
In the ifs.ini file, whenever you need to use the ‘\’ character, you have to use double ‘\\’ characters instead of a single one.
-
In the Magic.ini file you have to use the + sign when you want to split a line.
The Magic.ini file is divided into different sections and each section contains a group of related settings.
Some of the important sections of the Magic.ini file are:
|
|
|
|
|
Environment
|
[MAGIC_ENV]
|
Global environment parameters
|
|
DBMS
|
[MAGIC_DBMS]
|
List of all DBMSs supported by Magic xpi
|
|
Databases
|
[MAGIC_DATABASES]
|
List of all databases supported by Magic xpi
|
|
Environment Variable
|
[MAGIC_LOGICAL_NAMES]
|
The Environment Variables translation repository
|
|
Gateways
|
[MAGIC_GATEWAYS]
|
List of Magic xpi database gateways
|
