Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

CAST provides the CAST Application Analytics Dashboard in a WAR file that  that must be deployed to a compatible Application Server (see see Supported Platforms for  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). This WAR was introduced in CAST AIP 8.0.x.

You are free to use use whichever WAR file you prefer to  to deploy the CAST Application Analytics Dashboard (the requirements and prerequisites are identical for both WAR files) - however, CAST highly recommends that you deploy , however if you are using both the CAST Application Analytics Dashboard from the "standalone" 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 as described in the rest of this document. This is primarily because:

  • Each dashboard (CAST Application Analytics and CAST Application Engineering) is aimed at different end users, therefore deploying the dashboards from separate standalone WAR files will isolate the the two use cases and the users of each dashboard - which is better from a security standpoint.
  • Deploying each dashboard from its own standalone WAR file will result in two distinct web applications deployed to the application server. This will improve performance and ensure that the target end users can access the data they require rapidly.

However, if your organization is also using the CAST Application Engineering Dashboard, you may want to take advantage of the CAST-AAD-AED.war file to deploy both dashboards from the same WAR file. If you do so, please note the following about using the "combined" WAR file:

...

 file and deploy both dashboards from the same WAR file. If you do so, please note the following about using the "combined" WAR file:

  • There is no need to specifically configure a URL for your CAST Application Engineering Dashboard drilldown (via the "microscope" icon)  - see 2.2.3. Snapshot generation and validation for more information: when using the combined "WAR" file, access to the CAST Application Engineering Dashboard from the CAST Application Analytics Dashboard is pre-configured.
  • Security access and authentication is common to both Dashboards. Therefore, if you setup Active Directory authentication in the web.xml file, then this must be used to access both Dashboards - you cannot use "Static List" for one Dashboard and "Active Directory" for the other.
  • Role configuration is common to both Dashboards. Therefore "UserA" that has been granted the "admin" role, will have the "admin" role in both Dashboards.
  • Data authorization is common to both Dashboards. Therefore if you authorize "UserA" to view Application "B" only via the authorizations.xml file, then this is true for both Dashboards. Note that authorizations based only on Tags and Categories created for the CAST Application Analytics Dashboard (Tags and Categories are a feature that is not available in the CAST Application Engineering Dashboard) WILL be applied in the CAST Application Engineering Dashboard when using the combined war file.
  • Group configuration is common to both Dashboards, regardless of the authentication mode in usethe other.
  • Role configuration is common to both Dashboards. Therefore "UserA" that has been granted the "admin" role, will have the "admin" role in both Dashboards.
  • Data authorization is common to both Dashboards. Therefore if you authorize "GroupDUserA"   to view Application "EB" only via the authorizations.xml file, then this is true for both Dashboards. There is no need to specifically configure a URL for your Note that authorizations based only on Tags and Categories created for the CAST Application Analytics Dashboard (Tags and Categories are a feature that is not available in the CAST Application Engineering Dashboard drilldown (via the "microscope" icon)  - see 2.2.3. Snapshot generation and validation for more information - when using the combined "WAR" file, access to the CAST Application Engineering Dashboard from the CAST Application Analytics Dashboard is pre-configured) WILL be applied in the CAST Application Engineering Dashboard when using the combined war file.
  • Group configuration is common to both Dashboards, regardless of the authentication mode in use. Therefore if you authorize "GroupD"  to view Application "E" only, then this is true for both Dashboards.
  • On login, the user will be presented with a choice of Dashboard as shown below (Image 1) in a "Welcome" page. Clicking Clicking Access will  will take the user to the custom login screen for the chosen Dashboard where a "Return to welcome page" URL is available if the user wishes to login to the other Dashboard (Image 2):

...

Image 2 - Return to welcome page URL


Requirements

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

...

(tick)

...

Must be installed on the machine that will host the Application Server. Please see:

...

(tick)

...

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

a compatible machine: Application Server support.
  • Appendix - Apache Tomcat - IBM Websphere - Java JDK-JRE installation and application server memory configuration for more information about installing this item.
  • Note that the application server can run on either the Linux or Windows operating systems (this document describes an installation in a Windows environment)

    (tick)

    Java JRE

    Must be installed on

    the machine that will host the Application Server. Please see

    Supported Platforms about

    Info

    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.

    Info
    • 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:

    ...

    Info
    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:

    ...