This information is only valid for CAST Dashboard ≥ 2.x when using a ZIP file deployment (i.e. without Apache Tomcat).

Introduction

The following situations require some small changes to the Dashboard deployment process so that each Dashboard deployment does not conflict with another:

Required changes

Step 1 - Change the port on which the Dashboard is running

By default the ZIP Dashboards are preconfigured to run on the following ports to accept incoming connections:

Standalone dashboards8080
Embedded dashboards8087

If you want to run multiple ZIPs on the same server, you must ensure that each Dashboard uses a unique port. You can change the port in the following file:

<unpacked_zip>\configurations\application.properties

Locate the following lines in the file:

Standalone dashboards

# Configure server port. This is necessary only for the .jar mode/version
# server.port=8080

Embedded dashboards

# Configure server port. This is necessary only for the .jar mode/version
server.port=8087

Uncomment the server.port line (standalone dashboards only), modify the port number and save the file:

# Default Port
server.port=8090

Restart the application to ensure the changes are taken into account.

If you change the port number for your embedded dashboards, you will need to update the configuration in AIP Console, see Administration Center - Settings - Dashboard Integration:

Step 2 - Change Microsoft Windows service name

If you are deploying the dashboards on Microsoft Windows and you intend to run them via a Microsoft Windows service, you must make some changes BEFORE you install the services so that each service is unique. For each service that you want to install, perform the following actions:

Modify the dashboard-service-install.bat file

Open the following file with a text editor:

<unpacked_zip>\dashboard-service-install.bat

Change the following lines to something unique, for example, add a digit for each dashboard:

set SERVICE_NAME=dashboard-service
set DISPLAY_NAME="CAST Dashboard Service"
set DESCRIPTION="CAST Dashboard Service"

E.g.:

set SERVICE_NAME=dashboard-service-1
set DISPLAY_NAME="CAST Dashboard Service 1"
set DESCRIPTION="CAST Dashboard Service 1"

Save the file.

Rename the .exe files to match SERVICE_NAME

Now rename the following .exe files to match EXACTLY the name you chose for SERVICE_NAME in dashboard-service-install.bat:

<unpacked_zip>\dashboard-service.exe
<unpacked_zip>\dashboard-servicew.exe
<unpacked_zip>\amd64\dashboard-service.exe

E.g. where SERVICE_NAME=dashboard-service-1:

<unpacked_zip>\dashboard-service-1.exe
<unpacked_zip>\dashboard-servicew-1.exe
<unpacked_zip>\amd64\dashboard-service-1.exe

Step 3 - Run the dashboard-service-install.bat

The final step is to run the following file to install the Microsoft Windows Service for your dashboard:

<unpacked_zip>\dashboard-service-install.bat

Ensure that the service has been installed and run it to check that the dashboard launches correctly.