Introduction

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

• when multiple standalone 2.x Dashboards need to be run from the same server
• when embedded AIP Console Dashboards (from v. 1.25) need to be run on the same machine as standalone 2.x ZIP dashboards

Required changes

Step 1 - Change the port on which the Dashboard is running - Linux and Microsoft Windows

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

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:

<install_folder>\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 (if commented) and modify the port number to make it unique and save the file:

server.port=8090

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

Step 2 - Change Microsoft Windows service name - Microsoft Windows only

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 or run the wizard installer in ≥ 2.5 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:

<install_folder>\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:

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

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

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

Run the dashboard-service-install.bat

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

<install_folder>\dashboard-service-install.bat

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