You can download any release of Strymon from the release archive or
fetch the most recent version directly using
$ git clone https://github.com/strymon-system/strymon-core.git Cloning into 'strymon-core'... … $ cd strymon-core
$ cargo build --all --release
This step will take a while, as this command builds everything: The Strymon core run-time, the provided example programs, and essential dependencies such as Timely and Differential Dataflow.
Note: The easiest way to install the nightly version of the Rust compiler and Cargo is using rustup.rs. As of Stymon Core version 0.2, we support Rust 1.22 or newer. We recommend you use the most recent stable version of the Rust compiler.
Starting a local Strymon cluster
Once you downloaded and built
strymon-core, run the following commands in
the project folder to spawn a local cluster:
Start a coordinator and the executors listed in
Ensure that the system is running by inspecting the system catalog:
$ ./bin/strymon status Coordinator: localhost:9189 Executor 0: host="localhost"
For more information about these command-line utilities, please consult their documentation.
Note: on macOS you may be presented with a prompt from the firewall, once when starting the cluster and again when running the provided example. This is because the built-in firewall blocks incoming network connections and you can safely proceed by selecting “Allow”.
Next step: Try the example programs
The Strymon Core contains a very simple two-stage example of a network topology generator and a connected components module. You can read more about them and how to try it out in the next chapter:
Stopping the cluster
To stop the coordinator and the executor running on the local machine, execute the following command: