...
| Note |
|---|
This information is only valid for CAST Dashboard ≥ 2.x when using a ZIP ZIP/JAR 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/JAR 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 / JARs on the same server, you must ensure that each Dashboard uses a unique port. You can change the port in the following file:
...
| 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 |
|---|
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 |
|---|
<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:
...
Ensure that the service has been installed and run it to check that the dashboard launches correctly.
| Info | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
Note that if you have installed Microsoft Windows services using the method described above, it will not be possible to use the dashboard-service-uninstall.bat provided by CAST to remove the services if they are no longer required. In this scenario, you should instead use the sc.exe utility (provided with Microsoft Windows) from a CMD window (the CMD window must be run with elevated permissions (run as administrator)), for example: First, identify the display name of the service you want to remove in the services control panel. In the example below this is "CAST HDED Service":
Now run the following command to identify the service's key name (this is not always the same as the display name), where DisplayName = the name displayed in the services list:
E.g.:
In our example, the key name is hded-service:
Now run the following command to delete the service:
E.g.:
|
