On this page:

Target audience:

CAST AI Administrators

Summary: This section describes how to install and configure the CAST Application Analytics Dashboard - used for high level investigation of aggregated data generated during the analysis/snapshot generation process.

Introduction

How many CAST Application Analytics Dashboards do I need?

CAST highly recommends that you install one CAST Application Analytics Dashboard to display snapshot data from all your Applications whether they are stored in one or multiple Dashboard Services. When configuring the CAST Application Analytics Dashboard, you should therefore:

Note that:

  • the CAST Application Analytics Dashboard can officially support the upload of a maximum of 200 applications. CAST recommends that you choose only the most critical applications from the business view point - i.e the applications that need to be monitored with high visibility by CIOs and managers. If you need to upload more than 200 applications, please see Configuring the CAST Application Analytics Dashboard for large numbers of Applications (this information is equally valid for uploading below 200 Applications).
  • "authorizations" can help separate Application data if you have users that are only authorised to access data from specific Applications - see CAST-AAD - Configuring data authorization.

Standalone or combined WAR file?

CAST provides the CAST Application Analytics Dashboard in a WAR file that must be deployed to a compatible Application Server (see Supported Platforms for information about Application Server support). However, CAST provides two WAR files that contain the CAST Application Analytics Dashboard, as follows:

WAR file nameDescription
CAST-AAD.warTraditional "standalone" WAR file containing only the CAST Application Analytics Dashboard (and also the CAST Rest API interface). This document describes the installation using this WAR file.
CAST-AAD-AED.war"Combined" WAR file containing both the CAST Application Analytics Dashboard and the CAST Application Engineering Dashboard (plus the CAST Rest API interface).

You are free to use whichever WAR file you prefer to deploy the CAST Application Analytics Dashboard (the requirements and prerequisites are identical for both WAR files), however if you are using both the CAST Application Analytics and CAST Application Engineering Dashboard, to fulfil (for example) a "risk and quality" use case, then it would make sense to take advantage of the combined CAST-AAD-AED.war file and deploy both dashboards from the same WAR file. If you do so, please note the following about using the "combined" WAR file:

Image 1 - Welcome page

Image 2 - Return to welcome page URL


Requirements

Installing the CAST Application Analytics Dashboard (CAST AAD) requires the following:

(tick)

Java JRE

Must be installed on the machine that will host the Application Server. Please see Supported Platforms about JRE support.

(tick)

Application Server

Must be installed on a compatible machine. Please see Supported Platforms about Application Server support.

(tick)

Web browser

Required for accessing the CAST Application Analytics Dashboard. Please see Supported Platforms about Web Browser compatibility.

(tick)

Measurement Service

A dedicated schema (the CAST Measurement Service) on a CAST Storage Service 2.

To ensure compatibility you must only use a Measurement Service installed with a version of CAST AIP that exactly matches the major, minor or Service Pack release number of the CAST AAD WAR that you are installing.

  • No other RDBMS is supported for the Measurement Service.
  • You may need to install a standalone Measurement Service on a CAST Storage Service 2 (see Install CAST schemas) for example:
    1. you have installed only a "triplet" of CAST schemas (i.e. Management/Analysis/Dashboard Services)
    2. you have migrated from a previous version of CAST AIP where CAST Measurement Services were not in use (typically CAST AIP 7.0.x)
    3. your Management/Analysis/Dashboard Services are installed on Microsoft SQL Server / Oracle Server (which do NOT support the installation of a Measurement Service)
    4. you want to install multiple CAST Application Analytics Dashboards
  • Measurement Services can be Active for multiple Management Services (and thus data from multiple Dashboard Services can be aggregated in one Measurement Service).
(tick)Dashboard Service(s)

You can consolidate data into the Measurement Service from any number of Dashboard Service schemas (subject to the limit of 200 applications). The following Dashboard Services are supported:

CAST Dashboard Services

AIP releaseSupported
8.2.x(tick)
8.1.x(tick)
8.0.x(tick)
7.3.x(tick)
7.2.x(tick)
7.1.x(tick)
7.0.x(tick)

Host CSS/RDBMS

(tick)

WAR file

The CAST Application Analytics Dashboard is provided as a .WAR file (CAST-AAD.war) - it can be retrieved from the WARS folder located in the CAST installation folder:

Pre-installation check list

Before beginning the installation process, please ensure that you have carried out all of the following tasks and that the following requirements have been met:

(tick)

Ensure you have read all Release Notes accompanying CAST products for any last-minute information.

(tick)

Decide where the CAST Application Analytics Dashboard will be installed - CAST Administration workstation, separate dedicated machine or existing machine used for the CAST Engineering Dashboard/Discovery Portal/CAST AIC Portal.

(tick)

