Table of Contents

Installation Guide for Driven Server

version 1.0.5


Driven is a web-application that receives meta-data from running Cascading applications so that their progress can be monitored, and in the case of a failure, the cause can be quickly identified.

This document explains how to install the Driven server manually. This document does not provide guidance on the desired solution architecture. However, it is strongly recommended that you set aside a dedicated machine instance for the Driven server installation to get started.

If at anytime you have issues or wish to suggest features, please email Customer Support.

Installing Driven Server

  1. If you haven’t already, download the Driven Server installation package (Driven Server including Tomcat web server and Elastic Search server):

   $ wget -i
  1. Next, unzip the download into your installation directory (referred later as ${dir})

    $ unzip driven-tomcat-1.0-<version>.zip
    $ cd driven-tomcat-1.0-<version>

Configuring Driven Server

  1. The "Teams" feature for Driven lets you collaborate your application-development activities with other members. To use the team feature and have the Driven server to send notifications to new members, we first have to configure the SMTP properties which are stored in ${dir}/conf/

  2. Start the server: Driven server includes Apache Tomcat with the Driven .war file packaged as the default context. The server will startup on port 8080. Driven applications data is written to ${dir}/driven and logs are written to ${dir}/logs.

    $ cd ${DIR}
    $ bin/
  3. After starting the server, inspect ./logs/server.log to ensure that there were no errors in starting the server. When the server starts, if there is no data, it initiates storage and creates a default admin user. The username/password is logged in the $DIR/logs/server.log.

    $ tail -f logs/server.log
    NOTE: The server UI listens on 8080. The CLI listens on 9200. Clustering is negotiated on port 9300
    So in order for Driven server to be accessible from another machine, make sure that port 8080 is open
    on the machine where Driven server is installed.
  4. From the browser, go to the Driven login, which is the URL you registered with property driven.http.url in the file Ensure that you can login with the following credentials: username: admin, password: admin. Upon successful authentication, you will be asked to change your password.

  5. You should have received a license when registering. After starting the server go to http://<hostname>:8080. You will be presented with a form to enter the text of the license.

  6. Once you log in, click on the user icon in the top right corner of the landing page, and select Team list. Note the key associated with the team name default. You will need it later.

Voila! Your server installation is now configured!

To stop the server:

  $ cd ${DIR}
  $ bin/

Uninstalling Driven Server

If you wish to uninstall Driven, perform the following steps:

  1. Stop the server:

    $ cd ${DIR}
    $ bin/
  2. Remove the installation directory: rm -rf ${dir}

Getting Support

Support for Driven is provided via a public forum:

or by emailing:


To get started with learning about Driven, check out some of the screencasts that illustrate Driven’s capabilities.

For topics not covered here, checkout the FAQ.