type: runners title: “Hazelcast Jet Runner” aliases: /learn/runners/jet/

Overview

The Hazelcast Jet Runner can be used to execute Beam pipelines using Hazelcast Jet.

The Jet Runner and Jet are suitable for large scale continuous jobs and provide:

  • Support for both batch (bounded) and streaming (unbounded) data sets
  • A runtime that supports very high throughput and low event latency at the same time
  • Natural back-pressure in streaming programs
  • Distributed massively parallel data processing engine with in memory storage

It's important to note that the Jet Runner is currently in an EXPERIMENTAL state and can not make use of many of the capabilities present in Jet:

  • Jet has full Fault Tolerance support, the Jet Runner does not; if a job fails it must be restarted
  • Internal performance of Jet is extremely high. The Runner can't match it as of now because Beam pipeline optimization/surgery has not been fully implemented.

The Beam Capability Matrix documents the supported capabilities of the Jet Runner.

Running WordCount with the Hazelcast Jet Runner

Generating the Beam examples project

Just follow the instruction from the Java Quickstart page

Running WordCount on a Local Jet Cluster

Issue following command in the Beam examples project to start new Jet cluster and run the WordCount example on it.

    $ mvn package exec:java \
        -DskipTests \
        -Dexec.mainClass=org.apache.beam.examples.WordCount \
        -Dexec.args="\
            --runner=JetRunner \
            --jetLocalMode=3 \
            --inputFile=pom.xml \
            --output=counts" \
        -Pjet-runner

Running WordCount on a Remote Jet Cluster

The Beam examples project, when generated from an archetype, comes from a particular released Beam version (that's what the archetypeVersion property is about). Each Beam version that contains the Jet Runner (ie. from 2.14.0 onwards) uses a certain version of Jet. Because of this, when we start a stand-alone Jet cluster and try to run Beam examples on it we need to make sure the two are compatible. See following table for which Jet version is recommended for various Beam versions.

Download latest Hazelcast Jet version compatible with the Beam you are using from Hazelcast Jet Website.

Once the download has finished you need to start a Jet cluster. The simplest way to do so is to start Jet cluster members using the jet-start script that comes with the downloaded Jet distribution. The members use the auto discovery feature auto discovery feature to form a cluster. Let's start up a cluster formed by two members:

{{< version jet3 >}} $ cd hazelcast-jet $ bin/jet-start.sh & $ bin/jet-start.sh & {{< /version >}}

{{< version jet4 >}} $ cd hazelcast-jet $ bin/jet-start & $ bin/jet-start & {{< /version >}}

Check the cluster is up and running:

{{< version jet3 >}} $ bin/jet.sh cluster {{< /version >}}

{{< version jet4 >}} $ bin/jet cluster {{< /version >}}

You should see something like:

{{< version jet3 >}} State: ACTIVE Version: 3.0 Size: 2

ADDRESS UUID [192.168.0.117]:5701 76bea7ba-f032-4c25-ad04-bdef6782f481 [192.168.0.117]:5702 03ecfaa2-be16-41b6-b5cf-eea584d7fb86 {{< /version >}}

{{< version jet4 >}} State: ACTIVE Version: 4.0 Size: 2

ADDRESS UUID [192.168.0.117]:5701 b9937bba-32aa-48ba-8e32-423aafed763b [192.168.0.117]:5702 dfeadfb2-3ba5-4d1c-95e7-71a1a3ca4937 {{< /version >}}

Change directory to the Beam Examples project and issue following command to submit and execute your Pipeline on the remote Jet cluster. Make sure to distribute the input file (file with the words to be counted) to all machines where the cluster runs. The word count job won't be able to read the data otherwise.

    $ mvn package exec:java \
        -DskipTests \
        -Dexec.mainClass=org.apache.beam.examples.WordCount \
        -Dexec.args="\
            --runner=JetRunner \
            --jetServers=192.168.0.117:5701,192.168.0.117:5702 \
            --codeJarPathname=target/word-count-beam-bundled-0.1.jar \
            --inputFile=<INPUT_FILE_AVAILABLE_ON_ALL_CLUSTER_MEMBERS> \
            --output=/tmp/counts" \
        -Pjet-runner

Pipeline Options for the Jet Runner