Striim 3.10.2 documentation

Running Striim as a process


Before installing Striim, verify that the system meets the System requirements.System requirements

For development and testing, it can be useful to run Striim as a process, so you can easily restart with different options or switch between various releases. We do not recommend running Striim as a process in a production environment. If you do not need to run Striim as a service, you can install simply by extracting a Striim-<version>.tgz or .zip archive. For example, to extract to the /opt directory (the typical location, though you may install wherever you like):

tar zxvf Striim-<version>.tgz -C /opt

Once you have extracted the package, set the server properties:

  1. Open a terminal or command prompt and change to the striim directory.

    • In CentOS or Ubuntu, enter sudo su - striim bin/

    • In OS X, enter bin/

    • In Windows, enter bin\sksConfig

    When prompted, enter passwords for the Striim keystore and the admin and sys users. If hosting the metadata repository on Oracle or PostgreSQL, enter that password as well (see Configuring a DBMS to host Striim's metadata repository). If you are using a Bash or Bourne shell, characters other than letters, numbers, and the following punctuation marks must be escaped: , . _ + : @ % / -

  2. Edit /opt/striim/conf/, edit the following property values (removing any # characters and spaces from the beginning of the lines), and save the file:

    • WAClusterName: a name for the Striim cluster (note that if an existing Striim cluster on the network has this name, Striim will try to join it)

    • CompanyName: If you specify keys, this must exactly match the associated company name. If you are using a trial license, any name will work.

    • ProductKey and LIcenseKey: If you have keys, specify them, otherwise leave blank to run Striim on a trial license. Note that you cannot create a multi-server cluster using a trial license.

    • Interfaces: If the system has more than one IP address, specify the one you want Striim to use, otherwise leave blank and Striim will set this automatically.

    • If hosting the metadata repository on Derby and Derby is not running on port 1527, set the following properties:

      MetaDataRepositoryLocation=<IP address>:<port>
    • If hosting the metadata repository on Oracle, set the following properties:

      MetaDataRepositoryLocation=<connection URL>

      If you use an SID, the connection URL has the format jdbc:oracle:thin:@<IP address>:<port>:<SID>, for example, jdbc:oracle:thin:@ If you use a service name, it has the format jdbc:oracle:thin:@<IP address>:<port>/<service name>, for example, jdbc:oracle:thin:@ In a high availability active-standby or RAC environment, specify all servers, for example, MetaDataRepositoryLocation=jdbc:oracle:thin:@(DESCRIPTION_LIST=(LOAD_BALANCE=off)(FAILOVER=on)(DESCRIPTION= (CONNECT_TIMEOUT=5)(TRANSPORT_CONNECT_TIMEOUT=3)(RETRY_COUNT=3)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST= (CONNECT_TIMEOUT=5)(TRANSPORT_CONNECT_TIMEOUT=3)(RETRY_COUNT=3)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST= (see Features Specific to JDBC Thin for more information.)

      If hosting the metadata repository on PostgreSQL, set the following properties:

      MetaDataRepositoryLocation=<connection URL>

      The PostgreSQL connection URL has the format <IP address>:<port>/striimrepo, for example In a high availability environment, specify the IP addresses of both the primary and standby servers, separated by a comma, for example,,

  3. If hosting the metadata repository on Derby in a production environment (not recommended), change its password (see Changing the Derby password).

  4. Optionally, perform additional tasks described in Configuring Striim, such as increasing the maximum amount of memory the server can use.

  5. Save the file.

Once you have specified the necessary server properties, start the server with striim\bin\server.bat (for Windows) or striim/bin/ (for OS X or Linux).

When the server has started, you will see a message indicating the URL where you can access its web UI.

When running as a process, SysOut output will be written to the terminal running the server process rather than to striim-node.log.

To start the console, enter striim\bin\console.bat -c <cluster name> (for Windows) or striim/bin/ -c <cluster name> (for OS X or Linux).

To stop the server, press Ctrl-C in the terminal window.

To restart, run server.bat or Optionally you may specify a startup properties file as an argument, which can save time if you need to run Striim with various settings for testing or development purposes.


If installing a new release of Striim, delete the striim directory and empty the trash before extracting the new .tgz or .zip archive, and clear your browser cache before logging in to the web UI.