Skip to content

Installing the Streaming Integrator in a Virtual Machine

Follow the steps given below to install and run WSO2 Streaming Integrator on a VM.

System requirements

Type Requirement
CPU You require a minimum of one CPU with 2 cores. It is recommended to have a CPU with 4 cores.
Memory ~ 4 GB minimum is recommended

~ 2 GB heap size
Disk ~ 1 GB minimum (excluding space allocated for log files and databases.)

Installing the Streaming Integrator

Follow the steps below:

  1. Go to the Streaming Integrator product page and click Download to get the product installer. The installer that is compatible with your operating system is downloaded.


    Alternatively, go to Other Installation Options and click Binary to download the product distribution as a ZIP file.

  2. If you used the installer, double-click to open the installation wizard that guides you through the installation. When you finish, the product is installed and ready for use.

Accessing the HOME directory

Let's call the installation location of your product the <SI_HOME> directory.

If you used the installer to install the product, this is located in a place specific to your OS as shown below:

OS Home directory
Mac OS /Library/WSO2/EnterpriseIntegrator/7.0.2/streaming-integrator
Windows C:\Program Files\WSO2\Enterprise Integrator\7.0.2\streaming-integrator
Ubuntu /usr/lib/wso2/wso2ei/7.0.2/streaming-integrator
CentOS /usr/lib64/wso2/wso2ei/7.0.2/streaming-integrator

Uninstalling the product

If you used the installer to install the product, you can uninstall by following the steps given below:

OS Instructions
Mac OS

Open a terminal and run the following command as the root user:

sudo bash /Library/WSO2/EnterpriseIntegrator/7.0.2
Windows Go to Start Menu -> Programs -> WSO2 -> Uninstall Enterprise Integrator 7.0.2 or search Uninstall Enterprise Integrator 7.0.2 and click the shortcut icon. This uninstalls the product from your computer.

Open a terminal and run the following command:

sudo apt purge wso2ei-7.0.2

Open a terminal and run the following command:

sudo yum remove wso2ei-7.0.2

Running the Streaming Integrator

Start the WSO2 Streaming Integrator by following the instructions given below.

Using the installer

  • On MacOS/Linux/CentOS, open a terminal and execute the command given below.

    sudo wso2si
    The operation log keeps running until the profile starts, which usually takes several seconds. Wait until the profile fully boots up and displays a message similar to " WSO2 Carbon started in n seconds. "

  • On Windows, go to Start Menu -> Programs -> WSO2 -> Enterprise Integrator. This opens a terminal and start the relevant profile.

If you have installed the product using the installer and you want to manually run the product startup script from the <SI_HOME/bin> directory, you need to issue the following command:

sudo sh
This script automatically assigns the JAVA_HOME of your VM to the root user of your Streaming Integrator instance.

Using the binary distribution

  1. Before you execute the product startup script, be sure to set the JAVA HOME in your machine. Use a JDK that is compatible with WSO2 Enterprise Integrator.

  2. Open a terminal and navigate to the <SI_HOME>/bin/ directory, where <SI_HOME> is the home directory of the distribution you downloaded.

  3. Execute the relevant command.

    • On MacOS/Linux/CentOS


    • On Windows


By default, the HTTP listener port is 8290 and the default HTTPS listener port is 8253.

Stopping the Streaming Integrator

To stop the Streaming Integrator runtime, press Ctrl+C in the command window.

What's Next?

Once you have successfully downloaded and installed WSO2 Streaming Integrator, you can proceed to do any of the following:

  • If you were previously using WSO2 Stream Processor and want to migrate to WSO2 Streaming Integrator, follow the instructions in Migrating from WSO2 Stream Processor.

  • To deploy WSO2 Streaming Integrator as a single-node deployment or a cluster (based on your requirements), see Deploying Streaming Integrator.

  • To set up WSO2 Streaming Integrator and make it ready to run in a production environment, see the Production Checklist.