Install SI¶ Follow the steps given below to install the WSO2 Integrator: SI. 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.) Download and install WSO2 Integrator¶ WSO2 Integrator bundles all WSO2 integrators in a single application; you access SI by switching profiles. Go to the WSO2 Integrator downloads page. Enter your email address and agree to the license — you will receive an email with a link to download the installer. Run the installer and open WSO2 Integrator. The home page opens with a Configure button in the top right corner. Click Configure, and under Select your Integration Profile, choose WSO2 Integrator: SI. WSO2 Integrator opens the SI setup page. If Java 21 or the SI runtime is not detected, click Download Java & SI to install both automatically. If you already have Java 21 or the SI runtime installed, expand Advanced Options to point WSO2 Integrator at your existing JAVA_HOME and SI installation directory. Locate SI_HOME¶ After installation, WSO2 Integrator places the SI runtime in a hidden folder under your user directory. The path varies by platform: macOS/Linux: ~/.wso2-si/streaming-integrator/wso2si-<VERSION>/ Windows: C:\Users\<username>\.wso2-si\streaming-integrator\wso2si-<VERSION>\ This directory is referred to as <SI_HOME> throughout this documentation. Because it sits inside a dotfile-prefixed folder, your file browser may hide it by default — toggle "Show hidden files" (Cmd + Shift + . on macOS; View → Show → Hidden items in File Explorer on Windows) to see it. Set JAVA_HOME¶ Set your JAVA_HOME environment variable to point to your JDK 21 installation directory. On macOS/LinuxOn Windows export JAVA_HOME=/path/to/your/jdk-21 To make the change persistent, add the line to your shell profile (e.g., ~/.zshrc or ~/.bashrc). setx JAVA_HOME "C:\path\to\your\jdk-21" Open a new command prompt for the change to take effect. For full instructions and the latest JDK download, see the Oracle Java SE downloads page. Starting the SI server¶ For day-to-day development, click Run in WSO2 Integrator and it manages the SI runtime for you. The commands below are for production-style deployments where you run SI standalone in a VM. Follow the steps given below to start the server. Open a command prompt as explained below. Navigate to the <SI_HOME>/bin folder from your command line. Execute one of the commands given below. To start the server: On macOS/LinuxOn Windows sh server.sh server.bat To start the server in background mode: On macOS/LinuxOn Windows sh server.sh start server.bat --start Stopping the SI server¶ To stop the WSO2 Integrator: SI standalone application, go to the terminal and press Ctrl+C. To stop the WSO2 Integrator: SI in background mode: On macOS/LinuxOn Windows sh server.sh stop server.bat --stop What's Next? Once you have successfully downloaded and installed WSO2 Integrator: SI, you can proceed to do any of the following: - If you were previously using WSO2 Stream Processor and want to migrate to WSO2 Integrator: SI, follow the instructions in Migrating from WSO2 Stream Processor. - To deploy WSO2 Integrator: SI as a single-node deployment or a cluster (based on your requirements), see Deploying WSO2 Integrator: SI. - To set up WSO2 Integrator: SI and make it ready to run in a production environment, see the Production Checklist.