Introduction
This section explains how to change the folders where CAST AIP applications store data that is required for correct functioning. To do so, you need to modify a file named CastGlobalSettings.ini located in the CAST AIP installation folder (i.e. where the CAST AIP executables are stored). This file uses the standard .ini syntax, i.e. lines starting with a semi-colon are comments, and each line should contain a key-value pair, written as follows:
key=value
There are various keys that can be used to override where CAST AIP stores data:
- All key-value pairings in the CastGlobalSettings.ini file are already commented with a semi-colon. If you modify a value, please ensure that the corresponding semi-colon is removed otherwise the changes you make will not be taken into account.
Microsoft Windows and CAST AIP environment variables
All "key-value" pairings in the CastGlobalSettings.ini file use a mixture of Microsoft Windows environment variables and CAST AIP specific environment variables:
Microsoft Windows environment variables
Variables enclosed using the % character are Windows environment variables. An explanation of these variables can be viewed here (third-party website).
CAST AIP environment variables
Variables enclosed using the $ character are variables specific to CAST AIP and are used to define the name of folders on disk:
| Variable | Explanation |
|---|---|
$CAST_MAJOR_VERSION$ | This option will match the current major release version number. In other words, "8" in the release number "8.2.1". |
$CAST_MINOR_VERSION$ | This option will match the current minor release version number. In other words, "2" in the release number "8.2.1". |
$CAST_REVISION_VERSION$ | This option will match the current Service Pack release version number. In other words, "1" in the release number "8.2.1". Note that this variable is not used by default in the CastGlobalSettings.ini file, but can be added if required. |
CAST_ALL_USERS_PATH
Default value:
%ALLUSERSPROFILE%\Application Data\CAST\CAST\$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\
This is the location where CAST AIP stores configuration files that are shared among all users of the computer. Note that the %ALLUSERSPROFILE% environment variable is a symbolic link to: %PROGRAMDATA%, therefore the location can also be described using this environment variable:
%PROGRAMDATA%\CAST\CAST\$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\
CAST_CURRENT_USER_WORK_PATH
Default value:
%APPDATA%\CAST\CAST\$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\
This is the location where CAST AIP stores configuration files that are specific to each user on the computer.
CAST recommends that you avoid modifying this value unless you ensure that either only one user is using this installation, or each user has its own path based on an environment variable, and taking into account the important note below.
CAST_CURRENT_USER_TEMP_PATH
Default value:
%TEMP%\CAST\CAST\$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\
This is the location where CAST AIP stores temporary files.
Please note that some of the files stored in this location may be quite large (several GB) as such, please ensure that this key points to a location with several GB of free space.
CAST_LOG_ROOT_PATH
Default value:
%ALLUSERSPROFILE%\Application Data\CAST\CAST\Logs\
This is the location where CAST AIP stores log files. This location is also used to initialize the "Logs" field in the CAST Management Studio Startup Wizard, see Initialize the platform preferences in CAST Management Studio.
CAST_CURRENT_USER_PERSONAL_PATH
Default value = NONE.
This is the location where CAST AIP stores document files that are private to each user on the computer. It is not currently used by CAST AIP.
CAST_PROGRAM_FILES_COMMON_PATH
Default value:
%COMMONPROGRAMFILES%\CAST\CAST\$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\
This is the location where CAST AIP stores files that are specific to a given version of CAST AIP.
CAST_PROGRAM_FILES_COMMON_UNVERSIONED_PATH
Default value:
%COMMONPROGRAMFILES%\CAST\CAST\
This is the location where CAST AIP stores files that are shared across versions - for example Environment Profiles.
CAST_PLUGINS_ROOT_PATH
Default value:
%ALLUSERSPROFILE%\Application Data\CAST\CAST\Extensions\
This value (located within the CAST AIP installation folder) defines where CAST will expect any extensions (such as the extension that provides support for WCF). Note that the %ALLUSERSPROFILE% environment variable is a symbolic link to: %PROGRAMDATA%, therefore the location can also be described using this environment variable:
%PROGRAMDATA%\CAST\CAST\Extensions
CAST_DEFAULT_LISA_DIR
Default value:
%PROGRAMDATA%\CAST\CAST\CASTMS
This location is used only to initialize the "LISA" field in the CAST Management Studio Startup Wizard, see Initialize the platform preferences in CAST Management Studio.
CAST_DEFAULT_LTSA_DIR
Default value:
%PROGRAMDATA%\CAST\CAST\CASTMS
This location is used only to initialize the "LTSA" field in the CAST Management Studio Startup Wizard, see Initialize the platform preferences in CAST Management Studio.
CAST_DEFAULT_DELIVERY_DIR
Default value:
%SystemDrive%\CASTMS\Delivery
This location is used only to initialize the "Source Code Delivery" field in the CAST Management Studio Startup Wizard, see Initialize the platform preferences in CAST Management Studio.
CAST_DEFAULT_DEPLOY_DIR
Default value:
%SystemDrive%\CASTMS\Deploy
This location is used only to initialize the "Source Code Deployment" field in the CAST Management Studio Startup Wizard, see Initialize the platform preferences in CAST Management Studio.