Skip to main content

Striim Platform 5.0 documentation

Creating a cluster in Ubuntu

Important

Before following the instructions below, read the Release notes.Release notes

Follow these instructions to set up the first server in a Striim cluster. Installation will create the system account striim and all files installed will be owned by that account.

  1. Verify that the system meets the System requirements.System requirements

  2. If you will host the metadata repository in Oracle or PostgreSQL, follow the instructions in Configuring Striim's metadata repository.

  3. Download striim-node-5.0.6-Linux.deb,.

    If you plan to host the metadata repository on the internal Derby instance, download striim-dbms-5.0.6-Linux.deb.

    Optionally, download the sample applications, striim-samples-5.0.6-Linux.deb.

  4. Install the node package:

    sudo dpkg -i striim-node-5.0.6-Linux.deb

  5. If using Derby to host the metadata repository, install its package:

    sudo dpkg -i striim-dbms-5.0.6-Linux.deb

  6. Optionally, install the sample application package:

    sudo dpkg -i striim-samples-5.0.6-Linux.deb

  7. Run sudo su - striim /opt/striim/bin/sksConfig.sh and 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 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: , . _ + : @ % / -

  8. If hosting the metadata repository on Derby, change its password as described in Changing the Derby password.

  9. Edit /opt/striim/conf/startUp.properties, 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 not hosting the metadata repository on the internal Derby instance with its default settings, see Setting startUp.properties for the metadata repository.

  10. Optionally, perform additional tasks described in Configuring Striim, such as increasing the maximum amount of memory the server can use from the default of 4GB (see Changing the amount of memory available to a Striim server).

  11. Reboot the system and verify that Striim has restarted automatically.

    Alternatively:

    • For Ubuntu 14.04, enter sudo start striim-dbms , wait ten seconds, then enter sudo start striim-node.

    • For Ubuntu 16.04 or later, enter:

      sudo systemctl enable striim-dbms
sudo systemctl start striim-dbms 

      Wait ten seconds, then enter:

      sudo systemctl enable striim-node
sudo systemctl start striim-node

    Then sudo tail -F /opt/striim/logs/striim-node.log and wait for the message Please go to ... to administer, or use console.

To uninstall:

sudo dpkg -r striim-node
sudo dpkg -r striim-dbms
sudo dpkg -r striim-samples
In this section: