日本語

Quick Start Guide

Preface

In this tutorial you can try the following things.

• Installing SINETStream
• Send/receive messages to/from a messaging system (Kafka or MQTT) via SINETStream.

The following configuration will be established through this tutorial.

• Writer sends messages to Broker via SINETStream
• Reader receives messages from Broker via SINETStream
• Broker aggregates and delivers messages from Writer to Reader, and separates the endpoints from each other.

A Docker container image is provided to easily prepare the above configuration. By using this container image, you can easily set up the Kafka broker and the MQTT broker (Mosquitto).

Prerequisites

To complete this tutorial, you must meet the following requirements.

• The execution environment, e.g., your laptop computer, must be connected to the Internet for downloading libraries and Docker containers.
• Docker Engine must be installed in the execution environment for preparing the execution environment of Broker and SINETStream.

If Docker Engine is not installed in the execution environment, please refer to the Docker’s official website and install it. The following links to installation instructions for Docker Engine on major platforms are provided for reference.

Links to Docker Engine installation instructions

Below are the official Docker site that shows the installation procedure on typical platforms.

• macOS
  • Install Docker Desktop on Mac
• Microsoft Windows 10
  • Install Docker Desktop on Windows
• Ubuntu(x86_64)
  • Install Docker Engine on Ubuntu

For other operating systems, please refer to the links listed on the supported platforms on the official Docker website.

Running the tutorial

Two procedures with different component arrangements are provided.

• STEP1
  • Setup Writer, Broker, and Reader together in a single machine
• STEP2
  • Setup Writer, Broker, and Reader on each separate machines

Each step is described on the linked page above. The two steps are independent, so you can try one or both of them.