Ensure that your user login on the target machine has sufficient user privileges to install applications (see Appendix - CAST Administration workstation installation and hardware requirements)

(tick)

Make sure you have the required .WAR file ready for deployment

Installation procedure

This document assumes you are using Apache Tomcat in a Windows environment to host the CAST Application Analytics Dashboard. If you are using IBM Websphere Application Server in a Linux environment, please see Appendix - AAD - AED - RestAPI - Deployment on IBM WebSphere Application Server.

The installation process is divided into various steps:

Step 1: Deploy and configure the CAST-AAD.war file on your application server

Deploy the WAR file

Locate the CAST-AAD.war file and move it to the web application installation location. By default on Apache Tomcat this is set to:

%CATALINA_HOME%\webapps
%CATALINA_HOME%\webapps\CAST-AAD\META-INF\context.xml

Instructions for Tomcat 7

If you are using Tomcat 7 to host the CAST Application Analytics Dashboard, please follow these instructions:

<Resource name="jdbc/domains/AAD" url="jdbc:postgresql://localhost:2280/postgres"
    initConnectionSqls="SET search_path TO [Measure Schema];"
    username="operator" password="CastAIP" 

    auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
    validationQuery="select 1"
    initialSize="5" maxActive="20" maxIdle="10" maxWait="-1"/>
<Resource name="jdbc/domains/AAD" url="jdbc:postgresql://NEFYN:2280/postgres"
    initConnectionSqls="SET search_path TO V80_MEASURE_CSS2;"
    username="operator" password="CastAIP"

    auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
    validationQuery="select 1"
    initialSize="5" maxActive="20" maxIdle="10" maxWait="-1"/>

Note that:

  • when using the CAST Application Analytics Dashboard you MUST leave the name="jdbc/domains/AAD" as it is. Please do not change the domain "AAD" to anything else. The dashboard requires the domain to be set to AAD, otherwise you will receive errors when you try to login.
  • only ONE resource (named AAD) should be declared for a Measurement Service schema.
  • it is critically important to configure the initialSize, maxActive, and maxIdle parameters according to your consumption use case and the number of schemas you want to configure. The default values are high but could probably be decreased to limit the number of active connections to your database instance (eg. initialSize="2" maxActive="10" maxIdle="2"). Please see the "Optimize context.xml" section in Configuring the CAST Application Analytics Dashboard for large numbers of Applications for more information about these parameters, or consult the relevant Apache Tomcat documentation: https://tomcat.apache.org.

Instructions for Tomcat 8 and 8.5

If you are using Tomcat 8 or 8.5 to host the CAST Application Analytics Dashboard, please follow these instructions:

<Resource name="jdbc/domains/AAD" url="jdbc:postgresql://localhost:2280/postgres"
    initConnectionSqls="SET search_path TO [Measure Schema];"
    username="operator" password="CastAIP" 

    auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
    validationQuery="select 1"
    initialSize="5" maxActive="20" maxIdle="10" maxWait="-1"/>
<!--
<Resource name="jdbc/domains/AAD" url="jdbc:postgresql://localhost:2280/postgres"
    initConnectionSqls="SET search_path TO [Measure Schema];"
    username="operator" password="CastAIP" 

    auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
    validationQuery="select 1"
    initialSize="5" maxActive="20" maxIdle="10" maxWait="-1"/>
-->
<!--  For Tomcat 8 : http://tomcat.apache.org/tomcat-8.0-doc/jndi-datasource-examples-howto.html & http://commons.apache.org/proper/commons-dbcp/configuration.html

template for resources on CSS :
<Resource name="jdbc/domains/${domainName}" 
        url="jdbc:postgresql://${host}:${port}/postgres"
        connectionInitSqls="SET search_path TO ${schema};"
        username="${user}" password="${password}" 

        auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
        validationQuery="select 1" initialSize="5" maxTotal="20" maxIdle="10" maxWaitMillis="-1"/>

template for resources on Oracle :            
<Resource name="jdbc/domains/{domainName}"
        url="jdbc:oracle:thin:@{server}:{port}:{instance}"
        connectionInitSqls="ALTER SESSION SET CURRENT_SCHEMA={schema}"
        username="{user}"   password="{password}"

        auth="Container" type="javax.sql.DataSource" driverClassName="oracle.jdbc.OracleDriver"
        validationQuery="select 1 from DUAL" initialSize="5" maxTotal="20" maxIdle="10" maxWaitMillis="-1" />

template for resources on MS SQL Server :
<Resource name="jdbc/domains/{domainName}"
        url="jdbc:jtds:sqlserver://{host};instance={instance}"
        connectionInitSqls="use {database}"
        username="{user}" password="{password}"

        auth="Container" type="javax.sql.DataSource" driverClassName="net.sourceforge.jtds.jdbc.Driver"
        validationQuery="select 1" initialSize="5" maxTotal="20" maxIdle="10" maxWaitMillis="-1"/>
