Summary: This section describes the upgrade process for the integrated CAST RESTAPI when using the Dashboards embedded in AIP Console. CAST highly recommends upgrading this file when upgrading to a new release of the AIP Console/AIP Node packages.
- If you are not using the Dashboards embedded in AIP Console, this step is not required. Instead, please see Standalone Dashboard upgrade.
- You must always use the cast-integrated-health-engineering-dashboard-<version>.zip / CAST-RESTAPI-integrated.war file provided with the current release of AIP Console.
Upgrading from CAST-RestAPI-integrated.war to cast-integrated-health-engineering-dashboard.zip
In AIP Console ≥ 1.25, the existing CAST-RestAPI-integrated.war has been replaced with the cast-integrated-health-engineering-dashboard.zip file. Fundamentally, this means that:
- Apache Tomcat is no longer required to host the .war file, instead the .zip file is bootable (a web application is included within it).
- AIP Console ≥ 1.25 will no longer function with a CAST-RestAPI-integrated.war provided with a previous release of AIP Console, therefore, those upgrading to AIP Console ≥ 1.25 and using embedded Dashboards, must use the cast-integrated-health-engineering-dashboard.zip
Step 1 - Ensure Apache Tomcat is stopped
Before starting, ensure that Apache Tomcat is not running.
Step 2 - Deploy the cast-integrated-health-engineering-dashboard.zip and start it up
The cast-integrated-health-engineering-dashboard-<version>.zip is provided in the installation media .ZIP file (alongside the .JAR installer for the AIP Console) and is partly pre-configured for use with the CAST AIP Console. Locate the file and move it to a suitable location - it can be run from anywhere.
See Embedded CAST Dashboard deployment process for more details about how to proceed.
Step 3 - Check configuration details in AIP Console admin center
Ensure you check that the configuration details in Administration Center - Settings - Dashboard Integration are correct. In particular the URL to the newly deployed .zip file may have changed.
Step 4 - Check access to CAST Dashboards from AIP Console
Browse to your AIP Console URL http://<server>:8081/ui/index.html
, login to AIP Console and check that you can access the Engineering and Health Dashboards via the options:
Step 5 - Undeploy the existing WAR file
Undeploy the existing CAST-RESTAPI-integrated.war file from Apache Tomcat - you can use Apache Tomcat manager to do this, or simply delete the relevant folder and file in CATALINA_HOME\webapps
.
Upgrading between CAST-RestAPI-integrated.war file - AIP Console ≤ 1.24
Step 1 - Ensure Apache Tomcat is stopped
Before starting, ensure that Apache Tomcat is not running.
Step 2 - Deploy the new CAST-RESTAPI-integrated.war
Obtain the new CAST-RESTAPI-integrated.war file from the AIP Console media and rename it so that you can deploy it alongside the existing CAST-RESTAPI-integrated.war file, for example to CAST-RESTAPI-integrated_new.war. Now unzip the CAST-RESTAPI-integrated_new.war to the following location:
CATALINA_HOME\webapps
This should give you the following file hierarchy:
Step 3 - Copy and paste files from existing WAR file into the new WAR file
Copy the following files from the existing WAR file:
CATALINA_HOME\webapps\CAST-RESTAPI-integrated\META-INF\context.xml CATALINA_HOME\webapps\CAST-RESTAPI-integrated\WEB-INF\license.key CATALINA_HOME\webapps\CAST-RESTAPI-integrated\WEB-INF\domains.properties
And paste them in to the relevant location in the new WAR file, overwriting the existing files if they exist:
CATALINA_HOME\webapps\CAST-RESTAPI-integrated_new\META-INF\context.xml CATALINA_HOME\webapps\CAST-RESTAPI-integrated_new\WEB-INF\license.key CATALINA_HOME\webapps\CAST-RESTAPI-integrated_new\WEB-INF\domains.properties
Step 4 - Undeploy the existing WAR file
Undeploy the existing CAST-RESTAPI-integrated.war file from Apache Tomcat - you can use Apache Tomcat manager to do this, or simply delete the relevant folder and file in CATALINA_HOME\webapps
.
Step 5 - Rename the new WAR file and corresponding folder
Rename the new WAR file and its corresponding folder to match the name used by the previous WAR file:
Step 6 - Restart Apache Tomcat
Restart Apache Tomcat and ensure that the CAST-RESTAPI-integrated webapp has started correctly using Apache Tomcat manager:
Step 7 - Check access to CAST Dashboards from AIP Console
Browse to your AIP Console URL http://<server>:8081/ui/index.html
, login to AIP Console and check that you can access the Engineering and Health Dashboards via the options:
Troubleshooting
Cannot access the Dashboards post upgrade
Check that:
- the settings are correct in Administration Center - Settings - Dashboard Integration
the settings in the CAST-RESTAPI-integrated.war file are as described in Install CAST Dashboards - existing customers