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
This is the location where CAST AIP stores configuration files that are shared among all users of the computer. Default value:
%PROGRAMDATA%\CAST\CAST\$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\
CAST_CURRENT_USER_WORK_PATH
This is the location where CAST AIP stores configuration files that are specific to each user on the computer. Default value:
%APPDATA%\CAST\CAST\$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\
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.
CAST_CURRENT_USER_TEMP_PATH
This is the location where CAST AIP stores temporary files. Default value:
%TEMP%\CAST\CAST\$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\
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
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. Default value:
%PROGRAMDATA%\CAST\CAST\Logs\
Note: For compatibility with previous versions of CAST AIP up to 8.2.7 included, use the value below:
;%TEMP%\CAST\CAST\8.3\
CAST_CURRENT_USER_PERSONAL_PATH
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. Default value = NONE.
CAST_PROGRAM_FILES_COMMON_PATH
This is the location where CAST AIP stores files that are specific to a given version of CAST AIP. Default value:
%COMMONPROGRAMFILES%\CAST\CAST\$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\
CAST_PROGRAM_FILES_COMMON_UNVERSIONED_PATH
This is the location where CAST AIP stores files that are shared across versions - for example Environment Profiles. Default value:
%COMMONPROGRAMFILES%\CAST\CAST\
CAST_PLUGINS_ROOT_PATH
Default value:
%PROGRAMDATA%\CAST\CAST\Extensions
This value defines where CAST will expect any extensions.
CAST_DEFAULT_LISA_DIR
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. Default value:
%PROGRAMDATA%\CAST\CAST\CASTMS
CAST_DEFAULT_LTSA_DIR
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. Default value:
%PROGRAMDATA%\CAST\CAST\CASTMS
CAST_DEFAULT_DELIVERY_DIR
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. Default value:
%SystemDrive%\CASTMS\Delivery
CAST_DEFAULT_DEPLOY_DIR
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. Default value:
%SystemDrive%\CASTMS\Deploy