WSO2 Integrator: SI Quick Start Guide¶ Introduction¶ This quick start guide gets you started with the WSO2 Integrator: SI (SI), in just 5 minutes. In this guide, you will set up WSO2 Integrator: SI, download Kafka, and try out a simple Siddhi application. The Siddhi application consumes messages from a file, processes the data, generates an output, and publishes that output to a Kafka topic. Step 1: Download and start WSO2 Integrator: SI¶ Download WSO2 Integrator from the WSO2 Integrator downloads page and install it. Open WSO2 Integrator. The home page opens with a Configure button in the top right corner. Click Configure. The Configurations panel opens. Under Select your Integration Profile, choose WSO2 Integrator: SI. WSO2 Integrator opens the SI setup page. WSO2 Integrator comes with Java 25, so Java is already set up. If the SI runtime is not detected, click Download WSO2 Integrator: SI to install it. Tip If you already have the SI runtime installed, expand Advanced Options and click Select SI Path to point WSO2 Integrator at your existing SI installation directory. The SI installation directory is referred to as <SI_HOME> from here on. Note If you use the WSO2 Integrator VS Code extension instead, the setup page also checks for Java. Install JDK 25 (JDK 17 and 21 are also supported), or let the setup page download it for you. Step 2: Download Kafka¶ Download the Kafka broker from the Apache site and extract it. This directory is referred to as <KAFKA_HOME> from here on. Step 3: Create a simple Siddhi application¶ Let's create a simple Siddhi application that reads data from a CSV file, performs a simple transformation on the data, and then publishes the results to a Kafka topic so that multiple subscriber applications can have access to that data. Download the productions.csv file from here and save it in a location of your choice. Info In this example, the file is located in the <YOUR_HOME> directory. In WSO2 Integrator: SI, open a new file, paste the following Siddhi application into it, and save it as ManageProductionStats.siddhi. @App:name('ManageProductionStats') @App:description('Receive events via file and publish to Kafka topic') @source(type = 'file', mode = "LINE", file.uri = "file:<YOUR_HOME>/productions.csv", tailing = "true", @map(type = 'csv')) define stream SweetProductionStream (name string, amount double); @sink(type = 'kafka', bootstrap.servers = "localhost:9092", topic = "total_production", is.binary.message = "false", partition.no = "0", @map(type = 'json')) define stream TotalProductionStream (name string, amount double); -- Simple Siddhi query to calculate production totals. @info(name = 'query1') from SweetProductionStream select name, sum(amount) as amount group by name insert into TotalProductionStream; Note Replace <YOUR_HOME> in the file.uri attribute with the actual directory where you saved productions.csv in the previous sub-step. The above Siddhi application reads input data from productions.csv in CSV format, processes it, and publishes the resulting output to a Kafka topic named total_production. Each input event reports the amount of a specific sweet produced in a production run, and the application calculates the running total amount produced for each sweet. Tip You can also build this application visually in the Graphical Design View of WSO2 Integrator: SI by dragging and dropping flow constructs. Step 4: Install the required Kafka extension¶ The ManageProductionStats Siddhi application uses a Kafka sink, but the Kafka Siddhi extension is not installed by default. To install it: In WSO2 Integrator, open the command palette by pressing Ctrl + Shift + P (or Cmd + Shift + P on macOS), type SI: Extension Installer, and select the SI: Extension Installer option. The Extension Installer panel opens. Scroll to Kafka and click Install. Reload WSO2 Integrator after the installation completes so that the new extension is picked up. Step 5: Start Kafka and create a topic¶ Let's start the Kafka server and create a Kafka topic so that the ManageProductionStats application you created can publish its output to it. To start Kafka: Navigate to the <KAFKA_HOME> directory and start a zookeeper node by issuing the following command. sh bin/zookeeper-server-start.sh config/zookeeper.properties Navigate to the <KAFKA_HOME> directory and start a Kafka server node by issuing the following command. sh bin/kafka-server-start.sh config/server.properties To create a Kafka topic named total_production: Navigate to the <KAFKA_HOME> directory and issue the following command: bin/kafka-topics.sh --create --bootstrap-server localhost:9092 --replication-factor 1 --partitions 1 --topic total_production Step 6: Test your Siddhi application¶ To test the ManageProductionStats Siddhi application you created, follow the steps below. In WSO2 Integrator: SI, open the ManageProductionStats.siddhi file and click the Run button (▶) in the toolbar. WSO2 Integrator starts the SI runtime and deploys the Siddhi application. Open the <YOUR_HOME>/productions.csv file and append the following five rows, making sure to press Enter after the last row so the file ends with a newline, then save your changes. Toffee,40.0 Almond cookie,70.0 Baked alaska,30.0 Toffee,60.0 Baked alaska,20.0 To observe the messages in the total_production topic, navigate to the <KAFKA_HOME> directory and issue the following command: bin/kafka-console-consumer.sh --bootstrap-server localhost:9092 --topic total_production --from-beginning You can see the following message in the Kafka Consumer log. {"event":{"name":"Almond cookie","amount":100.0}} {"event":{"name":"Baked alaska","amount":20.0}} {"event":{"name":"Toffee","amount":40.0}} {"event":{"name":"Almond cookie","amount":170.0}} {"event":{"name":"Baked alaska","amount":50.0}} {"event":{"name":"Toffee","amount":100.0}} {"event":{"name":"Baked alaska","amount":70.0}} What's next?¶ Once you try out this quick start guide, you can proceed to one of the following sections. Learn the basic functionality of the WSO2 Integrator: SI in less than 30 minutes by Creating Your First Siddhi Application. Try out WSO2 Integrator: SI tutorials. Learn how to run WSO2 Integrator: SI in containerized environments by trying Running SI with Docker and Kubernetes.