Striim 3.10.1 documentation

Creating a cluster in CentOS

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 a DBMS to host Striim's metadata repository.

  3. Download striim-node-3.10.1-Linux.rpm.

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

    Optionally, download the sample applications, striim-samples-3.10.1-Linux.rpm.

  4. Install the node package:

    sudo rpm -ivh striim-node-3.10.1-Linux.rpm

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

    sudo rpm -ivh striim-dbms-3.10.1-Linux.rpm

  6. Optionally, install the sample application package:

    sudo rpm -ivh striim-samples-3.10.1-Linux.rpm

  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 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: , . _ + : @ % / -

  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 hosting the metadata repository on Derby and Derby is not running on port 1527, set the following properties:

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

      MetadataDb=oracle
      MetaDataRepositoryLocation=<connection URL>
      MetaDataRepositoryDBname=striimrepo
      MetaDataRepositoryUname=striimrepo

      If you use an SID, the connection URL has the format jdbc:oracle:thin:@<IP address>:<port>:<SID>, for example, jdbc:oracle:thin:@192.0.2.0:1521:orcl. If you use a service name, it has the format jdbc:oracle:thin:@<IP address>:<port>/<service name>, for example, jdbc:oracle:thin:@192.0.2.01521:/orcl. 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= 192.0.2.100)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=racdb.localdomain)))(DESCRIPTION= (CONNECT_TIMEOUT=5)(TRANSPORT_CONNECT_TIMEOUT=3)(RETRY_COUNT=3)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST= 192.0.2.101)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=racdb.localdomain)))) (see Features Specific to JDBC Thin for more information.)

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

      MetadataDb=postgres
      MetaDataRepositoryLocation=<connection URL>
      MetaDataRepositoryDBname=striimrepo
      MetaDataRepositoryUname=striim

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

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

    • For CentOS 6, enter sudo start striim-dbms, wait ten seconds, then enter sudo start striim-node.

    • For CentOS 7, 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 rpm -e striim-node
sudo rpm -e striim-dbms
sudo rpm -e striim-samples
sudo rm -rf /etc/systemd/system/multi-user.target.wants/striim-node.service