Windows: Installation (using the installer)

Double-click the cascade-{version}-win.exe or cascade-{version}-win.jar file to begin the installation.

Alternatively, the JAR package can be run by executing the following (from a command line):

java -jar cascade-{VERSION}-win.jar

Step 1 of 6: Cascade Server Readme

  • Read the statement.
  • Check the box labeled I have read and understand the preceding statement.
  • Click Next.

Step 2 of 6: Select Installation Type

  • Select Full Cascade Installation. A Full Cascade Installation will instruct the installer to install a fresh instance of Cascade Server on the machine.
  • Click Next.

Step 3 of 6: Cascade Configuration

  • Fill in (or browse to) the Cascade installation directory. Cascade Server will install to C:\Program Files\Cascade Server by default.
  • In the Run Cascade Server on port field, enter the port on which Cascade Server will be accessed. The default port is 8080.
  • Fill in the Maximum amount of memory Cascade can use (in MB) field. The default setting is 512. ( NOTE: This setting is only applicable for those running Cascade Server from the command line. If Cascade Server will run via Windows service, memory settings will need to be configured after the installation is completed according to the documentation here.
  • Choose whether or not to Start Cascade Server Automatically on boot. Selecting this option will install Cascade Server as a Windows Service.
  • Click Next.

Step 4 of 6: Cascade Database Configuration

  • Select the Database type which will be used (MySQL, Microsoft SQL Server, or Oracle). Selecting Manual Configuration allows for configuring the database connection after the Cascade Server installation.
  • Fill in the Database hostname:port field with the hostname and port of the database server that Cascade will use.
  • Enter the Database name to which Cascade Server will connect. For Oracle, also fill out the Schema name and Oracle SID fields. In most cases, the Database name and Schema name should be the same.
  • Fill in the Username and Password fields for accessing the Cascade Server database. For Oracle, the Username must match the Schema name.
  • Optional: Click the Test Connection button to test the connection to the database using the specified credentials.
  • Click Next.

Step 5 of 6: Cascade Server License Agreement

  • Read the agreement.
  • Select I accept the terms of this license agreement. ( NOTE: Selecting I do not accept the terms of this license agreement. will prevent the installation from completing.)
  • Click Next.

Step 6 of 6: Installation

  • Wait for the Pack Installation progress bar to display [Finished] and Overall installation progress to display 2/2.
  • Click Done.

Starting Cascade Server

The application can be started using one of the following methods (do not use both as that will lead to a port conflict since two instances of the application will be running at the same time):

  • Windows service - Assuming that the Windows service was installed in step 3 above, Cascade can be started using the following steps:
    • Navigate to the Windows services dialog box
    • Right-click on the 'Cascade Server' service
    • Click 'Start'
  • Command line:
    • Open a command prompt
    • Navigate to the Cascade installation directory ( ex. C:\Program Files\Cascade Server)
    • Type cascade.bat start

Logging in

Once the application is running, you should be able to access it in your browser by navigating to hostname:8080 (where 'hostname' is the host name of the machine on which Cascade is installed and 8080 is the port selected during the installation).

The default credentials to log in are:
username: admin
password: admin

It is recommended that the 'admin' account password is changed to something more secure immediately after logging in for the first time.