Package: zenoh Version: 1.3.4 Architecture: armel Maintainer: zenoh-dev@eclipse.org Installed-Size: 41 Depends: zenoh-plugin-rest (=1.3.4), zenoh-plugin-storage-manager (=1.3.4), zenohd (=1.3.4) Filename: 1.3.4/zenoh_1.3.4_armel.deb Size: 17556 MD5sum: 3cbc320b4a92f2af8c6b319a7f4f0e5d SHA1: 6a0be187bd8e92e256e246e01bbdd9a0e40ba49c SHA256: 251915df172219926314d387aae456a2f2d691efa5bfe1940f79d6b3fc28cd4a Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol. . [![CI](https://github.com/eclipse-zenoh/zenoh/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![codecov](https://codecov.io/github/eclipse-zenoh/zenoh/branch/main/graph/badge.svg?token=F8T4C8WPZD)](https://codecov.io/github/eclipse-zenoh/zenoh) [![Discussion](https://img.shields.io/badge/discussion-on%20github-blue)](https://github.com/eclipse-zenoh/roadmap/discussions) [![Discord](https://img.shields.io/badge/chat-on%20discord-blue)](https://discord.gg/2GJ958VuHs) [![License](https://img.shields.io/badge/License-EPL%202.0-blue)](https://choosealicense.com/licenses/epl-2.0/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) . # Eclipse Zenoh . The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and computations. It carefully blends traditional pub/sub with geo-distributed storages, queries and computations, while retaining a level of time and space efficiency that is well beyond any of the mainstream stacks. . Check the website [zenoh.io](http://zenoh.io) and the [roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed information. . ------------------------------- . ## Getting Started . Zenoh is extremely easy to learn, the best place to master the fundamentals is our [getting started guide](https://zenoh.io/docs/getting-started/first-app/). . ------------------------------- . ## How to install it . To install the latest release of the Zenoh router (`zenohd`) and its default plugins (REST API plugin and Storages Manager plugin) you can do as follows: . ### Manual installation (all platforms) . All release packages can be downloaded from [https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/). . Each subdirectory has the name of the Rust target. See the platforms each target corresponds to on [https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html). . Choose your platform and download the `.zip` file. Unzip it where you want, and run the extracted `zenohd` binary. . ### Linux Debian . Add Eclipse Zenoh private repository to the sources list, and install the `zenoh` package: . ```bash echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" | sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null sudo apt update sudo apt install zenoh ``` . Then you can start run `zenohd`. . ### MacOS . Tap our brew package repository and install the `zenoh` formula: . ```bash brew tap eclipse-zenoh/homebrew-zenoh brew install zenoh ``` . Then you can start run `zenohd`. . ------------------------------- . ## Rust API . * [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/) . ------------------------------- . ## How to build it . > [!WARNING] > Zenoh and its ecosystem are under active development. When you build from git, make sure you also build from git any other Zenoh repository you plan to use (e.g. binding, plugin, backend, etc.). It may happen that some changes in git are not compatible with the most recent packaged Zenoh release (e.g. deb, docker, pip). We put particular effort in maintaining compatibility between the various git repositories in the Zenoh project. . Install [Cargo and Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh can be successfully compiled with Rust stable (>= 1.75.0), so no special configuration is required from your side. If you already have the Rust toolchain installed, make sure it is up-to-date with: . ```bash rustup update ``` . To build Zenoh, just type the following command after having followed the previous instructions: . ```bash cargo build --release --all-targets ``` . Zenoh's router is built as `target/release/zenohd`. All the examples are built into the `target/release/examples` directory. They can all work in peer-to-peer, or interconnected via the zenoh router. . ------------------------------- . ## Quick tests of your build . ### Peer-to-peer tests . * **pub/sub** * run: `./target/release/examples/z_sub` * in another shell run: `./target/release/examples/z_put` * the subscriber should receive the publication. . * **get/queryable** * run: `./target/release/examples/z_queryable` * in another shell run: `./target/release/examples/z_get` * the queryable should display the log in its listener, and the get should receive the queryable result. . ### Routed tests . > [!NOTE] > **Windows users**: to properly execute the commands below in PowerShell you need to escape `"` characters as `\"`. . * **put / store / get** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell run: . ```sh ./target/release/examples/z_put` ``` . * then run . ```sh ./target/release/examples/z_get ``` . * the get should receive the stored publication. . * **REST API using `curl` tool** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, do a publication via the REST API: . ```sh curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test ``` . * get it back via the REST API: . ```sh curl http://localhost:8000/demo/example/test ``` . * **router admin space via the REST API** * run the Zenoh router with permission to perform config changes via the admin space, and with a memory storage: . ```sh ./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, get info of the zenoh router via the zenoh admin space (you may use `jq` for pretty json formatting): . ```sh curl -s http://localhost:8000/@/local/router | jq ``` . * get the volumes of the router (only memory by default): . ```sh curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq ``` . * get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . * add another memory storage on `/demo/mystore/**`: . ```sh curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore ``` . * check it has been created: . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . ### Configuration options . A Zenoh configuration file can be provided via CLI to all Zenoh examples and the Zenoh router. . * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and the available options. . See other examples of Zenoh usage in [examples/](examples) . > [!NOTE] > **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh allows for configuring the number of worker threads and other advanced options of the runtime. For guidance on utilizing it, please refer to the [doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html). . ------------------------------- . ## Zenoh router command line arguments . `zenohd` accepts the following arguments: . * `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write permissions on the admin space. Default is read only. * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All properties of this configuration are optional, so you may not need such a large configuration for your use-case. * `--cfg :`: allows you to change specific parts of the configuration right after it has been constructed. VALUE must be a valid JSON5 value, and key must be a path through the configuration file, where each element is separated by a `/`. When inserting in parts of the config that are arrays, you may use indexes, or may use `+` to indicate that you want to append your value to the array. `--cfg` passed values will always override any previously existing value for their key in the configuration. * `-l, --listen ...`: An endpoint on which this router will listen for incoming sessions. Repeat this option to open several listeners. By default, `tcp/[::]:7447` is used. The following endpoints are currently supported: * TCP: `tcp/:` * UDP: `udp/:` * [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:` * [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:` * `-e, --connect ...`: An endpoint this router will try to connect to. Repeat this option to connect to several peers or routers. * `--no-multicast-scouting`: By default zenohd replies to multicast scouting messages for being discovered by peers and clients. This option disables this feature. * `-i, --id `: The identifier (as an hexadecimal string - e.g.: A0B23...) that zenohd must use. **WARNING**: this identifier must be unique in the system! If not set, a random unsigned 128bit integer will be used. * `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each routed Data if there isn't already one. This option disables this feature. * `-P, --plugin [ | :]...`: A [plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted values: * a plugin name; zenohd will search for a library named `libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on MacOS or `zenoh_plugin_.dll` on Windows. * `":"`; the plugin will be loaded from library file at ``. . Repeat this option to load several plugins. * `--plugin-search-dir ...`: A directory where to search for [plugins](https://zenoh.io/docs/manual/plugins/) libraries to load. Repeat this option to specify several search directories'. By default, the plugins libraries will be searched in: `'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'` * `--rest-http-port `: Configures the [REST plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted values: * a port number * a string with format `:` (to bind the HTTP server to a specific interface) * `"None"` to deactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . ------------------------------- . ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version as `zenohd`, and using for `zenoh` dependency the same version (or commit number) as `zenohd` with the same set of features. A plugin compiled with different Rust version or with different set of `zenoh` crate features will be rejected when `zenohd` attempts to load it. Otherwise, incompatibilities in memory mapping of structures shared between `zenohd` and the library could lead to a `"SIGSEGV"` crash. . By default the Zenoh router is delivered or built with 2 plugins. These may be configured through a configuration file, or through individual changes to the configuration via the `--cfg` CLI option or via zenoh puts on individual parts of the configuration. . > [!WARNING] > Since `v0.6`, `zenohd` no longer loads every available plugin at startup. Instead, only configured plugins are loaded (after processing `--cfg` and `--plugin` options). Once `zenohd` is running, plugins can be hot-loaded and, if they support it, reconfigured at runtime by editing their configuration through the adminspace. . **[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST API): This plugin converts GET and PUT REST requests into Zenoh gets and puts respectively. . Note that to activate the REST plugin on `zenohd` the CLI argument should be passed: `--rest-http-port=8000` (or any other port of your choice). . **[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)** (managing [backends and storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes)) This plugin allows you to easily define storages. These will store key-value pairs they subscribed to, and send the most recent ones when queried. Check out [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them. . ------------------------------- . ## Troubleshooting . In case of troubles, please first check on [this page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble and cause are already known. Otherwise, you can ask a question on the [zenoh Discord server](https://discord.gg/vSDSpqnbkm), or [create an issue](https://github.com/eclipse-zenoh/zenoh/issues). Package: zenoh Version: 1.3.4 Architecture: arm64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 41 Depends: zenoh-plugin-rest (=1.3.4), zenoh-plugin-storage-manager (=1.3.4), zenohd (=1.3.4) Filename: 1.3.4/zenoh_1.3.4_arm64.deb Size: 17556 MD5sum: 945a2a763b6b8f5e1eaff64e575b4498 SHA1: db08dd566e28168d57c3d3a25a10c5527828537e SHA256: beee2f89a6602750803fdb56495f2d093c562d3f044e707a609efc0cdd0b3903 Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol. . [![CI](https://github.com/eclipse-zenoh/zenoh/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![codecov](https://codecov.io/github/eclipse-zenoh/zenoh/branch/main/graph/badge.svg?token=F8T4C8WPZD)](https://codecov.io/github/eclipse-zenoh/zenoh) [![Discussion](https://img.shields.io/badge/discussion-on%20github-blue)](https://github.com/eclipse-zenoh/roadmap/discussions) [![Discord](https://img.shields.io/badge/chat-on%20discord-blue)](https://discord.gg/2GJ958VuHs) [![License](https://img.shields.io/badge/License-EPL%202.0-blue)](https://choosealicense.com/licenses/epl-2.0/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) . # Eclipse Zenoh . The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and computations. It carefully blends traditional pub/sub with geo-distributed storages, queries and computations, while retaining a level of time and space efficiency that is well beyond any of the mainstream stacks. . Check the website [zenoh.io](http://zenoh.io) and the [roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed information. . ------------------------------- . ## Getting Started . Zenoh is extremely easy to learn, the best place to master the fundamentals is our [getting started guide](https://zenoh.io/docs/getting-started/first-app/). . ------------------------------- . ## How to install it . To install the latest release of the Zenoh router (`zenohd`) and its default plugins (REST API plugin and Storages Manager plugin) you can do as follows: . ### Manual installation (all platforms) . All release packages can be downloaded from [https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/). . Each subdirectory has the name of the Rust target. See the platforms each target corresponds to on [https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html). . Choose your platform and download the `.zip` file. Unzip it where you want, and run the extracted `zenohd` binary. . ### Linux Debian . Add Eclipse Zenoh private repository to the sources list, and install the `zenoh` package: . ```bash echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" | sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null sudo apt update sudo apt install zenoh ``` . Then you can start run `zenohd`. . ### MacOS . Tap our brew package repository and install the `zenoh` formula: . ```bash brew tap eclipse-zenoh/homebrew-zenoh brew install zenoh ``` . Then you can start run `zenohd`. . ------------------------------- . ## Rust API . * [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/) . ------------------------------- . ## How to build it . > [!WARNING] > Zenoh and its ecosystem are under active development. When you build from git, make sure you also build from git any other Zenoh repository you plan to use (e.g. binding, plugin, backend, etc.). It may happen that some changes in git are not compatible with the most recent packaged Zenoh release (e.g. deb, docker, pip). We put particular effort in maintaining compatibility between the various git repositories in the Zenoh project. . Install [Cargo and Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh can be successfully compiled with Rust stable (>= 1.75.0), so no special configuration is required from your side. If you already have the Rust toolchain installed, make sure it is up-to-date with: . ```bash rustup update ``` . To build Zenoh, just type the following command after having followed the previous instructions: . ```bash cargo build --release --all-targets ``` . Zenoh's router is built as `target/release/zenohd`. All the examples are built into the `target/release/examples` directory. They can all work in peer-to-peer, or interconnected via the zenoh router. . ------------------------------- . ## Quick tests of your build . ### Peer-to-peer tests . * **pub/sub** * run: `./target/release/examples/z_sub` * in another shell run: `./target/release/examples/z_put` * the subscriber should receive the publication. . * **get/queryable** * run: `./target/release/examples/z_queryable` * in another shell run: `./target/release/examples/z_get` * the queryable should display the log in its listener, and the get should receive the queryable result. . ### Routed tests . > [!NOTE] > **Windows users**: to properly execute the commands below in PowerShell you need to escape `"` characters as `\"`. . * **put / store / get** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell run: . ```sh ./target/release/examples/z_put` ``` . * then run . ```sh ./target/release/examples/z_get ``` . * the get should receive the stored publication. . * **REST API using `curl` tool** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, do a publication via the REST API: . ```sh curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test ``` . * get it back via the REST API: . ```sh curl http://localhost:8000/demo/example/test ``` . * **router admin space via the REST API** * run the Zenoh router with permission to perform config changes via the admin space, and with a memory storage: . ```sh ./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, get info of the zenoh router via the zenoh admin space (you may use `jq` for pretty json formatting): . ```sh curl -s http://localhost:8000/@/local/router | jq ``` . * get the volumes of the router (only memory by default): . ```sh curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq ``` . * get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . * add another memory storage on `/demo/mystore/**`: . ```sh curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore ``` . * check it has been created: . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . ### Configuration options . A Zenoh configuration file can be provided via CLI to all Zenoh examples and the Zenoh router. . * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and the available options. . See other examples of Zenoh usage in [examples/](examples) . > [!NOTE] > **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh allows for configuring the number of worker threads and other advanced options of the runtime. For guidance on utilizing it, please refer to the [doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html). . ------------------------------- . ## Zenoh router command line arguments . `zenohd` accepts the following arguments: . * `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write permissions on the admin space. Default is read only. * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All properties of this configuration are optional, so you may not need such a large configuration for your use-case. * `--cfg :`: allows you to change specific parts of the configuration right after it has been constructed. VALUE must be a valid JSON5 value, and key must be a path through the configuration file, where each element is separated by a `/`. When inserting in parts of the config that are arrays, you may use indexes, or may use `+` to indicate that you want to append your value to the array. `--cfg` passed values will always override any previously existing value for their key in the configuration. * `-l, --listen ...`: An endpoint on which this router will listen for incoming sessions. Repeat this option to open several listeners. By default, `tcp/[::]:7447` is used. The following endpoints are currently supported: * TCP: `tcp/:` * UDP: `udp/:` * [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:` * [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:` * `-e, --connect ...`: An endpoint this router will try to connect to. Repeat this option to connect to several peers or routers. * `--no-multicast-scouting`: By default zenohd replies to multicast scouting messages for being discovered by peers and clients. This option disables this feature. * `-i, --id `: The identifier (as an hexadecimal string - e.g.: A0B23...) that zenohd must use. **WARNING**: this identifier must be unique in the system! If not set, a random unsigned 128bit integer will be used. * `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each routed Data if there isn't already one. This option disables this feature. * `-P, --plugin [ | :]...`: A [plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted values: * a plugin name; zenohd will search for a library named `libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on MacOS or `zenoh_plugin_.dll` on Windows. * `":"`; the plugin will be loaded from library file at ``. . Repeat this option to load several plugins. * `--plugin-search-dir ...`: A directory where to search for [plugins](https://zenoh.io/docs/manual/plugins/) libraries to load. Repeat this option to specify several search directories'. By default, the plugins libraries will be searched in: `'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'` * `--rest-http-port `: Configures the [REST plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted values: * a port number * a string with format `:` (to bind the HTTP server to a specific interface) * `"None"` to deactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . ------------------------------- . ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version as `zenohd`, and using for `zenoh` dependency the same version (or commit number) as `zenohd` with the same set of features. A plugin compiled with different Rust version or with different set of `zenoh` crate features will be rejected when `zenohd` attempts to load it. Otherwise, incompatibilities in memory mapping of structures shared between `zenohd` and the library could lead to a `"SIGSEGV"` crash. . By default the Zenoh router is delivered or built with 2 plugins. These may be configured through a configuration file, or through individual changes to the configuration via the `--cfg` CLI option or via zenoh puts on individual parts of the configuration. . > [!WARNING] > Since `v0.6`, `zenohd` no longer loads every available plugin at startup. Instead, only configured plugins are loaded (after processing `--cfg` and `--plugin` options). Once `zenohd` is running, plugins can be hot-loaded and, if they support it, reconfigured at runtime by editing their configuration through the adminspace. . **[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST API): This plugin converts GET and PUT REST requests into Zenoh gets and puts respectively. . Note that to activate the REST plugin on `zenohd` the CLI argument should be passed: `--rest-http-port=8000` (or any other port of your choice). . **[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)** (managing [backends and storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes)) This plugin allows you to easily define storages. These will store key-value pairs they subscribed to, and send the most recent ones when queried. Check out [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them. . ------------------------------- . ## Troubleshooting . In case of troubles, please first check on [this page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble and cause are already known. Otherwise, you can ask a question on the [zenoh Discord server](https://discord.gg/vSDSpqnbkm), or [create an issue](https://github.com/eclipse-zenoh/zenoh/issues). Package: zenoh Version: 1.3.4 Architecture: amd64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 41 Depends: zenoh-plugin-rest (=1.3.4), zenoh-plugin-storage-manager (=1.3.4), zenohd (=1.3.4) Filename: 1.3.4/zenoh_1.3.4_amd64.deb Size: 17556 MD5sum: 275ae380dc457dfcaa33a2a4914c020f SHA1: ded62839301ec9fe3ce7747ce1916946d2eca3c3 SHA256: 8f886f59db13fe6d1aa638d78565a9af995fe019f15bbad2735c2e358e5713a5 Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol. . [![CI](https://github.com/eclipse-zenoh/zenoh/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![codecov](https://codecov.io/github/eclipse-zenoh/zenoh/branch/main/graph/badge.svg?token=F8T4C8WPZD)](https://codecov.io/github/eclipse-zenoh/zenoh) [![Discussion](https://img.shields.io/badge/discussion-on%20github-blue)](https://github.com/eclipse-zenoh/roadmap/discussions) [![Discord](https://img.shields.io/badge/chat-on%20discord-blue)](https://discord.gg/2GJ958VuHs) [![License](https://img.shields.io/badge/License-EPL%202.0-blue)](https://choosealicense.com/licenses/epl-2.0/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) . # Eclipse Zenoh . The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and computations. It carefully blends traditional pub/sub with geo-distributed storages, queries and computations, while retaining a level of time and space efficiency that is well beyond any of the mainstream stacks. . Check the website [zenoh.io](http://zenoh.io) and the [roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed information. . ------------------------------- . ## Getting Started . Zenoh is extremely easy to learn, the best place to master the fundamentals is our [getting started guide](https://zenoh.io/docs/getting-started/first-app/). . ------------------------------- . ## How to install it . To install the latest release of the Zenoh router (`zenohd`) and its default plugins (REST API plugin and Storages Manager plugin) you can do as follows: . ### Manual installation (all platforms) . All release packages can be downloaded from [https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/). . Each subdirectory has the name of the Rust target. See the platforms each target corresponds to on [https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html). . Choose your platform and download the `.zip` file. Unzip it where you want, and run the extracted `zenohd` binary. . ### Linux Debian . Add Eclipse Zenoh private repository to the sources list, and install the `zenoh` package: . ```bash echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" | sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null sudo apt update sudo apt install zenoh ``` . Then you can start run `zenohd`. . ### MacOS . Tap our brew package repository and install the `zenoh` formula: . ```bash brew tap eclipse-zenoh/homebrew-zenoh brew install zenoh ``` . Then you can start run `zenohd`. . ------------------------------- . ## Rust API . * [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/) . ------------------------------- . ## How to build it . > [!WARNING] > Zenoh and its ecosystem are under active development. When you build from git, make sure you also build from git any other Zenoh repository you plan to use (e.g. binding, plugin, backend, etc.). It may happen that some changes in git are not compatible with the most recent packaged Zenoh release (e.g. deb, docker, pip). We put particular effort in maintaining compatibility between the various git repositories in the Zenoh project. . Install [Cargo and Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh can be successfully compiled with Rust stable (>= 1.75.0), so no special configuration is required from your side. If you already have the Rust toolchain installed, make sure it is up-to-date with: . ```bash rustup update ``` . To build Zenoh, just type the following command after having followed the previous instructions: . ```bash cargo build --release --all-targets ``` . Zenoh's router is built as `target/release/zenohd`. All the examples are built into the `target/release/examples` directory. They can all work in peer-to-peer, or interconnected via the zenoh router. . ------------------------------- . ## Quick tests of your build . ### Peer-to-peer tests . * **pub/sub** * run: `./target/release/examples/z_sub` * in another shell run: `./target/release/examples/z_put` * the subscriber should receive the publication. . * **get/queryable** * run: `./target/release/examples/z_queryable` * in another shell run: `./target/release/examples/z_get` * the queryable should display the log in its listener, and the get should receive the queryable result. . ### Routed tests . > [!NOTE] > **Windows users**: to properly execute the commands below in PowerShell you need to escape `"` characters as `\"`. . * **put / store / get** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell run: . ```sh ./target/release/examples/z_put` ``` . * then run . ```sh ./target/release/examples/z_get ``` . * the get should receive the stored publication. . * **REST API using `curl` tool** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, do a publication via the REST API: . ```sh curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test ``` . * get it back via the REST API: . ```sh curl http://localhost:8000/demo/example/test ``` . * **router admin space via the REST API** * run the Zenoh router with permission to perform config changes via the admin space, and with a memory storage: . ```sh ./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, get info of the zenoh router via the zenoh admin space (you may use `jq` for pretty json formatting): . ```sh curl -s http://localhost:8000/@/local/router | jq ``` . * get the volumes of the router (only memory by default): . ```sh curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq ``` . * get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . * add another memory storage on `/demo/mystore/**`: . ```sh curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore ``` . * check it has been created: . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . ### Configuration options . A Zenoh configuration file can be provided via CLI to all Zenoh examples and the Zenoh router. . * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and the available options. . See other examples of Zenoh usage in [examples/](examples) . > [!NOTE] > **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh allows for configuring the number of worker threads and other advanced options of the runtime. For guidance on utilizing it, please refer to the [doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html). . ------------------------------- . ## Zenoh router command line arguments . `zenohd` accepts the following arguments: . * `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write permissions on the admin space. Default is read only. * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All properties of this configuration are optional, so you may not need such a large configuration for your use-case. * `--cfg :`: allows you to change specific parts of the configuration right after it has been constructed. VALUE must be a valid JSON5 value, and key must be a path through the configuration file, where each element is separated by a `/`. When inserting in parts of the config that are arrays, you may use indexes, or may use `+` to indicate that you want to append your value to the array. `--cfg` passed values will always override any previously existing value for their key in the configuration. * `-l, --listen ...`: An endpoint on which this router will listen for incoming sessions. Repeat this option to open several listeners. By default, `tcp/[::]:7447` is used. The following endpoints are currently supported: * TCP: `tcp/:` * UDP: `udp/:` * [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:` * [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:` * `-e, --connect ...`: An endpoint this router will try to connect to. Repeat this option to connect to several peers or routers. * `--no-multicast-scouting`: By default zenohd replies to multicast scouting messages for being discovered by peers and clients. This option disables this feature. * `-i, --id `: The identifier (as an hexadecimal string - e.g.: A0B23...) that zenohd must use. **WARNING**: this identifier must be unique in the system! If not set, a random unsigned 128bit integer will be used. * `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each routed Data if there isn't already one. This option disables this feature. * `-P, --plugin [ | :]...`: A [plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted values: * a plugin name; zenohd will search for a library named `libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on MacOS or `zenoh_plugin_.dll` on Windows. * `":"`; the plugin will be loaded from library file at ``. . Repeat this option to load several plugins. * `--plugin-search-dir ...`: A directory where to search for [plugins](https://zenoh.io/docs/manual/plugins/) libraries to load. Repeat this option to specify several search directories'. By default, the plugins libraries will be searched in: `'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'` * `--rest-http-port `: Configures the [REST plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted values: * a port number * a string with format `:` (to bind the HTTP server to a specific interface) * `"None"` to deactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . ------------------------------- . ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version as `zenohd`, and using for `zenoh` dependency the same version (or commit number) as `zenohd` with the same set of features. A plugin compiled with different Rust version or with different set of `zenoh` crate features will be rejected when `zenohd` attempts to load it. Otherwise, incompatibilities in memory mapping of structures shared between `zenohd` and the library could lead to a `"SIGSEGV"` crash. . By default the Zenoh router is delivered or built with 2 plugins. These may be configured through a configuration file, or through individual changes to the configuration via the `--cfg` CLI option or via zenoh puts on individual parts of the configuration. . > [!WARNING] > Since `v0.6`, `zenohd` no longer loads every available plugin at startup. Instead, only configured plugins are loaded (after processing `--cfg` and `--plugin` options). Once `zenohd` is running, plugins can be hot-loaded and, if they support it, reconfigured at runtime by editing their configuration through the adminspace. . **[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST API): This plugin converts GET and PUT REST requests into Zenoh gets and puts respectively. . Note that to activate the REST plugin on `zenohd` the CLI argument should be passed: `--rest-http-port=8000` (or any other port of your choice). . **[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)** (managing [backends and storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes)) This plugin allows you to easily define storages. These will store key-value pairs they subscribed to, and send the most recent ones when queried. Check out [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them. . ------------------------------- . ## Troubleshooting . In case of troubles, please first check on [this page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble and cause are already known. Otherwise, you can ask a question on the [zenoh Discord server](https://discord.gg/vSDSpqnbkm), or [create an issue](https://github.com/eclipse-zenoh/zenoh/issues). Package: zenoh Version: 1.3.4 Architecture: armhf Maintainer: zenoh-dev@eclipse.org Installed-Size: 41 Depends: zenoh-plugin-rest (=1.3.4), zenoh-plugin-storage-manager (=1.3.4), zenohd (=1.3.4) Filename: 1.3.4/zenoh_1.3.4_armhf.deb Size: 17552 MD5sum: 64870924434b7edc617c15140bac2eec SHA1: 62cccd9f55354c095d4612c1a41b6c895b88784b SHA256: bc213c60a1cbab6e554ff43f248483e151ad3098e61c7161f1f273d58853c8dd Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol. . [![CI](https://github.com/eclipse-zenoh/zenoh/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![codecov](https://codecov.io/github/eclipse-zenoh/zenoh/branch/main/graph/badge.svg?token=F8T4C8WPZD)](https://codecov.io/github/eclipse-zenoh/zenoh) [![Discussion](https://img.shields.io/badge/discussion-on%20github-blue)](https://github.com/eclipse-zenoh/roadmap/discussions) [![Discord](https://img.shields.io/badge/chat-on%20discord-blue)](https://discord.gg/2GJ958VuHs) [![License](https://img.shields.io/badge/License-EPL%202.0-blue)](https://choosealicense.com/licenses/epl-2.0/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) . # Eclipse Zenoh . The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and computations. It carefully blends traditional pub/sub with geo-distributed storages, queries and computations, while retaining a level of time and space efficiency that is well beyond any of the mainstream stacks. . Check the website [zenoh.io](http://zenoh.io) and the [roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed information. . ------------------------------- . ## Getting Started . Zenoh is extremely easy to learn, the best place to master the fundamentals is our [getting started guide](https://zenoh.io/docs/getting-started/first-app/). . ------------------------------- . ## How to install it . To install the latest release of the Zenoh router (`zenohd`) and its default plugins (REST API plugin and Storages Manager plugin) you can do as follows: . ### Manual installation (all platforms) . All release packages can be downloaded from [https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/). . Each subdirectory has the name of the Rust target. See the platforms each target corresponds to on [https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html). . Choose your platform and download the `.zip` file. Unzip it where you want, and run the extracted `zenohd` binary. . ### Linux Debian . Add Eclipse Zenoh private repository to the sources list, and install the `zenoh` package: . ```bash echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" | sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null sudo apt update sudo apt install zenoh ``` . Then you can start run `zenohd`. . ### MacOS . Tap our brew package repository and install the `zenoh` formula: . ```bash brew tap eclipse-zenoh/homebrew-zenoh brew install zenoh ``` . Then you can start run `zenohd`. . ------------------------------- . ## Rust API . * [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/) . ------------------------------- . ## How to build it . > [!WARNING] > Zenoh and its ecosystem are under active development. When you build from git, make sure you also build from git any other Zenoh repository you plan to use (e.g. binding, plugin, backend, etc.). It may happen that some changes in git are not compatible with the most recent packaged Zenoh release (e.g. deb, docker, pip). We put particular effort in maintaining compatibility between the various git repositories in the Zenoh project. . Install [Cargo and Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh can be successfully compiled with Rust stable (>= 1.75.0), so no special configuration is required from your side. If you already have the Rust toolchain installed, make sure it is up-to-date with: . ```bash rustup update ``` . To build Zenoh, just type the following command after having followed the previous instructions: . ```bash cargo build --release --all-targets ``` . Zenoh's router is built as `target/release/zenohd`. All the examples are built into the `target/release/examples` directory. They can all work in peer-to-peer, or interconnected via the zenoh router. . ------------------------------- . ## Quick tests of your build . ### Peer-to-peer tests . * **pub/sub** * run: `./target/release/examples/z_sub` * in another shell run: `./target/release/examples/z_put` * the subscriber should receive the publication. . * **get/queryable** * run: `./target/release/examples/z_queryable` * in another shell run: `./target/release/examples/z_get` * the queryable should display the log in its listener, and the get should receive the queryable result. . ### Routed tests . > [!NOTE] > **Windows users**: to properly execute the commands below in PowerShell you need to escape `"` characters as `\"`. . * **put / store / get** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell run: . ```sh ./target/release/examples/z_put` ``` . * then run . ```sh ./target/release/examples/z_get ``` . * the get should receive the stored publication. . * **REST API using `curl` tool** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, do a publication via the REST API: . ```sh curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test ``` . * get it back via the REST API: . ```sh curl http://localhost:8000/demo/example/test ``` . * **router admin space via the REST API** * run the Zenoh router with permission to perform config changes via the admin space, and with a memory storage: . ```sh ./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, get info of the zenoh router via the zenoh admin space (you may use `jq` for pretty json formatting): . ```sh curl -s http://localhost:8000/@/local/router | jq ``` . * get the volumes of the router (only memory by default): . ```sh curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq ``` . * get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . * add another memory storage on `/demo/mystore/**`: . ```sh curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore ``` . * check it has been created: . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . ### Configuration options . A Zenoh configuration file can be provided via CLI to all Zenoh examples and the Zenoh router. . * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and the available options. . See other examples of Zenoh usage in [examples/](examples) . > [!NOTE] > **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh allows for configuring the number of worker threads and other advanced options of the runtime. For guidance on utilizing it, please refer to the [doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html). . ------------------------------- . ## Zenoh router command line arguments . `zenohd` accepts the following arguments: . * `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write permissions on the admin space. Default is read only. * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All properties of this configuration are optional, so you may not need such a large configuration for your use-case. * `--cfg :`: allows you to change specific parts of the configuration right after it has been constructed. VALUE must be a valid JSON5 value, and key must be a path through the configuration file, where each element is separated by a `/`. When inserting in parts of the config that are arrays, you may use indexes, or may use `+` to indicate that you want to append your value to the array. `--cfg` passed values will always override any previously existing value for their key in the configuration. * `-l, --listen ...`: An endpoint on which this router will listen for incoming sessions. Repeat this option to open several listeners. By default, `tcp/[::]:7447` is used. The following endpoints are currently supported: * TCP: `tcp/:` * UDP: `udp/:` * [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:` * [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:` * `-e, --connect ...`: An endpoint this router will try to connect to. Repeat this option to connect to several peers or routers. * `--no-multicast-scouting`: By default zenohd replies to multicast scouting messages for being discovered by peers and clients. This option disables this feature. * `-i, --id `: The identifier (as an hexadecimal string - e.g.: A0B23...) that zenohd must use. **WARNING**: this identifier must be unique in the system! If not set, a random unsigned 128bit integer will be used. * `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each routed Data if there isn't already one. This option disables this feature. * `-P, --plugin [ | :]...`: A [plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted values: * a plugin name; zenohd will search for a library named `libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on MacOS or `zenoh_plugin_.dll` on Windows. * `":"`; the plugin will be loaded from library file at ``. . Repeat this option to load several plugins. * `--plugin-search-dir ...`: A directory where to search for [plugins](https://zenoh.io/docs/manual/plugins/) libraries to load. Repeat this option to specify several search directories'. By default, the plugins libraries will be searched in: `'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'` * `--rest-http-port `: Configures the [REST plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted values: * a port number * a string with format `:` (to bind the HTTP server to a specific interface) * `"None"` to deactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . ------------------------------- . ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version as `zenohd`, and using for `zenoh` dependency the same version (or commit number) as `zenohd` with the same set of features. A plugin compiled with different Rust version or with different set of `zenoh` crate features will be rejected when `zenohd` attempts to load it. Otherwise, incompatibilities in memory mapping of structures shared between `zenohd` and the library could lead to a `"SIGSEGV"` crash. . By default the Zenoh router is delivered or built with 2 plugins. These may be configured through a configuration file, or through individual changes to the configuration via the `--cfg` CLI option or via zenoh puts on individual parts of the configuration. . > [!WARNING] > Since `v0.6`, `zenohd` no longer loads every available plugin at startup. Instead, only configured plugins are loaded (after processing `--cfg` and `--plugin` options). Once `zenohd` is running, plugins can be hot-loaded and, if they support it, reconfigured at runtime by editing their configuration through the adminspace. . **[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST API): This plugin converts GET and PUT REST requests into Zenoh gets and puts respectively. . Note that to activate the REST plugin on `zenohd` the CLI argument should be passed: `--rest-http-port=8000` (or any other port of your choice). . **[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)** (managing [backends and storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes)) This plugin allows you to easily define storages. These will store key-value pairs they subscribed to, and send the most recent ones when queried. Check out [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them. . ------------------------------- . ## Troubleshooting . In case of troubles, please first check on [this page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble and cause are already known. Otherwise, you can ask a question on the [zenoh Discord server](https://discord.gg/vSDSpqnbkm), or [create an issue](https://github.com/eclipse-zenoh/zenoh/issues). Package: zenoh-plugin-rest Version: 1.3.4 Architecture: amd64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 4602 Depends: zenohd (=1.3.4) Filename: 1.3.4/zenoh-plugin-rest_1.3.4_amd64.deb Size: 1239764 MD5sum: b876a20d2092ae063de6b7e05bbd6d7d SHA1: f23974446dbc28a170808ff7221faaeec5f62f8c SHA256: bd57c3aa55a1ecd99ff686519a73d9d28785379795f02c68c5b7cd024a8b75af Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh REST plugin # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. It is not guaranteed that the API will remain unchanged in any version, including patch updates. It is highly recommended to depend solely on the zenoh and zenoh-ext crates and to utilize their public APIs. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Package: zenoh-plugin-rest Version: 1.3.4 Architecture: arm64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 4652 Depends: zenohd (=1.3.4) Filename: 1.3.4/zenoh-plugin-rest_1.3.4_arm64.deb Size: 1146952 MD5sum: 4ded8c3ead2d562a7eaac0c8c0407b99 SHA1: 29935a5215954fcd66f6ebb418805953672649e4 SHA256: 13c4369517d0cbef5d71b27f840f8e286c7cb6c09b59615d6c88dd009276706e Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh REST plugin # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. It is not guaranteed that the API will remain unchanged in any version, including patch updates. It is highly recommended to depend solely on the zenoh and zenoh-ext crates and to utilize their public APIs. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Package: zenoh-plugin-rest Version: 1.3.4 Architecture: armhf Maintainer: zenoh-dev@eclipse.org Installed-Size: 4309 Depends: zenohd (=1.3.4) Filename: 1.3.4/zenoh-plugin-rest_1.3.4_armhf.deb Size: 1181888 MD5sum: ead115ef4efa6b02b1d0d949e381a509 SHA1: 9c443a86ffb08b66567099e093178623b2d7430e SHA256: 1e1cf8ce2dcd77a8b0eae6b117b5e0d562b1b592220892b3b71ee38943d2e536 Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh REST plugin # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. It is not guaranteed that the API will remain unchanged in any version, including patch updates. It is highly recommended to depend solely on the zenoh and zenoh-ext crates and to utilize their public APIs. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Package: zenoh-plugin-rest Version: 1.3.4 Architecture: armel Maintainer: zenoh-dev@eclipse.org Installed-Size: 4382 Depends: zenohd (=1.3.4) Filename: 1.3.4/zenoh-plugin-rest_1.3.4_armel.deb Size: 1185448 MD5sum: 215efb2e7c00e8ab86b769e85aacf96f SHA1: 5862abedace2dc523d53445eda9eec99f25b25f6 SHA256: 21bea1c8419f1fa58f93813e98c06d2d468a1725f13563821008209a4a9a53f0 Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh REST plugin # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. It is not guaranteed that the API will remain unchanged in any version, including patch updates. It is highly recommended to depend solely on the zenoh and zenoh-ext crates and to utilize their public APIs. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Package: zenoh-plugin-storage-manager Version: 1.3.4 Architecture: armhf Maintainer: zenoh-dev@eclipse.org Installed-Size: 4039 Depends: zenohd (=1.3.4) Filename: 1.3.4/zenoh-plugin-storage-manager_1.3.4_armhf.deb Size: 1095484 MD5sum: a195a08d0a97b62dbb6326586ca4316a SHA1: 953f30b8e8f9cb4ec427ee22e277228fd2a41255 SHA256: dd8729ca9aeea9991dc45f9a5f64f5bfe4a7e7f1a0e50a5a4d5f30c0cef02dc8 Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh storages plugin. # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. It is not guaranteed that the API will remain unchanged in any version, including patch updates. It is highly recommended to depend solely on the zenoh and zenoh-ext crates and to utilize their public APIs. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Package: zenoh-plugin-storage-manager Version: 1.3.4 Architecture: armel Maintainer: zenoh-dev@eclipse.org Installed-Size: 4127 Depends: zenohd (=1.3.4) Filename: 1.3.4/zenoh-plugin-storage-manager_1.3.4_armel.deb Size: 1099056 MD5sum: 4edadbf9d72dd256f401fed83df9d7e9 SHA1: ae154b757290f45ca68960e2d1f98741d67e6c9a SHA256: 8690ff1ba529fc99467fd9951ef0ead54d59c8c07742f909f4ca43350397a069 Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh storages plugin. # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. It is not guaranteed that the API will remain unchanged in any version, including patch updates. It is highly recommended to depend solely on the zenoh and zenoh-ext crates and to utilize their public APIs. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Package: zenoh-plugin-storage-manager Version: 1.3.4 Architecture: arm64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 4369 Depends: zenohd (=1.3.4) Filename: 1.3.4/zenoh-plugin-storage-manager_1.3.4_arm64.deb Size: 1048788 MD5sum: 9c178e77f47c8b046bc1c35c67fd78bf SHA1: f15c8a7a2012c6d90175ef01597e6e6b2d3cb161 SHA256: b19273fcae761599537bb82916c34bf1a679f917eccbd54b5c7026cac8947dab Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh storages plugin. # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. It is not guaranteed that the API will remain unchanged in any version, including patch updates. It is highly recommended to depend solely on the zenoh and zenoh-ext crates and to utilize their public APIs. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Package: zenoh-plugin-storage-manager Version: 1.3.4 Architecture: amd64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 4341 Depends: zenohd (=1.3.4) Filename: 1.3.4/zenoh-plugin-storage-manager_1.3.4_amd64.deb Size: 1132536 MD5sum: 8f135cd97f4858b690695355794d6ad4 SHA1: d39ca9d3e1b9c6dbc131a604304c6a855af8ec88 SHA256: 633df3e27a80b8463f0bfd408d3d1f0987fa58bbcfe879810d48afa125b34f5f Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh storages plugin. # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. It is not guaranteed that the API will remain unchanged in any version, including patch updates. It is highly recommended to depend solely on the zenoh and zenoh-ext crates and to utilize their public APIs. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Package: zenohd Version: 1.3.4 Architecture: armel Maintainer: zenoh-dev@eclipse.org Installed-Size: 13293 Filename: 1.3.4/zenohd_1.3.4_armel.deb Size: 3634160 MD5sum: f21567b98e9f36c693bdf917724291d2 SHA1: 8f76fcc7311202b4266165e4947f7fa4a4214d67 SHA256: 8506b0d9357c6767732e27f9e58516be29b85699df3afede8c65218108f306e6 Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol. . [![CI](https://github.com/eclipse-zenoh/zenoh/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![codecov](https://codecov.io/github/eclipse-zenoh/zenoh/branch/main/graph/badge.svg?token=F8T4C8WPZD)](https://codecov.io/github/eclipse-zenoh/zenoh) [![Discussion](https://img.shields.io/badge/discussion-on%20github-blue)](https://github.com/eclipse-zenoh/roadmap/discussions) [![Discord](https://img.shields.io/badge/chat-on%20discord-blue)](https://discord.gg/2GJ958VuHs) [![License](https://img.shields.io/badge/License-EPL%202.0-blue)](https://choosealicense.com/licenses/epl-2.0/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) . # Eclipse Zenoh . The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and computations. It carefully blends traditional pub/sub with geo-distributed storages, queries and computations, while retaining a level of time and space efficiency that is well beyond any of the mainstream stacks. . Check the website [zenoh.io](http://zenoh.io) and the [roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed information. . ------------------------------- . ## Getting Started . Zenoh is extremely easy to learn, the best place to master the fundamentals is our [getting started guide](https://zenoh.io/docs/getting-started/first-app/). . ------------------------------- . ## How to install it . To install the latest release of the Zenoh router (`zenohd`) and its default plugins (REST API plugin and Storages Manager plugin) you can do as follows: . ### Manual installation (all platforms) . All release packages can be downloaded from [https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/). . Each subdirectory has the name of the Rust target. See the platforms each target corresponds to on [https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html). . Choose your platform and download the `.zip` file. Unzip it where you want, and run the extracted `zenohd` binary. . ### Linux Debian . Add Eclipse Zenoh private repository to the sources list, and install the `zenoh` package: . ```bash echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" | sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null sudo apt update sudo apt install zenoh ``` . Then you can start run `zenohd`. . ### MacOS . Tap our brew package repository and install the `zenoh` formula: . ```bash brew tap eclipse-zenoh/homebrew-zenoh brew install zenoh ``` . Then you can start run `zenohd`. . ------------------------------- . ## Rust API . * [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/) . ------------------------------- . ## How to build it . > [!WARNING] > Zenoh and its ecosystem are under active development. When you build from git, make sure you also build from git any other Zenoh repository you plan to use (e.g. binding, plugin, backend, etc.). It may happen that some changes in git are not compatible with the most recent packaged Zenoh release (e.g. deb, docker, pip). We put particular effort in maintaining compatibility between the various git repositories in the Zenoh project. . Install [Cargo and Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh can be successfully compiled with Rust stable (>= 1.75.0), so no special configuration is required from your side. If you already have the Rust toolchain installed, make sure it is up-to-date with: . ```bash rustup update ``` . To build Zenoh, just type the following command after having followed the previous instructions: . ```bash cargo build --release --all-targets ``` . Zenoh's router is built as `target/release/zenohd`. All the examples are built into the `target/release/examples` directory. They can all work in peer-to-peer, or interconnected via the zenoh router. . ------------------------------- . ## Quick tests of your build . ### Peer-to-peer tests . * **pub/sub** * run: `./target/release/examples/z_sub` * in another shell run: `./target/release/examples/z_put` * the subscriber should receive the publication. . * **get/queryable** * run: `./target/release/examples/z_queryable` * in another shell run: `./target/release/examples/z_get` * the queryable should display the log in its listener, and the get should receive the queryable result. . ### Routed tests . > [!NOTE] > **Windows users**: to properly execute the commands below in PowerShell you need to escape `"` characters as `\"`. . * **put / store / get** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell run: . ```sh ./target/release/examples/z_put` ``` . * then run . ```sh ./target/release/examples/z_get ``` . * the get should receive the stored publication. . * **REST API using `curl` tool** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, do a publication via the REST API: . ```sh curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test ``` . * get it back via the REST API: . ```sh curl http://localhost:8000/demo/example/test ``` . * **router admin space via the REST API** * run the Zenoh router with permission to perform config changes via the admin space, and with a memory storage: . ```sh ./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, get info of the zenoh router via the zenoh admin space (you may use `jq` for pretty json formatting): . ```sh curl -s http://localhost:8000/@/local/router | jq ``` . * get the volumes of the router (only memory by default): . ```sh curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq ``` . * get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . * add another memory storage on `/demo/mystore/**`: . ```sh curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore ``` . * check it has been created: . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . ### Configuration options . A Zenoh configuration file can be provided via CLI to all Zenoh examples and the Zenoh router. . * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and the available options. . See other examples of Zenoh usage in [examples/](examples) . > [!NOTE] > **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh allows for configuring the number of worker threads and other advanced options of the runtime. For guidance on utilizing it, please refer to the [doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html). . ------------------------------- . ## Zenoh router command line arguments . `zenohd` accepts the following arguments: . * `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write permissions on the admin space. Default is read only. * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All properties of this configuration are optional, so you may not need such a large configuration for your use-case. * `--cfg :`: allows you to change specific parts of the configuration right after it has been constructed. VALUE must be a valid JSON5 value, and key must be a path through the configuration file, where each element is separated by a `/`. When inserting in parts of the config that are arrays, you may use indexes, or may use `+` to indicate that you want to append your value to the array. `--cfg` passed values will always override any previously existing value for their key in the configuration. * `-l, --listen ...`: An endpoint on which this router will listen for incoming sessions. Repeat this option to open several listeners. By default, `tcp/[::]:7447` is used. The following endpoints are currently supported: * TCP: `tcp/:` * UDP: `udp/:` * [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:` * [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:` * `-e, --connect ...`: An endpoint this router will try to connect to. Repeat this option to connect to several peers or routers. * `--no-multicast-scouting`: By default zenohd replies to multicast scouting messages for being discovered by peers and clients. This option disables this feature. * `-i, --id `: The identifier (as an hexadecimal string - e.g.: A0B23...) that zenohd must use. **WARNING**: this identifier must be unique in the system! If not set, a random unsigned 128bit integer will be used. * `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each routed Data if there isn't already one. This option disables this feature. * `-P, --plugin [ | :]...`: A [plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted values: * a plugin name; zenohd will search for a library named `libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on MacOS or `zenoh_plugin_.dll` on Windows. * `":"`; the plugin will be loaded from library file at ``. . Repeat this option to load several plugins. * `--plugin-search-dir ...`: A directory where to search for [plugins](https://zenoh.io/docs/manual/plugins/) libraries to load. Repeat this option to specify several search directories'. By default, the plugins libraries will be searched in: `'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'` * `--rest-http-port `: Configures the [REST plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted values: * a port number * a string with format `:` (to bind the HTTP server to a specific interface) * `"None"` to deactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . ------------------------------- . ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version as `zenohd`, and using for `zenoh` dependency the same version (or commit number) as `zenohd` with the same set of features. A plugin compiled with different Rust version or with different set of `zenoh` crate features will be rejected when `zenohd` attempts to load it. Otherwise, incompatibilities in memory mapping of structures shared between `zenohd` and the library could lead to a `"SIGSEGV"` crash. . By default the Zenoh router is delivered or built with 2 plugins. These may be configured through a configuration file, or through individual changes to the configuration via the `--cfg` CLI option or via zenoh puts on individual parts of the configuration. . > [!WARNING] > Since `v0.6`, `zenohd` no longer loads every available plugin at startup. Instead, only configured plugins are loaded (after processing `--cfg` and `--plugin` options). Once `zenohd` is running, plugins can be hot-loaded and, if they support it, reconfigured at runtime by editing their configuration through the adminspace. . **[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST API): This plugin converts GET and PUT REST requests into Zenoh gets and puts respectively. . Note that to activate the REST plugin on `zenohd` the CLI argument should be passed: `--rest-http-port=8000` (or any other port of your choice). . **[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)** (managing [backends and storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes)) This plugin allows you to easily define storages. These will store key-value pairs they subscribed to, and send the most recent ones when queried. Check out [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them. . ------------------------------- . ## Troubleshooting . In case of troubles, please first check on [this page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble and cause are already known. Otherwise, you can ask a question on the [zenoh Discord server](https://discord.gg/vSDSpqnbkm), or [create an issue](https://github.com/eclipse-zenoh/zenoh/issues). Package: zenohd Version: 1.3.4 Architecture: armhf Maintainer: zenoh-dev@eclipse.org Installed-Size: 13021 Filename: 1.3.4/zenohd_1.3.4_armhf.deb Size: 3653348 MD5sum: 5672435dc89b04312edfddaa3b56fc2c SHA1: 1e0c5aec4a17047b4a5e9be26c02eeed99bf9ec0 SHA256: bc12e3c9f7dfc0a2d0f057d2c6d9e2f8d38040a24aeaa78d00df615d238a1991 Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol. . [![CI](https://github.com/eclipse-zenoh/zenoh/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![codecov](https://codecov.io/github/eclipse-zenoh/zenoh/branch/main/graph/badge.svg?token=F8T4C8WPZD)](https://codecov.io/github/eclipse-zenoh/zenoh) [![Discussion](https://img.shields.io/badge/discussion-on%20github-blue)](https://github.com/eclipse-zenoh/roadmap/discussions) [![Discord](https://img.shields.io/badge/chat-on%20discord-blue)](https://discord.gg/2GJ958VuHs) [![License](https://img.shields.io/badge/License-EPL%202.0-blue)](https://choosealicense.com/licenses/epl-2.0/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) . # Eclipse Zenoh . The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and computations. It carefully blends traditional pub/sub with geo-distributed storages, queries and computations, while retaining a level of time and space efficiency that is well beyond any of the mainstream stacks. . Check the website [zenoh.io](http://zenoh.io) and the [roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed information. . ------------------------------- . ## Getting Started . Zenoh is extremely easy to learn, the best place to master the fundamentals is our [getting started guide](https://zenoh.io/docs/getting-started/first-app/). . ------------------------------- . ## How to install it . To install the latest release of the Zenoh router (`zenohd`) and its default plugins (REST API plugin and Storages Manager plugin) you can do as follows: . ### Manual installation (all platforms) . All release packages can be downloaded from [https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/). . Each subdirectory has the name of the Rust target. See the platforms each target corresponds to on [https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html). . Choose your platform and download the `.zip` file. Unzip it where you want, and run the extracted `zenohd` binary. . ### Linux Debian . Add Eclipse Zenoh private repository to the sources list, and install the `zenoh` package: . ```bash echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" | sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null sudo apt update sudo apt install zenoh ``` . Then you can start run `zenohd`. . ### MacOS . Tap our brew package repository and install the `zenoh` formula: . ```bash brew tap eclipse-zenoh/homebrew-zenoh brew install zenoh ``` . Then you can start run `zenohd`. . ------------------------------- . ## Rust API . * [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/) . ------------------------------- . ## How to build it . > [!WARNING] > Zenoh and its ecosystem are under active development. When you build from git, make sure you also build from git any other Zenoh repository you plan to use (e.g. binding, plugin, backend, etc.). It may happen that some changes in git are not compatible with the most recent packaged Zenoh release (e.g. deb, docker, pip). We put particular effort in maintaining compatibility between the various git repositories in the Zenoh project. . Install [Cargo and Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh can be successfully compiled with Rust stable (>= 1.75.0), so no special configuration is required from your side. If you already have the Rust toolchain installed, make sure it is up-to-date with: . ```bash rustup update ``` . To build Zenoh, just type the following command after having followed the previous instructions: . ```bash cargo build --release --all-targets ``` . Zenoh's router is built as `target/release/zenohd`. All the examples are built into the `target/release/examples` directory. They can all work in peer-to-peer, or interconnected via the zenoh router. . ------------------------------- . ## Quick tests of your build . ### Peer-to-peer tests . * **pub/sub** * run: `./target/release/examples/z_sub` * in another shell run: `./target/release/examples/z_put` * the subscriber should receive the publication. . * **get/queryable** * run: `./target/release/examples/z_queryable` * in another shell run: `./target/release/examples/z_get` * the queryable should display the log in its listener, and the get should receive the queryable result. . ### Routed tests . > [!NOTE] > **Windows users**: to properly execute the commands below in PowerShell you need to escape `"` characters as `\"`. . * **put / store / get** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell run: . ```sh ./target/release/examples/z_put` ``` . * then run . ```sh ./target/release/examples/z_get ``` . * the get should receive the stored publication. . * **REST API using `curl` tool** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, do a publication via the REST API: . ```sh curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test ``` . * get it back via the REST API: . ```sh curl http://localhost:8000/demo/example/test ``` . * **router admin space via the REST API** * run the Zenoh router with permission to perform config changes via the admin space, and with a memory storage: . ```sh ./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, get info of the zenoh router via the zenoh admin space (you may use `jq` for pretty json formatting): . ```sh curl -s http://localhost:8000/@/local/router | jq ``` . * get the volumes of the router (only memory by default): . ```sh curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq ``` . * get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . * add another memory storage on `/demo/mystore/**`: . ```sh curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore ``` . * check it has been created: . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . ### Configuration options . A Zenoh configuration file can be provided via CLI to all Zenoh examples and the Zenoh router. . * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and the available options. . See other examples of Zenoh usage in [examples/](examples) . > [!NOTE] > **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh allows for configuring the number of worker threads and other advanced options of the runtime. For guidance on utilizing it, please refer to the [doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html). . ------------------------------- . ## Zenoh router command line arguments . `zenohd` accepts the following arguments: . * `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write permissions on the admin space. Default is read only. * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All properties of this configuration are optional, so you may not need such a large configuration for your use-case. * `--cfg :`: allows you to change specific parts of the configuration right after it has been constructed. VALUE must be a valid JSON5 value, and key must be a path through the configuration file, where each element is separated by a `/`. When inserting in parts of the config that are arrays, you may use indexes, or may use `+` to indicate that you want to append your value to the array. `--cfg` passed values will always override any previously existing value for their key in the configuration. * `-l, --listen ...`: An endpoint on which this router will listen for incoming sessions. Repeat this option to open several listeners. By default, `tcp/[::]:7447` is used. The following endpoints are currently supported: * TCP: `tcp/:` * UDP: `udp/:` * [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:` * [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:` * `-e, --connect ...`: An endpoint this router will try to connect to. Repeat this option to connect to several peers or routers. * `--no-multicast-scouting`: By default zenohd replies to multicast scouting messages for being discovered by peers and clients. This option disables this feature. * `-i, --id `: The identifier (as an hexadecimal string - e.g.: A0B23...) that zenohd must use. **WARNING**: this identifier must be unique in the system! If not set, a random unsigned 128bit integer will be used. * `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each routed Data if there isn't already one. This option disables this feature. * `-P, --plugin [ | :]...`: A [plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted values: * a plugin name; zenohd will search for a library named `libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on MacOS or `zenoh_plugin_.dll` on Windows. * `":"`; the plugin will be loaded from library file at ``. . Repeat this option to load several plugins. * `--plugin-search-dir ...`: A directory where to search for [plugins](https://zenoh.io/docs/manual/plugins/) libraries to load. Repeat this option to specify several search directories'. By default, the plugins libraries will be searched in: `'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'` * `--rest-http-port `: Configures the [REST plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted values: * a port number * a string with format `:` (to bind the HTTP server to a specific interface) * `"None"` to deactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . ------------------------------- . ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version as `zenohd`, and using for `zenoh` dependency the same version (or commit number) as `zenohd` with the same set of features. A plugin compiled with different Rust version or with different set of `zenoh` crate features will be rejected when `zenohd` attempts to load it. Otherwise, incompatibilities in memory mapping of structures shared between `zenohd` and the library could lead to a `"SIGSEGV"` crash. . By default the Zenoh router is delivered or built with 2 plugins. These may be configured through a configuration file, or through individual changes to the configuration via the `--cfg` CLI option or via zenoh puts on individual parts of the configuration. . > [!WARNING] > Since `v0.6`, `zenohd` no longer loads every available plugin at startup. Instead, only configured plugins are loaded (after processing `--cfg` and `--plugin` options). Once `zenohd` is running, plugins can be hot-loaded and, if they support it, reconfigured at runtime by editing their configuration through the adminspace. . **[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST API): This plugin converts GET and PUT REST requests into Zenoh gets and puts respectively. . Note that to activate the REST plugin on `zenohd` the CLI argument should be passed: `--rest-http-port=8000` (or any other port of your choice). . **[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)** (managing [backends and storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes)) This plugin allows you to easily define storages. These will store key-value pairs they subscribed to, and send the most recent ones when queried. Check out [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them. . ------------------------------- . ## Troubleshooting . In case of troubles, please first check on [this page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble and cause are already known. Otherwise, you can ask a question on the [zenoh Discord server](https://discord.gg/vSDSpqnbkm), or [create an issue](https://github.com/eclipse-zenoh/zenoh/issues). Package: zenohd Version: 1.3.4 Architecture: arm64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 12633 Filename: 1.3.4/zenohd_1.3.4_arm64.deb Size: 3467564 MD5sum: 6208f9841026c05ed389111ad69467cc SHA1: d9dec784ef339dd0d6895441ee20b6176ba359aa SHA256: 3bbda156bba71aff71959a05999d48f1f09b87423c9e22578539eaa81096da46 Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol. . [![CI](https://github.com/eclipse-zenoh/zenoh/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![codecov](https://codecov.io/github/eclipse-zenoh/zenoh/branch/main/graph/badge.svg?token=F8T4C8WPZD)](https://codecov.io/github/eclipse-zenoh/zenoh) [![Discussion](https://img.shields.io/badge/discussion-on%20github-blue)](https://github.com/eclipse-zenoh/roadmap/discussions) [![Discord](https://img.shields.io/badge/chat-on%20discord-blue)](https://discord.gg/2GJ958VuHs) [![License](https://img.shields.io/badge/License-EPL%202.0-blue)](https://choosealicense.com/licenses/epl-2.0/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) . # Eclipse Zenoh . The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and computations. It carefully blends traditional pub/sub with geo-distributed storages, queries and computations, while retaining a level of time and space efficiency that is well beyond any of the mainstream stacks. . Check the website [zenoh.io](http://zenoh.io) and the [roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed information. . ------------------------------- . ## Getting Started . Zenoh is extremely easy to learn, the best place to master the fundamentals is our [getting started guide](https://zenoh.io/docs/getting-started/first-app/). . ------------------------------- . ## How to install it . To install the latest release of the Zenoh router (`zenohd`) and its default plugins (REST API plugin and Storages Manager plugin) you can do as follows: . ### Manual installation (all platforms) . All release packages can be downloaded from [https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/). . Each subdirectory has the name of the Rust target. See the platforms each target corresponds to on [https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html). . Choose your platform and download the `.zip` file. Unzip it where you want, and run the extracted `zenohd` binary. . ### Linux Debian . Add Eclipse Zenoh private repository to the sources list, and install the `zenoh` package: . ```bash echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" | sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null sudo apt update sudo apt install zenoh ``` . Then you can start run `zenohd`. . ### MacOS . Tap our brew package repository and install the `zenoh` formula: . ```bash brew tap eclipse-zenoh/homebrew-zenoh brew install zenoh ``` . Then you can start run `zenohd`. . ------------------------------- . ## Rust API . * [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/) . ------------------------------- . ## How to build it . > [!WARNING] > Zenoh and its ecosystem are under active development. When you build from git, make sure you also build from git any other Zenoh repository you plan to use (e.g. binding, plugin, backend, etc.). It may happen that some changes in git are not compatible with the most recent packaged Zenoh release (e.g. deb, docker, pip). We put particular effort in maintaining compatibility between the various git repositories in the Zenoh project. . Install [Cargo and Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh can be successfully compiled with Rust stable (>= 1.75.0), so no special configuration is required from your side. If you already have the Rust toolchain installed, make sure it is up-to-date with: . ```bash rustup update ``` . To build Zenoh, just type the following command after having followed the previous instructions: . ```bash cargo build --release --all-targets ``` . Zenoh's router is built as `target/release/zenohd`. All the examples are built into the `target/release/examples` directory. They can all work in peer-to-peer, or interconnected via the zenoh router. . ------------------------------- . ## Quick tests of your build . ### Peer-to-peer tests . * **pub/sub** * run: `./target/release/examples/z_sub` * in another shell run: `./target/release/examples/z_put` * the subscriber should receive the publication. . * **get/queryable** * run: `./target/release/examples/z_queryable` * in another shell run: `./target/release/examples/z_get` * the queryable should display the log in its listener, and the get should receive the queryable result. . ### Routed tests . > [!NOTE] > **Windows users**: to properly execute the commands below in PowerShell you need to escape `"` characters as `\"`. . * **put / store / get** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell run: . ```sh ./target/release/examples/z_put` ``` . * then run . ```sh ./target/release/examples/z_get ``` . * the get should receive the stored publication. . * **REST API using `curl` tool** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, do a publication via the REST API: . ```sh curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test ``` . * get it back via the REST API: . ```sh curl http://localhost:8000/demo/example/test ``` . * **router admin space via the REST API** * run the Zenoh router with permission to perform config changes via the admin space, and with a memory storage: . ```sh ./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, get info of the zenoh router via the zenoh admin space (you may use `jq` for pretty json formatting): . ```sh curl -s http://localhost:8000/@/local/router | jq ``` . * get the volumes of the router (only memory by default): . ```sh curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq ``` . * get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . * add another memory storage on `/demo/mystore/**`: . ```sh curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore ``` . * check it has been created: . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . ### Configuration options . A Zenoh configuration file can be provided via CLI to all Zenoh examples and the Zenoh router. . * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and the available options. . See other examples of Zenoh usage in [examples/](examples) . > [!NOTE] > **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh allows for configuring the number of worker threads and other advanced options of the runtime. For guidance on utilizing it, please refer to the [doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html). . ------------------------------- . ## Zenoh router command line arguments . `zenohd` accepts the following arguments: . * `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write permissions on the admin space. Default is read only. * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All properties of this configuration are optional, so you may not need such a large configuration for your use-case. * `--cfg :`: allows you to change specific parts of the configuration right after it has been constructed. VALUE must be a valid JSON5 value, and key must be a path through the configuration file, where each element is separated by a `/`. When inserting in parts of the config that are arrays, you may use indexes, or may use `+` to indicate that you want to append your value to the array. `--cfg` passed values will always override any previously existing value for their key in the configuration. * `-l, --listen ...`: An endpoint on which this router will listen for incoming sessions. Repeat this option to open several listeners. By default, `tcp/[::]:7447` is used. The following endpoints are currently supported: * TCP: `tcp/:` * UDP: `udp/:` * [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:` * [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:` * `-e, --connect ...`: An endpoint this router will try to connect to. Repeat this option to connect to several peers or routers. * `--no-multicast-scouting`: By default zenohd replies to multicast scouting messages for being discovered by peers and clients. This option disables this feature. * `-i, --id `: The identifier (as an hexadecimal string - e.g.: A0B23...) that zenohd must use. **WARNING**: this identifier must be unique in the system! If not set, a random unsigned 128bit integer will be used. * `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each routed Data if there isn't already one. This option disables this feature. * `-P, --plugin [ | :]...`: A [plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted values: * a plugin name; zenohd will search for a library named `libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on MacOS or `zenoh_plugin_.dll` on Windows. * `":"`; the plugin will be loaded from library file at ``. . Repeat this option to load several plugins. * `--plugin-search-dir ...`: A directory where to search for [plugins](https://zenoh.io/docs/manual/plugins/) libraries to load. Repeat this option to specify several search directories'. By default, the plugins libraries will be searched in: `'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'` * `--rest-http-port `: Configures the [REST plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted values: * a port number * a string with format `:` (to bind the HTTP server to a specific interface) * `"None"` to deactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . ------------------------------- . ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version as `zenohd`, and using for `zenoh` dependency the same version (or commit number) as `zenohd` with the same set of features. A plugin compiled with different Rust version or with different set of `zenoh` crate features will be rejected when `zenohd` attempts to load it. Otherwise, incompatibilities in memory mapping of structures shared between `zenohd` and the library could lead to a `"SIGSEGV"` crash. . By default the Zenoh router is delivered or built with 2 plugins. These may be configured through a configuration file, or through individual changes to the configuration via the `--cfg` CLI option or via zenoh puts on individual parts of the configuration. . > [!WARNING] > Since `v0.6`, `zenohd` no longer loads every available plugin at startup. Instead, only configured plugins are loaded (after processing `--cfg` and `--plugin` options). Once `zenohd` is running, plugins can be hot-loaded and, if they support it, reconfigured at runtime by editing their configuration through the adminspace. . **[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST API): This plugin converts GET and PUT REST requests into Zenoh gets and puts respectively. . Note that to activate the REST plugin on `zenohd` the CLI argument should be passed: `--rest-http-port=8000` (or any other port of your choice). . **[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)** (managing [backends and storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes)) This plugin allows you to easily define storages. These will store key-value pairs they subscribed to, and send the most recent ones when queried. Check out [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them. . ------------------------------- . ## Troubleshooting . In case of troubles, please first check on [this page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble and cause are already known. Otherwise, you can ask a question on the [zenoh Discord server](https://discord.gg/vSDSpqnbkm), or [create an issue](https://github.com/eclipse-zenoh/zenoh/issues). Package: zenohd Version: 1.3.4 Architecture: amd64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 13972 Depends: libc6 (>= 2.34) Filename: 1.3.4/zenohd_1.3.4_amd64.deb Size: 3885596 MD5sum: 9c538397c12a0a8edd634ab97abe18c8 SHA1: efbcb6aefe2565e246f5d300ddfda1c3742447ec SHA256: a7bb17e381d069aaf0ff7ee47c02485f7234f68e8c98d128072616bd5351047f Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol. . [![CI](https://github.com/eclipse-zenoh/zenoh/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![codecov](https://codecov.io/github/eclipse-zenoh/zenoh/branch/main/graph/badge.svg?token=F8T4C8WPZD)](https://codecov.io/github/eclipse-zenoh/zenoh) [![Discussion](https://img.shields.io/badge/discussion-on%20github-blue)](https://github.com/eclipse-zenoh/roadmap/discussions) [![Discord](https://img.shields.io/badge/chat-on%20discord-blue)](https://discord.gg/2GJ958VuHs) [![License](https://img.shields.io/badge/License-EPL%202.0-blue)](https://choosealicense.com/licenses/epl-2.0/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) . # Eclipse Zenoh . The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and computations. It carefully blends traditional pub/sub with geo-distributed storages, queries and computations, while retaining a level of time and space efficiency that is well beyond any of the mainstream stacks. . Check the website [zenoh.io](http://zenoh.io) and the [roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed information. . ------------------------------- . ## Getting Started . Zenoh is extremely easy to learn, the best place to master the fundamentals is our [getting started guide](https://zenoh.io/docs/getting-started/first-app/). . ------------------------------- . ## How to install it . To install the latest release of the Zenoh router (`zenohd`) and its default plugins (REST API plugin and Storages Manager plugin) you can do as follows: . ### Manual installation (all platforms) . All release packages can be downloaded from [https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/). . Each subdirectory has the name of the Rust target. See the platforms each target corresponds to on [https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html). . Choose your platform and download the `.zip` file. Unzip it where you want, and run the extracted `zenohd` binary. . ### Linux Debian . Add Eclipse Zenoh private repository to the sources list, and install the `zenoh` package: . ```bash echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" | sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null sudo apt update sudo apt install zenoh ``` . Then you can start run `zenohd`. . ### MacOS . Tap our brew package repository and install the `zenoh` formula: . ```bash brew tap eclipse-zenoh/homebrew-zenoh brew install zenoh ``` . Then you can start run `zenohd`. . ------------------------------- . ## Rust API . * [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/) . ------------------------------- . ## How to build it . > [!WARNING] > Zenoh and its ecosystem are under active development. When you build from git, make sure you also build from git any other Zenoh repository you plan to use (e.g. binding, plugin, backend, etc.). It may happen that some changes in git are not compatible with the most recent packaged Zenoh release (e.g. deb, docker, pip). We put particular effort in maintaining compatibility between the various git repositories in the Zenoh project. . Install [Cargo and Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh can be successfully compiled with Rust stable (>= 1.75.0), so no special configuration is required from your side. If you already have the Rust toolchain installed, make sure it is up-to-date with: . ```bash rustup update ``` . To build Zenoh, just type the following command after having followed the previous instructions: . ```bash cargo build --release --all-targets ``` . Zenoh's router is built as `target/release/zenohd`. All the examples are built into the `target/release/examples` directory. They can all work in peer-to-peer, or interconnected via the zenoh router. . ------------------------------- . ## Quick tests of your build . ### Peer-to-peer tests . * **pub/sub** * run: `./target/release/examples/z_sub` * in another shell run: `./target/release/examples/z_put` * the subscriber should receive the publication. . * **get/queryable** * run: `./target/release/examples/z_queryable` * in another shell run: `./target/release/examples/z_get` * the queryable should display the log in its listener, and the get should receive the queryable result. . ### Routed tests . > [!NOTE] > **Windows users**: to properly execute the commands below in PowerShell you need to escape `"` characters as `\"`. . * **put / store / get** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell run: . ```sh ./target/release/examples/z_put` ``` . * then run . ```sh ./target/release/examples/z_get ``` . * the get should receive the stored publication. . * **REST API using `curl` tool** * run the Zenoh router with a memory storage: . ```sh ./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, do a publication via the REST API: . ```sh curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test ``` . * get it back via the REST API: . ```sh curl http://localhost:8000/demo/example/test ``` . * **router admin space via the REST API** * run the Zenoh router with permission to perform config changes via the admin space, and with a memory storage: . ```sh ./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}' ``` . * in another shell, get info of the zenoh router via the zenoh admin space (you may use `jq` for pretty json formatting): . ```sh curl -s http://localhost:8000/@/local/router | jq ``` . * get the volumes of the router (only memory by default): . ```sh curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq ``` . * get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . * add another memory storage on `/demo/mystore/**`: . ```sh curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore ``` . * check it has been created: . ```sh curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq ``` . ### Configuration options . A Zenoh configuration file can be provided via CLI to all Zenoh examples and the Zenoh router. . * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and the available options. . See other examples of Zenoh usage in [examples/](examples) . > [!NOTE] > **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh allows for configuring the number of worker threads and other advanced options of the runtime. For guidance on utilizing it, please refer to the [doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html). . ------------------------------- . ## Zenoh router command line arguments . `zenohd` accepts the following arguments: . * `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write permissions on the admin space. Default is read only. * `-c, --config `: a [JSON5](https://json5.org) configuration file. [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All properties of this configuration are optional, so you may not need such a large configuration for your use-case. * `--cfg :`: allows you to change specific parts of the configuration right after it has been constructed. VALUE must be a valid JSON5 value, and key must be a path through the configuration file, where each element is separated by a `/`. When inserting in parts of the config that are arrays, you may use indexes, or may use `+` to indicate that you want to append your value to the array. `--cfg` passed values will always override any previously existing value for their key in the configuration. * `-l, --listen ...`: An endpoint on which this router will listen for incoming sessions. Repeat this option to open several listeners. By default, `tcp/[::]:7447` is used. The following endpoints are currently supported: * TCP: `tcp/:` * UDP: `udp/:` * [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:` * [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:` * `-e, --connect ...`: An endpoint this router will try to connect to. Repeat this option to connect to several peers or routers. * `--no-multicast-scouting`: By default zenohd replies to multicast scouting messages for being discovered by peers and clients. This option disables this feature. * `-i, --id `: The identifier (as an hexadecimal string - e.g.: A0B23...) that zenohd must use. **WARNING**: this identifier must be unique in the system! If not set, a random unsigned 128bit integer will be used. * `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each routed Data if there isn't already one. This option disables this feature. * `-P, --plugin [ | :]...`: A [plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted values: * a plugin name; zenohd will search for a library named `libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on MacOS or `zenoh_plugin_.dll` on Windows. * `":"`; the plugin will be loaded from library file at ``. . Repeat this option to load several plugins. * `--plugin-search-dir ...`: A directory where to search for [plugins](https://zenoh.io/docs/manual/plugins/) libraries to load. Repeat this option to specify several search directories'. By default, the plugins libraries will be searched in: `'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'` * `--rest-http-port `: Configures the [REST plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted values: * a port number * a string with format `:` (to bind the HTTP server to a specific interface) * `"None"` to deactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . ------------------------------- . ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version as `zenohd`, and using for `zenoh` dependency the same version (or commit number) as `zenohd` with the same set of features. A plugin compiled with different Rust version or with different set of `zenoh` crate features will be rejected when `zenohd` attempts to load it. Otherwise, incompatibilities in memory mapping of structures shared between `zenohd` and the library could lead to a `"SIGSEGV"` crash. . By default the Zenoh router is delivered or built with 2 plugins. These may be configured through a configuration file, or through individual changes to the configuration via the `--cfg` CLI option or via zenoh puts on individual parts of the configuration. . > [!WARNING] > Since `v0.6`, `zenohd` no longer loads every available plugin at startup. Instead, only configured plugins are loaded (after processing `--cfg` and `--plugin` options). Once `zenohd` is running, plugins can be hot-loaded and, if they support it, reconfigured at runtime by editing their configuration through the adminspace. . **[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST API): This plugin converts GET and PUT REST requests into Zenoh gets and puts respectively. . Note that to activate the REST plugin on `zenohd` the CLI argument should be passed: `--rest-http-port=8000` (or any other port of your choice). . **[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)** (managing [backends and storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes)) This plugin allows you to easily define storages. These will store key-value pairs they subscribed to, and send the most recent ones when queried. Check out [DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them. . ------------------------------- . ## Troubleshooting . In case of troubles, please first check on [this page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble and cause are already known. Otherwise, you can ask a question on the [zenoh Discord server](https://discord.gg/vSDSpqnbkm), or [create an issue](https://github.com/eclipse-zenoh/zenoh/issues).