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:
-
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:
You can write the start up scripts for the Streaming Integrator server and Tooling as follows:
-
Streaming Integrator Server
- Streaming Integrator Tooling#! /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
#! /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
.
-
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
-
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.