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.

Installing the Streaming Integrator

Follow the steps below:

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

    Info

    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.0/streaming-integrator
Windows C:\Program Files\WSO2\Enterprise Integrator\7.0.0\streaming-integrator
Ubuntu /usr/lib/wso2/wso2ei/7.0.0/streaming-integrator
CentOS /usr/lib64/wso2/wso2ei/7.0.0/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.0
Windows Go to Start Menu -> Programs -> WSO2 -> Uninstall Enterprise Integrator 7.0.0 or search Uninstall Enterprise Integrator 7.0.0 and click the shortcut icon. This uninstalls the product from your computer.
Ubuntu

Open a terminal and run the following command:

sudo apt purge wso2ei-7.0.0
CentOS

Open a terminal and run the following command:

sudo yum remove wso2ei-7.0.0

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 launcher_streaming-integrator.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

      sh streaming-integrator.sh

    • On Windows

      streaming-integrator.bat

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.

Top