Skip to main content

Striim Platform 5.0 documentation

Running Striim in Microsoft Windows

See System requirements.

To install Striim for evaluation purposes, see Evaluating on Mac OS X, Linux, or Windows.

To run Striim as a process, see Running Striim as a process.

To run Striim as a service:

Install the first server as described in Creating a cluster in Microsoft Windows. To add additional servers to the cluster, follow the instructions in Adding a server to a cluster in Microsoft Windows.

Creating a cluster in Microsoft Windows

Important

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

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

  2. Download Striim_5.0.6.zip, extract it, and move the extracted striim directory to an appropriate location.

    Caution

    Known issue (DEV-22317): do not put the striim directory under a directory with a space in its name, such as C:\Program Files.

  3. Download Striim_windowsService-5.0.6.zip, extract it, and move the extracted windowsService directory to the striim\conf\ directory.

  4. Start Windows PowerShell as administrator (right-click the Windows Powershell icon and select Run as administrator), change to the striim/conf/windowsService directory, and enter .\setupWindowsService.ps1.

  5. Run striim\bin\sksConfig.bat 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: , . _ + : @ % / -

  6. Change the ownership of striim/conf/sks.jks and striim/conf/sksKey.pwd to match the other files in that directory.

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

  8. Edit 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.

  9. 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).

  10. Start the Derby and Striim services manually, or reboot to verify that they start automatically.

The stdout logs for these services are located in striim\conf\windowsService\yajsw_server\log\wrapper.log and striim\conf\windowsService\yajsw_derby\log\wrapper.log.

To tail the log files in PowerShell, enter Get-Content .\striim.server.log -Tail 10 -Wait

Uninstall Striim services from Microsoft Windows

To uninstall the services, stop them, change to the striim\conf\windowsService\yajsw\bat\ directory, and enter the following commands:

.\uninstallService
sc delete Derby
sc delete com.webaction.runtime.Server

Note: the sc command does not work in PowerShell versions 5 and earlier, but they do work at a regular Windows command prompt.

Adding a server to a cluster in Microsoft Windows

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

  2. Download Striim_5.0.6.zip and extract it to the desired location.

  3. Start Windows PowerShell as administrator (right-click the Windows Powershell icon and select Run as administrator), change to the striim/conf/windowsService directory, and enter:

    setupWindowsService.ps1 -noderby

  4. Copy sks.jks, sksKsy.pwd, and startUp.properties from striim/conf/ from the first server to striim/conf/ on the new server.

  5. Set the MetadataRepository settings to match those of the other servers in the cluster. For more information, see Setting startUp.properties for the metadata repository.

  6. If Interfaces is specified in startUp.properties, change its value to an IP address of the current system. If IsTcpIpCluster=true, add that IP address to the ServerNodeAddress list on each server in the cluster.

  7. If using TCP/IP instead of multicast UDP, see Using TCP/IP instead of multicast UDP.

  8. 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).

  9. Start the Striim service manually, or reboot to verify that it starts automatically.

In this section: