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/JAR file deployment (i.e. without Apache Tomcat). If you are deploying WAR files using Apache Tomcat, see Configuring Apache Tomcat to use secure https protocol for more information.

Introduction

By default, the CAST Dashboards will listen on an insecure HTTP connection on port 8080 will be used for end-user access to the CAST Dasboards(i.e for user access). This page explains how to change the running listening port number, for example to enable a secured connection using HTTPS on port 443 or to change to an alternative HTTP port such as port 80.

Prerequisites

(tick)

If you intend to change the port numbers in order to enable HTTPS then you must already have a Java keystore file containing the X.509 certificate (from a trusted authority). Obtaining the certificate and generating the keystore files are out of the scope of this document. See https://tomcat.apache.org/tomcat-9.0-doc/ssl-howto.html#Prepare_the_Certificate_Keystore for more information about importing existing signed X.509 certificates into a keystore and generating new self-signed certificates and storing them in a keystore.Note also that

  • CAST Dashboards support only the following format keystores:
    • JKS
    • PKCS11
    • PKCS12
  • You should ensure that the release of Java used to generate the certificate is identical to the release of Java used to import the certificate otherwise the Dashboard service may fail to start. This is especially true of the certificate is being generated on another machine.

Configure an alternative insecure port

By default, CAST Dashboards are configured to run listen on port 8080. If you want to change this to an alternative port, edit the following file:

Code Block
<unpacked_zip><install_folder>\configurations\application.properties
or
%PROGRAMDATA%\CAST\Dashboards\<dashboard>\application.properties

Locate the following line in the file:

...

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

Configure an alternative secure port

To force the dashboards to use listen on a secure HTTPS port, edit the following file:

Code Block
<unpacked_zip><install_folder>\configurations\application.properties
or
%PROGRAMDATA%\CAST\Dashboards\<dashboard>\application.properties

Locate the following lines in the file:

...