This documentation page is part of a legacy method of installing CAST AIP. This documentation is no longer maintained and may contain obsolete information. When using AIP Console, AIP schemas are installed automatically when creating an application. Refer to Installation and Configuration and Add a new Application.
On this page:
Target audience:
CAST AI Administrators
Summary: This section explains how to install the CAST AIP schemas. This equates to the installation of the CAST Management Service, CAST Analysis Service, CAST Dashboard Service and the CAST Measurement Service on the CAST Storage Service or on a commercially available and supported RDBMS (in this case this section also discusses any preparation that may be required for your particular RDBMS).
Whether you are installing the CAST AIP schemas on a CAST Storage Service/RDBMS located on the CAST Administration workstation or on a dedicated machine (see Deployment - sizing and security for more information), the installation process needs to be carried out on the CAST Administration workstation using the executable CAST Server Manager (servman.exe).
Installation preparation: requirements and configuration
CAST assumes that you have already installed either the CAST Storage Service or your chosen RDBMS on either the CAST Administration workstation, or on a dedicated machine that can be accessed by the CAST Administration workstation. This guide does not provide instructions on how to install a commercially available RDBMS, but does provide information about how the RDBMS can be configured for use with CAST. Please see Appendix - RDBMS requirements and configuration for more information about installation requirements and RDBMS configuration. It is imperative that this section is read thoroughly before you embark on the Storage item installation process.
Please note that the CAST Storage Service requires no configuration prior to installing the CAST AIP schemas. It is pre-configured ready for use.
CAST AIP schema installation locations
Before installing any of the CAST AIP schemas, you need to decide where you want to install them:
- On one single CAST Storage Service or RDBMS
- On multiple CAST Storage Services/RDBMS (one for each schema)
There are no limitations pertaining to the installation of all the CAST AIP schemas on the same CAST Storage Service/RDBMS, nor are there any limitations associated with having two or more identical CAST AIP schemas types on the same CAST Storage Service/RDBMS.
In some cases, for performance, network, usage or administration reasons, you may, however, want to distribute CAST AIP sites across multiple CAST Storage Services/RDBMS, unless you have already sized a dedicated Server powerful enough to handle all CAST AIP schemas. In this scenario and when you are specifically using multiple Microsoft SQL Servers to host your CAST AIP schemas, you must ensure that all CAST AIP schemas use the same collation across all host servers - see Appendix - RDBMS requirements and configuration for more information.
This guide explains how to install all CAST AIP schemas on one single CAST Storage Service/RDBMS.
CAST AIP schemas and Applications
CAST recommends that each Application you need to onboard and analyze with CAST AIP is configured to have sole use of a "triplet" of CAST AIP schemas as follows:
Application 1 uses:
- Management Service A
- Analysis Service A
- Dashboard Service A
If you need to analyze any additional Applications, CAST recommends that for each additional Application you install a new additional "triplet" of CAST AIP schemas:
Application 2 uses:
- Management Service B
- Analysis Service B
- Dashboard Service B
With regard to Measurement Services that are required for the Health Dashboard, you can choose to:
- Consolidate all Applications (regardless of whether their snapshot data is stored in multiple CAST Dashboard Services) in one Measurement Service - in this way, snapshot data from all Applications will be visible in one Health Dashboard
- Consolidate each Application in a separate Measurement Service and Health Dashboard - this ensures that Application snapshot data is segregated.
Example setup
One example setup (when using the CAST Storage Service) would be to:
- install all four CAST AIP schemas in one go (see below) and onboard the first Application
- install a "triplet" of CAST AIP schemas in one go (see below) for each additional Application you want to onboard. Snapshot data from these Applications can be consolidated:
- in the Measurement Service installed initially for the first Application (snapshot data for all Applications is consulted through one single Health Dashboard)
- or can be consolidated in additional standalone Measurement Services (snapshot data is segregated and is consulted for each Application through a dedicated Health Dashboard for that Application)
CAST AIP extensions
CAST provides support for a variety of technologies through what are known as "extensions". An extension is a generic term for any kind of distinct addition to CAST AIP which can be downloaded, installed and upgraded separately. Extensions provided by CAST can provide support for the analysis of technologies such as PHP or the extraction of code from a Git repository, for example.
Extensions require installation and this can be done in two ways:
- During the installation of your CAST AIP schemas
- After your CAST AIP schemas have been installed
If you would like to install the extension during the installation of your CAST AIP schemas, you must ensure that you have downloaded the required extension already. Please refer to Download your CAST AIP Extensions for more information about this.
Note that in CAST AIP 8.3.x, several official CAST AIP extensions are shipped with the setup and are installed by default with all new CAST AIP triplets. These will ALWAYS be installed and it is not possible to "unselect" them:
Technical note:
These extensions are shipped in a folder in the CAST AIP installation folder called shipped_extensions. During the CAST AIP installation process (i.e. when the installer is run), the content of this folder is synchronized with %PROGRAMDATA%\CAST\CAST\Extensions (the folder in which previously downloaded extensions are stored on the local machine):
- If the same extension version is already present in %PROGRAMDATA%\CAST\CAST\Extensions then nothing is done
- otherwise, the extension is copied across
Pre-installation check list
Before beginning the CAST AIP schema installation process, please ensure that you have carried out all of the following tasks and that the following requirements have been met:
Ensure you have read all Release Notes accompanying CAST products for any last-minute information | |
Ensure that the machine to be used to host the CAST Storage item (either the CAST Administration workstation or a dedicated machine) meets all hardware and operating system requirements (see Appendix - CAST Administration workstation installation and hardware requirements) | |
If using a commercially available RDBMS (instead of the CAST Storage Service):
| |
If the CAST Storage Service or RDBMS is installed on a remote dedicated machine:
| |
Decide whether you want to install the CAST AIP schemas in existing schemas or in new schemas - this guide assumes that you will install them in new schemas. Note that you CANNOT use the installation options that install multiple schemas in one go to install to existing schemas. |
CAST Server Manager
To start the CAST AIP schema installation process, launch the CAST Server Manager executable (servman.exe) on the CAST Administration workstation.
Connection
When you first launch CAST Server Manager, depending on your environment and previous installation choices, one of two things will happen:
CAST Storage Service installed on CAST Administration workstation with the current version of the Windows installer | A connection profile to the CAST Storage Service is automatically created during the CAST AIP installation process (see Install CAST AIP from setup) and can be selected in the Open Server Connection dialog box (see below). |
RDBMS installed on CAST Administration workstation | No connection profile is automatically created - you need to create your own connection profile (see below). |
CAST Storage Service or RDBMS installed on remote dedicated machine | |
CAST Storage Service installed with previous version of CAST AIP |
Using the auto created profile for CAST Storage Service
If a connection profile to the CAST Storage Service is automatically created, when you launch CAST Server Manager, the connection profile is then offered to you in the Open Server Connection Profile dialog box so that you can immediately connect to install the CAST AIP schemas:
- Select the profile and click the Open button.
- Once the connection is established, you can then proceed with the installation of the CAST AIP schemas
Manually creating a connection profile for CAST Storage Service and other RDBMS
If the CAST Storage Service is installed on a remote machine, or you are using a commercially available and supported RDBMS to host the CAST AIP schemas (whether on the CAST Administration workstation or on a dedicated machine), you will need to manually create a connection profile for the target CAST Storage Service/RDBMS which will host the CAST AIP schemas.
When launching CAST Server Manager, you will be prompted that no connection profiles exist - click Yes to continue:
- In the Add Server Connection Profile dialog box, insert the required connection parameters (ensuring that you chose the correct "Server type"):
- Click Test to test the profile and then OK to save it.
- Use this profile to establish a connection (use the Open button in the Open Server Connection dialog box) to the CAST Storage Service/RDBMS:
- When a connection is established, you can then proceed with the installation of the CAST AIP schemas.
- For Microsoft SQL Server (whatever your network architecture):
- you may first need to create a 64-bit ODBC entry on the CAST Administration workstation for this particular server type.
- when creating a 64-bit ODBC entry, please do not create an alias for your Microsoft SQL Server and then use that alias in the CAST Server Manager Connection Profile (the installation will fail)
- For Oracle Server(if the RDBMS is located on a dedicated machine separate from the machine used to host the CAST Administration workstation):
- You may need to install a compatible 64-bit client connection layer on the CAST Administration workstation (see the Release Notes for a list of compatible client connection layers).
- Now select Schema/Database Installation from the Schema/Database Installation menu:
Microsoft SQL Server | CAST Storage Service/Oracle Server |
---|---|
- The CAST Base Installation dialog box will then be displayed (this dialog box enables you to choose what type of installation operation you want to carry out with CAST Server Manager). The options available in this dialog box are explained below.
Available installation options
Left column options | Right column options | What is installed? | When should I choose this option? |
---|---|---|---|
Initial platform base(s) installation | Application Analytics platform installation | This is a Combined Installation. All four CAST AIP schemas are installed automatically with the following suffixes:
| Choose this option if you are installing CAST AIP from scratch and require access to all functionality (and have appropriate licensing to do so). Note this option is ONLY available if you are using the CAST Storage Service as your chosen storage host. This is because the Measurement Service can only be installed on a CAST Storage Service. |
Additional Analysis platform | This is a Combined Installation. Three CAST AIP schemas are installed automatically with the following suffixes:
| Choose this option if:
| |
CAST-MS only | Only the Management Service schema is installed. You are free to choose the name of the schema. | Choose this option only if you require an additional Management Service, i.e. for situations where you are distributing the CAST AIP schemas across multiple host CAST Storage Services/RDBMS. | |
| N/A | One additional CAST AIP schema is installed. | Choose these options only if you require additional Analysis, Dashboard or Measurement Services, i.e. for situations where you are distributing the CAST AIP schemas across multiple host CAST Storage Services/RDBMS, or where you are migrating from a previous version that did not include the specific schema. Note that the Additional Measurement Base option is ONLY available if you are using the CAST Storage Service as your chosen storage host. This is because the Measurement Service can only be installed on a CAST Storage Service. |
Combined installation
If you are starting from scratch, CAST recommends that you use the Application Analytics platform or Additional Analysis Platform installation options - this will install all required CAST AIP schemas in one go - i.e. a Combined Installation.
- In CAST Server Manager, select Schema/Database Installation from the Schema/Database Installation menu:
Microsoft SQL Server | CAST Storage Service/Oracle Server |
---|---|
- The CAST Base Installation dialog box will then be displayed. You should select Initial platform base(s) installation in the left hand section and either the Application Analytics platform or the Additional Analysis Platform installation option (depending on your requirement and the type of RDBMS/CSS you are using to host the CAST AIP schemas) in the right hand section, then click Next.
- The Extension Selection dialog box will then be displayed. This dialog box allows you to select and install CAST extensions at the same time as you install your CAST schemas. Select the extensions you want to install (note that selecting one extension may automatically select other extensions for installation if the extension you selected has dependent extensions). If you do not want to install an extension at this time, ensure that Do not install is displayed for all extensions in the Version column. Click Next to continue.
Note that in CAST AIP 8.3.x, several official CAST AIP extensions are shipped with the setup and are installed by default with all new CAST AIP triplets. It is not possible to deactivate their installation:
- The Schema/Database Creation dialog box will then be displayed. This dialog box will prompt you to enter a prefix that will be applied to the name of all new database/schemas that will be created during the installation process. The resulting schemas will take the form:
- <prefix>_MNGT > Management Service
- <prefix>_LOCAL > Analysis Service
- <prefix>_CENTRAL > Dashboard Service
- <prefix>_MEASURE > Measurement Service (only for the Application Analytics platform installation option)
Password
If you are performing the installation on an Oracle Server, then you will also need to input a password. This password is associated with the user that owns the schemas you are about to create (the user and the schema have the same name). You will be prompted for it for each schema that is installed. The User Password option does not exist on other server types.
Naming convention requirements
For all server types please note the following CAST requirements:
- the name must be in upper case
- the following characters are authorized: 0-9, A-Z and _ (underscore)
- RDBMS specific naming rules also apply - please see the documentation for your specific RDBMS for more information.
- Click Next to continue. The next step involves defining installation configuration settings for the schemas that will be created. Depending on the type of server you are connected to, the process will differ. This process is described in more detail in Appendix - CAST database - creation and configuration options.
- A dialog box displaying a summary of the proposed installation will then be displayed. Click Proceed to start the component installation:
- A dialog box will inform you of installation progress:
- When all operations have been successfully completed, CAST Server Manager will display the newly installed schemas together under the Combined Installations (Up-to-date) node as shown below. The Measurement Service will be visible under the Measurement Services node (the Measurement Service will not be visible if you selected the Additional Analysis platform installation option):
During the installation process, CAST Server Manager will automatically create a connection profile to the CAST Management Studio schema (<prefix>_MNGT). This connection profile is stored in a proprietary XML file on the hard drive of the CAST Administration workstation. When you launch the CAST Management Studio, this connection profile will automatically be displayed for use (you will need to validate it first).
Standalone installation
CAST enables you to install any of the CAST AIP schemas in standalone mode - i.e. on their own without any other CAST AIP schemas. The most common situation in which this is required is where you are distributing the CAST AIP schemas across multiple host CAST Storage Services/RDBMS - you can install each CAST AIP schema on its own.
To do so:
- In CAST Server Manager, select Schema/Database Installation from the Schema/Database Installation menu:
Microsoft SQL Server | CAST Storage Service/Oracle Server |
---|---|
- The CAST Base Installation dialog box will then be displayed.
- Follow the instructions below depending on the CAST AIP schema you want to install.
Standalone Management Service | Standalone Analysis, Dashboard or Measurement Service |
---|---|
To install a standalone Management Service:
| To install a standalone Analysis, Dashboard or Measurement Service:
|
- The Extension Selection dialog box will then be displayed. This dialog box allows you to select and install CAST AIP extensions at the same time as you install your CAST AIP schema. Select the extensions you want to install (note that selecting one extension may automatically select other extensions for installation if the extension you selected has dependent extensions). If you do not want to install an extension at this time, ensure that Do not install is displayed for all extensions in the Version column. An extension MUST be installed in a Management, Analysis and Dashboard Service for it to function correctly. In other words, if you are installing a standalone Analysis Service and have selected an extension for installation, then you also need to install the same version of that extension to any Management or Dashboard Services you will be using with the current standalone Analysis Service - for this reason, CAST highly recommends that you use the Combined Installation option instead, as described above.
Note that in CAST AIP 8.3.x, several official CAST AIP extensions are shipped with the setup and are installed by default with all new CAST AIP combined installations. It is not possible to deactivate their installation:
- Click Next and enter a name for the schema (the same Password for Oracle host servers and Naming convention requirements as discussed in the Combined Installation section (above) are valid).
- Click Next to continue. The next step involves defining installation configuration settings for the schema that will be created. Depending on the type of server you are connected to, the process will differ. This process is described in more detail in Appendix - CAST database - creation and configuration options.
- A dialog box displaying a summary of the proposed installation will then be displayed. Click Proceed to start the component installation.
- When all operations have been successfully completed, CAST Server Manager will display the newly installed schema under Unmanaged Services and it can be used immediately:
If you choose to install a standalone Management Service, CAST Server Manager will automatically create a connection profile to it. This connection profile is stored in a proprietary XML file on the hard drive of the CAST Administration workstation. When you launch the CAST Management Studio, this connection profile will automatically be displayed for use (you will need to validate it first).