Skip to content

Running Streaming Integrator as a Linux Service

WSO2 Streaming Integrator can be run as a Linux service.

Before you begin

Install JDK version 11 and set the JAVA_HOME variable.

Download and install the Streaming Integrator

Go to the WSO2 Streaming Integrator product page, click Download, and then click Zip Archive to download the product distribution as a ZIP file.

Extract the download ZIP file to a location on your computer. The streaming-integrator folder inside the extracted ZIP file will be your SI_HOME directory.

For more information, see Installing via the Binary

Running WSO2 Streaming Integrator as a Linux Service

To run WSO2 Streaming Integrator as a Linux service, follow the steps below:

  1. To run the product as a service, create a startup script and add it to the boot sequence. The basic structure of the startup script has three parts (i.e., start, stop and restart) as follows:

    #!/bin/bash
    
    case “$1″ in
    start)
       echo “Starting Service”
    ;;
    stop)
       echo “Stopping Service”
    ;;
    restart)
       echo “Restarting Service”
    ;;
    *)
       echo $”Usage: $0 {start|stop|restart}”
    exit 1
    esac
    

You can write the start up scripts for the Streaming Integrator server and Tooling as follows:

  • Streaming Integrator Server

    #! /bin/sh
    export JAVA_HOME="/usr/lib/jvm/jdk1.7.0_07"
    
    startcmd='/opt/WSO2/wso2si-1.1.0/bin/server.sh start > /dev/null &'
    restartcmd='/opt/WSO2/wso2si-1.1.0/bin/server.sh restart > /dev/null &'
    stopcmd='/opt/WSO2/wso2si-1.1.0/bin/server.sh stop > /dev/null &'
    
    case "$1" in
    start)
       echo "Starting WSO2 Streaming Integrator ..."
       su -c "${startcmd}" user1
    ;;
    restart)
       echo "Re-starting WSO2 Streaming Integrator ..."
       su -c "${restartcmd}" user1
    ;;
    stop)
       echo "Stopping WSO2 Streaming Integrator ..."
       su -c "${stopcmd}" user1
    ;;
    *)
       echo "Usage: $0 {start|stop|restart}"
    exit 1
    esac
    
    - Streaming Integrator Tooling

    #! /bin/sh
    export JAVA_HOME="/usr/lib/jvm/jdk1.7.0_07"
    
    startcmd='/opt/WSO2/wso2si-tooling-1.1.0/bin/tooling.sh start > /dev/null &'
    restartcmd='/opt/WSO2/wso2si-tooling-1.1.0/bin/tooling.sh restart > /dev/null &'
    stopcmd='/opt/WSO2/wso2si-tooling-1.1.0/bin/tooling.sh stop > /dev/null &'
    
    case "$1" in
    start)
       echo "WSO2 Streaming Integrator Tooling ..."
       su -c "${startcmd}" user1
    ;;
    restart)
       echo "Re-starting WSO2 Streaming Integrator Tooling ..."
       su -c "${restartcmd}" user1
    ;;
    stop)
       echo "Stopping WSO2 Streaming Integrator Tooling ..."
       su -c "${stopcmd}" user1
    ;;
    *)
       echo "Usage: $0 {start|stop|restart}"
    exit 1
    esac
    

In the above script, the server is started via a user named user1 rather than the root user. For example, su -c "${startcmd}" user1.

  1. Add the script to the /etc/init.d/ directory.

    Info

    If you want to keep the scripts in a location other than /etc/init.d/ directory , you can add a symbolic link to the script in the /etc/init.d/ and keep the actual script in a separate location. e.g., If your script name is siserver and it is in the /opt/WSO2/ directory, then the commands for adding a link to /etc/init.d/ are as follows:

    - To make the script executable: sudo chmod a+x /opt/WSO2/appserver
    - To add a link to /etc/init.d/: sudo ln -snf /opt/WSO2/appserver /etc/init.d/appserver

  2. Install the startup script to respective run levels via the update-rc.d command. e.g., Issue the following command for the sample script given in step 1.

    sudo update-rc.d appserver defaults

    The defaults option in the above command makes the service start in runlevels 2,3,4, and 5, and stop in runlevels 0,1, and 6.

    Info

    A runlevel is a mode of operation in Linux (or any Unix-style operating system). There are several runlevels in a Linux server and each of these runlevels is represented by a single digit integer. Each runlevel designates a different system configuration and allows access to a different combination of processes.

You can now start, stop and restart the server via the service <service name> {start|stop|restart} command. You will be prompted for the password of the username (or root) via which you started the service.