Installation requirements

	AIP Core is delivered in a ZIP file. Make sure you have the required ZIP file ready and unzipped to a folder on the AIP Node (it cannot be run from a network location).
	AIP Core needs to be installed on all AIP Nodes (i.e. dedicated servers) that will be managed by AIP Console. The installation process consists of running a setup installer on the target server.
	Installation paths: The CAST AIP setup can only be installed to a local or mapped drive Paths starting with \\ will be refused by the setup and are not permitted. Data storage paths / global settings: All paths are accepted and are never checked by the CAST AIP setup. E.g. local full path, mapped drive, remote location starting with \\ are all accepted. Please ensure that the current user has access to these data storage locations.
	You need local "Administrator" privileges to install AIP Core on all Windows versions. In addition, the installer requires elevated permissions and therefore needs to be run using the "Run as Administrator" option. In some rare circumstances, the installer may appear to have completed, but a message will also be displayed as follows: "The system has not been modified. To install this program at a later time, run the installation again." This message indicates that the setup has failed. This can occur even when your user login has "Administrator" privileges. In order to workaround this, you need to assign your user login a specific Windows privilege entitled Impersonate a client after authentication.
	The Windows login used to run the AIP Core installer cannot contain any special characters - for example: ! % | If the Windows login contains a special character, the installation will fail. Note that the above list of special characters is not exhaustive.
	Generally speaking, the installation path must only contain ASCII characters or characters of the language (or language group) of your Windows operating system. More precisely, all characters in the installation path must be present in the system Windows code page of the AIP Node. The system Windows code page is determined by the system locale. The system locale is defined in: Control Panel > Clock and Region > Region > Administrative tab > Language for non-Unicode programs. This language defaults to the language of the Windows operating system and can be changed, if needed. As an example, on any western European Windows installation, the system code page is Win-1252; on central European Windows installations, the code page is Win-1250, and on a Turkish Windows installation, the code page is Win-1254. The exact value of the code page is stored in the Windows registry at the following location: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage The value in the key 'ACP' indicates the current system Windows code page (also called ANSI Code Page, hence 'ACP'). If your installation path contains any character not present in the system Windows code page (e.g. a Cyrillic character on a French Windows installation), all CAST Java based executables will fail to load due to a limitation of the Java runtime environment.
	If you are facing issues installing AIP Core, you may consider temporarily disabling any anti-virus running on the host server. In some situations, anti-virus can interfere with the installation process and cause it not to complete.

Interactive installation process

Right click the setup.bat file located in the folder created when unzipping the installation media:

Choose Run as Administrator in the contextual menu (elevated privileges are required even if your Windows user login is part of an "Administrators" group). Click Next and then read and accept the License Agreement and then choose a location for AIP Core - the setup will suggest: %PROGRAMFILES%\CAST\<version>:

The setup will now offer you the opportunity to configure locations for various log, temporary and miscellaneous files. CAST highly recommends leaving these paths at their default: the locations can then be configured once the setup has completed.

Click Next. A screen will then be displayed summarizing your choices:

The installation process will then start on clicking Next. When complete, the setup will offer to launch CAST Server Manager - please untick "Launch Server Manager" since this is component is not required:

Silent installation process

If you need to install AIP Core on a number of servers (i.e. AIP Nodes) in exactly the same way, you may consider the possibility of automating this process using the command-line parameters of the setup installer. This will launch the setup installer unattended. This method requires you to perform the installation you require on one target server and then output the selected options to an answer file (setup.iss) which is then reused in subsequent automated installations.

First choose an AIP Node and open the Command Prompt (cmd). Change the folder and/or directory and/or drive to that containing the AIP Core setup.exe file (this is located in the "data" folder that is created from the AIP Core zip file):

Then run the setup.exe using the option -r as follows - change the example path given below to a folder in which you would like to store the answer file (setup.iss) - for example a network share. Note that this folder must already exist before running the command:

setup.exe /r /f1"n:\temp\setup.iss"

This will launch the setup as normal. Run through the installation that you require.

Once the initial setup process has completed, an "answer" file named setup.iss will be created at the location specified in the command line (in this example, this is n:\temp\setup.iss, which is a network location). This file contains all the parameters necessary to install AIP Core in exactly the same way as you have just done.

Now move onto the next AIP Node. Open the Command Prompt, move to the required location (where the AIP Core has been stored) and enter:

setup.exe /s /f1"n:\temp\setup.iss" /f2"c:\path\to\log.txt"

The setup will open and run the installation unattended using the parameters saved to the setup.iss file on the network - you will not need to intervene to move on through the various steps. The setup parameters will be identical to those defined in the first setup carried out on the first AIP Node and saved in the setup.iss file. A log file will be created with the name and location of your choice to help debug errors that may occur.

You will notice the setup install process running on the server's task bar for the duration of the operation. When completed, the setup will close automatically.

Log message codes

• 0 Success
• -1 General error
• -2 Invalid mode
• -3 Required data not found in the Setup.iss file
• -4 Not enough memory available
• -5 File does not exist
• -6 Cannot write to the response file
• -7 Unable to write to the log file
• -8 Invalid path to the InstallShield Silent response file
• -9 Not a valid list type (string or number)
• -10 Data type is invalid
• -11 Unknown error during setup
• -12 Dialogs are out of order
• -51 Cannot create the specified folder
• -52 Cannot access the specified file or folder
• -53 Invalid option selected

What is installed?

Files

On completion of the installation, all files related to AIP Core are stored in:

%PROGRAMFILES%\CAST\<version>
%PROGRAMDATA%\CAST\CAST\<version>
%APPDATA%\CAST\CAST\<version>

Installed third-party software

Visual C++ Redistributable Packages

≥ 8.3.53

• Visual C++ 64-bit Redistributable Packages for Visual Studio 2015-2022
• Visual C++ 32-bit Redistributable Packages for Visual Studio 2015-2022
• Visual C++ 64-bit Redistributable Packages for Visual Studio 2013
• Visual C++ 32-bit Redistributable Packages for Visual Studio 2013
• Microsoft Build Tools 2015 (BuildTools_Full.exe)

8.3.0 - 8.3.52

• Visual C++ 64-bit Redistributable Packages for Visual Studio 2017
• Visual C++ 64-bit Redistributable Packages for Visual Studio 2013
• Visual C++ 32-bit Redistributable Packages for Visual Studio 2013
• Visual C++ 64-bit Redistributable Packages for Visual Studio 2010
• Microsoft Build Tools 2015 (BuildTools_Full.exe)

.NET Framework

≥ 8.3.29:

• 4.7.2

8.3.14 - 8.3.28

• 4.7.1

8.3.0 - 8.3.13

• 4.5.2