Standalone dashboard - installation requirements

General requirements

Hardware

Please see CAST AIP for Dashboards - Hardware requirements for more information.

Supported Application Servers for WAR file deployment

Application ServerSupported for 1.x WARSupported for 2.x WARNotes

Apache Tomcat 7.0.x 64-bit (where x ≥ 20)

Apache Tomcat is supported when installed on either  Microsoft Windows or  Linux .
 

Note that:

  • Apache Tomcat 9.0.99 is required when using CAST Dashboards ≥ 2.12.8 and is not supported for older dashboards.
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
Apache Tomcat 10.1.x 64.bit

v. ≥ 2.13 only (required)

IBM WebSphere Application Server 8.5.xOnly 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:

Item1.x WAR2.x WAR
Servlet API3.03.1
Java88

Supported Operating Systems

For ZIP/JAR file deployment

Operating SystemSupported
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 / JDKSupported for 1.xSupported for 2.xNotes
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 . Minimum requirement for CAST Dashboards ≥ 2.13.x.

Supported Browsers

This section lists the browsers supported by CAST to connect to a dashboard:

BrowserSupportedDeprecated supportNotes
Microsoft Internet Explorer 9
Microsoft Internet Explorer 10
Microsoft Internet Explorer 11
Microsoft EdgeMinimum supported release: 40 and above
Mozilla FirefoxMinimum supported release: 52 and above
Google ChromeMinimum 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.

SoftwareRequiredNotes
Host Operating System

Microsoft Windows

Linux

  • Recommended Linux distributions:
    • all Linux distributions based on (or derived from) Red Hat

Third-party software required
for install on Docker (Linux and Windows)


Docker on Linux

When using the Docker Installer extension

  • Docker Engine ≥ 18.0
  • docker-compose latest stable release
  • curl

Docker on Microsoft Windows

  • Docker Desktop for Windows  - latest version recommended, or one that provides:
    • Docker Engine ≥ 19.03.5
    • docker-compose latest stable release
    • Hyper-V and WSL2 mode are both supported
    • Containers for Linux must be enabled

Note that when using Hyper-V mode for Docker Desktop only, the following must also be configured:

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:

Dashboard schema versionCompatible Engineering Dashboard
CAST AIP  ≥ 8.3.16

≥ 1.12.0 (standalone)

≥ 1.5.12 (WAR delivered with CAST AIP  ≥ 8.3.16)

CAST AIP  < 8.3.16

1.12.0 (standalone)

1.5.12 (WAR delivered with CAST AIP  < 8.3.16)

License KeyAccess 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 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 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 PostgreSQL instance.

Dashboard schemas

You can consolidate data into the Measurement schema as follows:

CAST Dashboard Services

AIP releaseSupported
8.3.x
8.2.x
8.1.x
8.0.x
7.3.x
7.2.x
7.1.x
7.0.x
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 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 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.

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 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 PostgreSQL instance to host it. The schema is created automatically when you start up your Dashboard deployment if it does not already exist.