...
| Note |
|---|
This information is only valid for CAST Dashboard ≥ 2.x when using a ZIP file ZIP 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:
- 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:
| Code Block |
|---|
<unpacked<install_zip>folder>\configurations\application.properties |
...
| Info |
|---|
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 - 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:
| Code Block |
|---|
<unpacked<install_zip>folder>\dashboard-service-install.bat |
...
| Code Block |
|---|
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:
| Code Block |
|---|
<unpacked<install_zip>folder>\dashboard-service.exe <unpacked<install_zip>folder>\dashboard-servicew.exe <unpacked<install_zip>folder>\amd64\dashboard-service.exe |
E.g. where SERVICE_NAME=dashboard-service-1:
| Code Block |
|---|
<unpacked<install_zip>folder>\dashboard-service-1.exe <unpacked<install_zip>folder>\dashboard-servicew-1.exe <unpacked<install_zip>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:
| Code Block |
|---|
<unpacked<install_zip>folder>\dashboard-service-install.bat |
...