-->
<Resource name="jdbc/domains/${domainName}" 
        url="jdbc:postgresql://${host}:${port}/postgres"
        connectionInitSqls="SET search_path TO ${schema};"
        username="${user}" password="${password}" 

        auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
        validationQuery="select 1" initialSize="5" maxTotal="20" maxIdle="10" maxWaitMillis="-1"/>
<Resource name="jdbc/domains/AAD" 
        url="jdbc:postgresql://NEFYN:2280/postgres"
        connectionInitSqls="SET search_path TO V80_MEASURE_CSS2;"
        username="operator" password="CastAIP" 

        auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
        validationQuery="select 1" initialSize="5" maxTotal="20" maxIdle="10" maxWaitMillis="-1"/>

Note that:

  • when using the CAST Application Analytics Dashboard you MUST leave the name="jdbc/domains/AAD" as it is. Please do not change the domain "AAD" to anything else. The dashboard requires the domain to be set to AAD, otherwise you will receive errors when you try to login.
  • only ONE resource (named AAD) should be declared for a Measurement Service schema.
  • it is critically important to configure the initialSize, maxTotal and maxIdle parameters according to your consumption use case and the number of schemas you want to configure. The default values are high but could probably be decreased to limit the number of active connections to your database instance (eg. initialSize="2" maxActive="10" maxIdle="2"). Please see the "Optimize context.xml" section in Configuring the CAST Application Analytics Dashboard for large numbers of Applications for more information about these parameters, or consult the relevant Apache Tomcat documentation: https://tomcat.apache.org.

Test access to the CAST Application Analytics Dashboard

http://<server_name>:[<port_number>]/CAST-AAD

Error messages are documented in CAST-AAD-AED - Error Messages.

Step 2: Configure user authentication

Step 2 involves configuring how your users will authenticate with the CAST Application Analytics Dashboard. Most organizations opt for LDAP/Active Directory integration so that users can use their corporate username/password to access the resources they need. The CAST Application Analytics Dashboard also has a built in username/password authentication mechanism which is enabled "out of the box".

Please see Configuring user authentication for more information.

Step 3: upload snapshot data for display in AAD

Before your users can view any data in the CAST Application Analytics Dashboard, you need to upload your snapshot data once it has been generated (see Application Analysis and Measurement with CAST AIP for more information). The snapshot upload is achieved using the CAST Management Studio.

Note that the CAST Application Analytics Dashboard can officially support the upload of a maximum of 200 applications. CAST recommends that you choose only the most critical applications from the business view point - i.e the applications that need to be monitored with high visibility by CIOs and managers.

A - Activate the Measurement Service

Before you can upload snapshot data, you must ensure that the Measurement Service is Active for your current Management Service (i.e. the Management Service you are connected to in the CAST Management Studio). Measurement Services can be Active for multiple Management Services (and thus data from multiple Dashboard Services can be uploaded).

Installation of CAST AIP with Combined Install option

If:

...then a Measurement Service will have been installed alongside the Management, Analysis and Dashboard Services and will be visible in the Services view in the CAST Management Studio. In this case, the Measurement Service will already be Active and you do not need to do anything else:

Standalone Measurement Service

If:

you will have therefore installed a standalone Measurement Service on CSS2 in order to use the CAST Application Analytics Dashboard. In this scenario, you will need to activate this service before you do anything else:

B - Uploading snapshot data when the Measurement Service is active

When the Measurement Service is Active, there are two ways to upload snapshot data to the Measurement Service:

You can find out more information about these options in 2.2.3. Snapshot generation and validation.

Note also that the CAST Application Analytics Dashboard features a server cache to improve the speed of data display. This does mean, however, that very recent changes in data (i.e. a new snapshot generation) may not instantly appear in the dashboard. If this is the case, the server cache needs to be manually reloaded. See CAST-AAD-AED - Reload the cache.

Step 4: Configure data authorization

Step 4 involves configuring data Authorization. An authorization defines permission to a user or group of users to access and "consume the data" in a specific Application in the CAST Application Analytics Dashboard. If permission is not granted then any information related to this Application will be not accessible: application properties such as name, technologies or grades and measures, etc.Therefore, an Authorization must be defined before a user/group of users can access a specific application.

Please see Configuring data authorization for more information.

Additional information

You can find additional information about advanced configuration changes in CAST Application Analytics Dashboard such as:

You can find additional information about advanced security configuration changes for the CAST Application Analytics Dashboard, such as:

There is also additional information about implementing an enhanced security configuration for your application server in Common security configuration options for web application deployment: