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, i.e.: "8" in the release number "8.2.1".

$CAST_MINOR_VERSION$

This option will match the current minor release version number. In other words, i.e.: "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, i.e.: "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 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 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 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_CURRENT_USER_PERSONAL_PATH

Default value = NONE.

This is the location where CAST stores document files that are private to each user on the computer. It is not currently used by CAST AIP.

Please note that this key is not present in the standard CastGlobalSettings.ini file. However, you must add the key and configure the value to point to %USERPROFILE%\Documents\ when deploying CAST AIP in a Citrix environment - see Install CAST AIP components.

CAST_LOG_ROOT_PATH

For CAST AIP ≥ 8.2.8 only

Default value:

%ALLUSERSPROFILE%\Application Data\CAST\CAST\Logs\

This is the location where the global CAST Management Studio log file (CAST-MSxx.log.txt) is stored and is eqaul to %PROGRAMDATA%\CAST\CAST\Logs.
If you prefer to continue to use the location used in previous releases of CAST AIP, you can override the path by activating the variable and changing the path to: %TEMP%\CAST\CAST\$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\

CAST_PROGRAM_FILES_COMMON_PATH

Default value:

%COMMONPROGRAMFILES%\CAST\CAST\$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\

This is the location where CAST stores files that are specific to a given version of CAST.

CAST_PROGRAM_FILES_COMMON_UNVERSIONED_PATH

Default value:

%COMMONPROGRAMFILES%\CAST\CAST\

This is the location where CAST 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 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