General requirements
Hardware
Please see CAST AIP for Dashboards - Hardware requirements for more information.
Supported Application Servers for WAR file deployment
| Application Server | Supported for 1.x WAR | Supported for 2.x WAR | Notes |
|---|---|---|---|
Apache Tomcat 7.0.x 64-bit (where x ≥ 20) |  |  | Apache Tomcat is supported when installed on either Microsoft Windows or Linux. |
| Apache Tomcat 8.0.x 64-bit | | | |
| Apache Tomcat 8.5.x 64-bit | | | |
| Apache Tomcat 9.0.x 64-bit | v. ≥ 1.17 only | | |
| IBM WebSphere Application Server 8.5.x | | | Only supported when installed on a Linux Operating System - see Deployment on IBM WebSphere Application Server. |
The CAST Dashboards are developed using the following Java specifications. This information will help you decide whether the web applications will function on an application server other than Apache Tomcat/IBM WebSphere Application Server:
| Item | 1.x WAR | 2.x WAR |
|---|---|---|
| Servlet API | 3.0 | 3.1 |
| Java | 8 | 8 |
Supported Operating Systems
For ZIP/JAR file deployment
| Operating System | Supported |
|---|---|
| Microsoft Windows 2022 | |
| Microsoft Windows 10 Pro | |
| CentOS 7.4 | |
For WAR file deployment
Supported operating systems are those supported by the application server, typically Apache Tomcat.
Supported Java JRE/JDK
Whether you are installing CAST Dashboards using a WAR file for Apache Tomcat, or direct using the ZIP/JAR installations, a Java JRE or JDK must be installed on the host server. CAST only supports LTS releases as follows:
| Java JRE / JDK | Supported for 1.x | Supported for 2.x | Notes |
|---|---|---|---|
| 8 (LTS) | | | - |
| 9 | | | - |
| 10 | | | - |
| 11 (LTS) | | | Only supported for CAST Dashboards ≥ 2.6.1 due to compatibility issues with the Lucene indexing system used in the Engineering Dashboard Advanced Search feature (see Managing the Engineering Dashboard search indexes). |
| 17 (LTS) | | | Only supported for CAST Dashboards ≥ 2.11.1. |
A JAVA_HOME system environment variable is required and should be created automatically when the Java JRE is installed, but please ensure that this exists.
Supported Browsers
This section lists the browsers supported by CAST to connect to a dashboard:
| Browser | Supported | Deprecated support | Notes |
|---|---|---|---|
| Microsoft Internet Explorer 9 | | ||
| Microsoft Internet Explorer 10 | | ||
| Microsoft Internet Explorer 11 | | ||
| Microsoft Edge | | Minimum supported release: 40 and above | |
Mozilla Firefox | | Minimum supported release: 52 and above | |
| Google Chrome | | Minimum supported release: most recent only | |
| Safari (iOS 10) | | Only supported for the Health Dashboard |
Deployment on Docker (Microsoft Windows or Linux)
See Standalone Dashboards for Docker deployment.
| Software | Required | Notes |
|---|---|---|
| Host Operating System | | Microsoft Windows
Linux
|
Third-party software required | | Docker on Linux When using the Docker Installer extension
|
Docker on Microsoft Windows
Note that when using Hyper-V mode for Docker Desktop only, the following must also be configured:
When using WSL2 mode, these changes are not required. Docker Desktop will automatically manage RAM memory and file sharing. |
Engineering Dashboard requirements
| Java JRE/JDK | See Supported Java JRE/JDK above. | ||||||
| Application Server | Only required when deploying a WAR file: must be installed on a compatible machine. See Supported Application Servers for WAR file deployment above. | ||||||
| Web browser | Required for accessing the Engineering Dashboard. | ||||||
| Dashboard schema | You can connect the Engineering Dashboard to one or multiple Dashboard schemas as follows:
Each Dashboard schema must contain at least one snapshot. | ||||||
| License Key | Access to data in the Dashboard schema is governed by a license key - see Dashboard Service license key configuration. You must have a valid license key in your possession before you begin. | ||||||
| Roles/authorizations schema | Required only in ≥ 2.1.0-funcrel In ≥ 2.1 only, an interface exists to manage User roles - 2.x and above and Data authorization - 2.x and above - this interface stores all its records in a dedicated schema on a CAST Storage Service/PostgreSQL instance. This instance does not need to be the same as used for your AIP schemas (Dashboard/Measure schemas), however, the required schema is small and therefore CAST recommends using an existing CAST Storage Service/PostgreSQL instance to host it. The schema is created automatically when you start up your Dashboard deployment if it does not already exist. |
Health Dashboard requirements
| Java JRE | See Supported Java JRE/JDK above. | ||||||||||||||||||
| Application Server | Only required when deploying a WAR file: must be installed on a compatible machine. See Supported Application Servers for WAR file deployment above. | ||||||||||||||||||
| Web browser | Required for accessing the Health Dashboard. | ||||||||||||||||||
| Measurement schema | A dedicated schema (the CAST Measurement Service) on a CAST Storage Service/PostgreSQL instance. | ||||||||||||||||||
| Dashboard schemas | You can consolidate data into the Measurement schema as follows:
CAST Dashboard Services
| ||||||||||||||||||
| Roles/authorizations schema | Required only in ≥ 2.1.0-funcrel In ≥ 2.1 only, an interface exists to manage User roles - 2.x and above and Data authorization - 2.x and above - this interface stores all its records in a dedicated schema on a CAST Storage Service/PostgreSQL instance. This instance does not need to be the same as used for your AIP schemas (Dashboard/Measure schemas), however, the required schema is small and therefore CAST recommends using an existing CAST Storage Service/PostgreSQL instance to host it. The schema is created automatically when you start up your Dashboard deployment if it does not already exist. |
CAST-RESTAPI requirements
| Java JRE | See Supported Java JRE/JDK above. |
| Application Server | Only required when deploying a WAR file: must be installed on a compatible machine. See Supported Application Servers for WAR file deployment above. |
| Dashboard schema / Measurement schema | A single Dashboard schema or Measurement schema or multiple Dashboard / Measurement schemas. When using the CAST-RestAPI with CAST Report Generator, CAST highly recommends configuring connections to the CAST Dashboard Service ONLY. |
| License Key | Access to data in the Dashboard schema is governed by a license key - see Dashboard Service license key configuration. You must have a valid license key in your possession before you begin. |
| Roles/authorizations schema | Required only in ≥ 2.1.0-funcrel In ≥ 2.1 only, an interface exists to manage User roles - 2.x and above and Data authorization - 2.x and above - this interface stores all its records in a dedicated schema on a CAST Storage Service/PostgreSQL instance. This instance does not need to be the same as used for your AIP schemas (Dashboard/Measure schemas), however, the required schema is small and therefore CAST recommends using an existing CAST Storage Service/PostgreSQL instance to host it. The schema is created automatically when you start up your Dashboard deployment if it does not already exist. |
