Native Installation - Storm Streaming Server

Native installation gives you most control over Storm Streaming Server performance and behavior. In order for Storm software to work you’ll need a Java Virtual Machine. There are many vendors like OpenJDK or Oracle you can choose from. The only requirement is that specific VM is compatible with Java 17.

Let’s check if Java Virtual Machine is present on your system

                        
java -version
                    

Server Files Overview

Storm Streaming Server can be downloaded from My Products/Download page and comes as the compressed zip file. Please uncompress it into a desired location (we suggest something within /home or /srv directories). The package contains:

Basic Configuration

Before starting the server for the first time please edit startup.sh file (startup_win.bat for Windows based operating system) from scripts directory. The file looks as follow:

                        
#!/bin/sh

echo "Storm Streaming Server :: Startup Script"

# Check if Java is installed and get the version
if ! JAVA_VERSION=$(java -version 2>&1); then
    echo "Java is not installed on this system. Please install Java 17+ like OpenJDK or Oracle JDK to run this application."
    exit 1
fi

JAVA_MAJOR_VERSION=$(echo "$JAVA_VERSION" | awk -F '"' '/version/ {print $2}' | cut -d'.' -f1)

# Check if Java major version is 17
if [ "$JAVA_MAJOR_VERSION" -ge "17" ]; then

    # Force shutdown of any existing instances
    pkill -9 -f "StormStreamingServer.jar"

    cd "$(dirname "$0")"/..

    echo "Starting new Storm Streaming Server instance..."

    java -server -Xmx16g -Xms8g -XX:+UseG1GC -XX:MaxGCPauseMillis=100 -jar "StormStreamingServer.jar" &
else
    echo "This application requires Java 17+ to run! Please update your Java JDK."
    exit 1
fi

exit
                    

The script will automatically check if Java is present in our system and kill all previous instances of the sever. We’ll have to edit some parameters before we can properly launch the server (these are also present in startup_win.bat version).

                        
java -server -Xmx16g -Xms8g -XX:+UseG1GC -XX:MaxGCPauseMillis=100 -jar "StormStreamingServer.jar" -configRootDIR /home/storm &
                    

Startup

In order to start the server, just execute the start script file.

• For Linux/MacOS based systems

                          
  ./srv/storm/scripts/startup.sh
                      

  
  If you run into permission error, you might want to add execute rights to it too:

                          
  chmod 775 /srv/storm/scripts/startup.sh
                      

  
  
• For Windows based operating systems

                          
  C:\Storm\scripts\startup_win.bat
                      

Shutdown

There is also a pair of scripts for shutting server down

• For Linux/MacOS based systems

                          
  ./srv/storm/scripts/shutdown.sh
                      

  
  
• For Windows based operating systems

                          
  C:\Storm\scripts\shutdown_win.bat