Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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
titleDeleting the services

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":

Image Added

Now run the following command to identify the service's key name (this is not always the same as the display name), where DisplayName = name displayed in the services list:

Code Block
sc.exe GetKeyName "DisplayName"

E.g.:

Code Block
sc.exe GetKeyName "CAST HDED Service"

In our example, the key name is hded-service:

Image Added

Now run the following command to delete the service:

Code Block
sc.exe delete "KeyName"

E.g.:

Code Block
sc.exe delete "hded-service"

Image Added