Package: zenoh Version: 0.11.0-rc.3 Architecture: arm64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 40 Depends: zenohd (=0.11.0-rc.3), zenoh-plugin-rest (=0.11.0-rc.3), zenoh-plugin-storage-manager (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh_0.11.0-rc.3_arm64.deb Size: 17496 MD5sum: b8c6eb4948284b04807c7ad57a455e34 SHA1: 8e9a0ac7a3c8f21acd5a53264a0d3acea7534d4c SHA256: dc1622bf8f3d26d6b5f0205bdff99fcbabd1c89ab5d2a97e8171485033f5e0d9 Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . [![CI](https://github.com/eclipse-zenoh/zenoh/workflows/CI/badge.svg)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3A%22CI%22) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![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/ . 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 . 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 . ------------------------------- ## 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 mantaining 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 succesfully compiled with Rust stable (>= 1.71.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: `./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'` - in another shell run: `./target/release/examples/z_put` - then run `./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: `./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: `curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test` - get it back via the REST API: `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: `./target/release/zenohd --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: `curl http://localhost:8000/@/router/local` - get the volumes of the router (only memory by default): `curl 'http://localhost:8000/@/router/local/**/volumes/*'` - get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): `curl 'http://localhost:8000/@/router/local/**/storages/*'` - add another memory storage on `/demo/mystore/**`: `curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/router/local/config/plugins/storage_manager/storages/mystore` - check it has been created: `curl 'http://localhost:8000/@/router/local/**/storages/*'` . **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 desactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . > [!WARNING] > The following documentation pertains to the v0.6+ API, which comes many changes to the behaviour and configuration of Zenoh. To access the v0.5 version of the code and matching README, please go to the [0.5.0-beta.9](https://github.com/eclipse-zenoh/zenoh/tree/0.5.0-beta.9) tagged version. . ------------------------------- ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version than `zenohd`, and using for `zenoh` dependency the same version (or commit number) than 'zenohd'. Otherwise, incompatibilities in memory mapping of shared types between `zenohd` and the library can lead to a `"SIGSEV"` 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. . Note that the REST plugin is added to the configuration by the default value of the `--rest-http-port` CLI argument. . **[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. . **[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). Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenoh Version: 0.11.0-rc.3 Architecture: armel Maintainer: zenoh-dev@eclipse.org Installed-Size: 40 Depends: zenoh-plugin-storage-manager (=0.11.0-rc.3), zenohd (=0.11.0-rc.3), zenoh-plugin-rest (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh_0.11.0-rc.3_armel.deb Size: 17500 MD5sum: 39a3a996126f149acfedce1e5b4132d9 SHA1: 4b396b9d16444b3e398429a41df297e379509b44 SHA256: 9db53d1cb82de1d0211364581e80611f8b3c01df280e35896e2a3493b659cf4f Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . [![CI](https://github.com/eclipse-zenoh/zenoh/workflows/CI/badge.svg)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3A%22CI%22) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![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/ . 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 . 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 . ------------------------------- ## 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 mantaining 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 succesfully compiled with Rust stable (>= 1.71.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: `./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'` - in another shell run: `./target/release/examples/z_put` - then run `./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: `./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: `curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test` - get it back via the REST API: `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: `./target/release/zenohd --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: `curl http://localhost:8000/@/router/local` - get the volumes of the router (only memory by default): `curl 'http://localhost:8000/@/router/local/**/volumes/*'` - get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): `curl 'http://localhost:8000/@/router/local/**/storages/*'` - add another memory storage on `/demo/mystore/**`: `curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/router/local/config/plugins/storage_manager/storages/mystore` - check it has been created: `curl 'http://localhost:8000/@/router/local/**/storages/*'` . **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 desactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . > [!WARNING] > The following documentation pertains to the v0.6+ API, which comes many changes to the behaviour and configuration of Zenoh. To access the v0.5 version of the code and matching README, please go to the [0.5.0-beta.9](https://github.com/eclipse-zenoh/zenoh/tree/0.5.0-beta.9) tagged version. . ------------------------------- ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version than `zenohd`, and using for `zenoh` dependency the same version (or commit number) than 'zenohd'. Otherwise, incompatibilities in memory mapping of shared types between `zenohd` and the library can lead to a `"SIGSEV"` 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. . Note that the REST plugin is added to the configuration by the default value of the `--rest-http-port` CLI argument. . **[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. . **[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). Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenoh Version: 0.11.0-rc.3 Architecture: amd64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 40 Depends: zenoh-plugin-rest (=0.11.0-rc.3), zenoh-plugin-storage-manager (=0.11.0-rc.3), zenohd (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh_0.11.0-rc.3_amd64.deb Size: 17512 MD5sum: 30e9debd8f594d4f708be0f2e8ea87ff SHA1: dfd96ff1af31128589639be8c6988fd03fcebee6 SHA256: e091af87fde2798e2ec84c95cc58f42446126333c1665a4d4e2d530694eb78a2 Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . [![CI](https://github.com/eclipse-zenoh/zenoh/workflows/CI/badge.svg)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3A%22CI%22) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![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/ . 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 . 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 . ------------------------------- ## 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 mantaining 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 succesfully compiled with Rust stable (>= 1.71.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: `./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'` - in another shell run: `./target/release/examples/z_put` - then run `./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: `./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: `curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test` - get it back via the REST API: `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: `./target/release/zenohd --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: `curl http://localhost:8000/@/router/local` - get the volumes of the router (only memory by default): `curl 'http://localhost:8000/@/router/local/**/volumes/*'` - get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): `curl 'http://localhost:8000/@/router/local/**/storages/*'` - add another memory storage on `/demo/mystore/**`: `curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/router/local/config/plugins/storage_manager/storages/mystore` - check it has been created: `curl 'http://localhost:8000/@/router/local/**/storages/*'` . **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 desactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . > [!WARNING] > The following documentation pertains to the v0.6+ API, which comes many changes to the behaviour and configuration of Zenoh. To access the v0.5 version of the code and matching README, please go to the [0.5.0-beta.9](https://github.com/eclipse-zenoh/zenoh/tree/0.5.0-beta.9) tagged version. . ------------------------------- ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version than `zenohd`, and using for `zenoh` dependency the same version (or commit number) than 'zenohd'. Otherwise, incompatibilities in memory mapping of shared types between `zenohd` and the library can lead to a `"SIGSEV"` 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. . Note that the REST plugin is added to the configuration by the default value of the `--rest-http-port` CLI argument. . **[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. . **[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). Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenoh Version: 0.11.0-rc.3 Architecture: armhf Maintainer: zenoh-dev@eclipse.org Installed-Size: 40 Depends: zenohd (=0.11.0-rc.3), zenoh-plugin-storage-manager (=0.11.0-rc.3), zenoh-plugin-rest (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh_0.11.0-rc.3_armhf.deb Size: 17500 MD5sum: f825bd92e5c64122eff0210a51a5be38 SHA1: 415d5e24cf789a54fb4fa1224f7a3b92d1f4c356 SHA256: fdc1569ec36ca63342ccf51fbfcc928dccd2ae9bc495079faeada643bc0fc7db Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . [![CI](https://github.com/eclipse-zenoh/zenoh/workflows/CI/badge.svg)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3A%22CI%22) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![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/ . 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 . 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 . ------------------------------- ## 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 mantaining 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 succesfully compiled with Rust stable (>= 1.71.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: `./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'` - in another shell run: `./target/release/examples/z_put` - then run `./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: `./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: `curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test` - get it back via the REST API: `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: `./target/release/zenohd --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: `curl http://localhost:8000/@/router/local` - get the volumes of the router (only memory by default): `curl 'http://localhost:8000/@/router/local/**/volumes/*'` - get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): `curl 'http://localhost:8000/@/router/local/**/storages/*'` - add another memory storage on `/demo/mystore/**`: `curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/router/local/config/plugins/storage_manager/storages/mystore` - check it has been created: `curl 'http://localhost:8000/@/router/local/**/storages/*'` . **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 desactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . > [!WARNING] > The following documentation pertains to the v0.6+ API, which comes many changes to the behaviour and configuration of Zenoh. To access the v0.5 version of the code and matching README, please go to the [0.5.0-beta.9](https://github.com/eclipse-zenoh/zenoh/tree/0.5.0-beta.9) tagged version. . ------------------------------- ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version than `zenohd`, and using for `zenoh` dependency the same version (or commit number) than 'zenohd'. Otherwise, incompatibilities in memory mapping of shared types between `zenohd` and the library can lead to a `"SIGSEV"` 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. . Note that the REST plugin is added to the configuration by the default value of the `--rest-http-port` CLI argument. . **[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. . **[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). Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenoh-plugin-rest Version: 0.11.0-rc.3 Architecture: arm64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 11321 Depends: zenohd (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh-plugin-rest_0.11.0-rc.3_arm64.deb Size: 2136568 MD5sum: 3f2f8d815daa6fd758daf64a0e0dbbbb SHA1: 5e9fcd58c9da87d973cb886da5b296f008d60a01 SHA256: 411b3a774edc2597e22f7042cfcd81e1bc793c61c5fa316c452fc0704ac5a1cb Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh REST plugin # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenoh-plugin-rest Version: 0.11.0-rc.3 Architecture: armhf Maintainer: zenoh-dev@eclipse.org Installed-Size: 8628 Depends: zenohd (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh-plugin-rest_0.11.0-rc.3_armhf.deb Size: 1920168 MD5sum: 773bc1a8dd073d3ee18d31116edf60e3 SHA1: 87f02dd9bd09d549c6a1d6d5953d7a06e974485c SHA256: 2447423266a1bc12ceb01f04f04b56d718b3c3f99e63175b3dc7a6d42f3a0ebb Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh REST plugin # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenoh-plugin-rest Version: 0.11.0-rc.3 Architecture: armel Maintainer: zenoh-dev@eclipse.org Installed-Size: 8703 Depends: zenohd (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh-plugin-rest_0.11.0-rc.3_armel.deb Size: 1931932 MD5sum: e78fada3fe54929830bf6c434576c2b3 SHA1: a9f1e9a75abc77ddc8a81064b1157e1312b38965 SHA256: 6f74ed00d61144cd077d8d46e510d5bb820dc77e865895bdf5f6af663f53db48 Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh REST plugin # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenoh-plugin-rest Version: 0.11.0-rc.3 Architecture: amd64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 12975 Depends: zenohd (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh-plugin-rest_0.11.0-rc.3_amd64.deb Size: 2383328 MD5sum: 17044ca346005337dd5ab52a86bbd6d8 SHA1: 7be6abd4f555499e6e910b41890f8c5cc8a6c639 SHA256: fc0d97fd0a1a45be377878c2a4ad9728a93dd5f41a7f74e6bc0007cf50302aa7 Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh REST plugin # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenoh-plugin-storage-manager Version: 0.11.0-rc.3 Architecture: armhf Maintainer: zenoh-dev@eclipse.org Installed-Size: 8869 Depends: zenohd (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh-plugin-storage-manager_0.11.0-rc.3_armhf.deb Size: 1965444 MD5sum: 60c39ff711b512805ecc3ad2d5f719c4 SHA1: f45515ddf853f26e1cf0501854f20d26ad59161d SHA256: e352458ead306db38f960a217434a515304ed7074d376a65a43722ff8b65ffd3 Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh storages plugin. # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenoh-plugin-storage-manager Version: 0.11.0-rc.3 Architecture: amd64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 13196 Depends: zenohd (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh-plugin-storage-manager_0.11.0-rc.3_amd64.deb Size: 2405320 MD5sum: 43d834d90f1ce46f1e1489d138880fa1 SHA1: 1109fe57f277260341c8749a8ed2c2f869d70d20 SHA256: 1c96c5a9ec0b2dfd93b00c9e526e52eeb5fdc75616b75589661ea7a4c540e884 Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh storages plugin. # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenoh-plugin-storage-manager Version: 0.11.0-rc.3 Architecture: arm64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 11512 Depends: zenohd (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh-plugin-storage-manager_0.11.0-rc.3_arm64.deb Size: 2161700 MD5sum: 9cb8caa933b9ff10a53f70a7f4e82c36 SHA1: 130e26867b9b85dde35ee68efa7eb084785eb180 SHA256: 9320515a8a9db050af77b81077209e9bf409ada0578e25de726bf71986ac947d Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh storages plugin. # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenoh-plugin-storage-manager Version: 0.11.0-rc.3 Architecture: armel Maintainer: zenoh-dev@eclipse.org Installed-Size: 8951 Depends: zenohd (=0.11.0-rc.3) Filename: 0.11.0-rc.3/zenoh-plugin-storage-manager_0.11.0-rc.3_armel.deb Size: 1976804 MD5sum: 50840ae0d211b4f52b7ab0ace60af528 SHA1: c16e3398b2458c02354deacef78cbeeb3fba3400 SHA256: 8222614cd363e1f9fc6504c41a52ab32a599c75fe1cbafea6986fa03b3984863 Section: net Priority: optional Homepage: http://zenoh.io Description: The zenoh storages plugin. # ⚠️ WARNING ⚠️ . This crate is intended for Zenoh's internal use. . - [Click here for Zenoh's main repository](https://github.com/eclipse-zenoh/zenoh) - [Click here for Zenoh's documentation](https://zenoh.io) Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenohd Version: 0.11.0-rc.3 Architecture: armhf Maintainer: zenoh-dev@eclipse.org Installed-Size: 18342 Filename: 0.11.0-rc.3/zenohd_0.11.0-rc.3_armhf.deb Size: 4613464 MD5sum: 3d75cc99bf9d463fd73300886e3222aa SHA1: 8aedd65e825e7cae70b90dc773c4fddcc17a83af SHA256: cc391878aa5b5139c0da67c3837b30eca8f0f04548718288ae5850cb5976dd16 Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . [![CI](https://github.com/eclipse-zenoh/zenoh/workflows/CI/badge.svg)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3A%22CI%22) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![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/ . 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 . 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 . ------------------------------- ## 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 mantaining 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 succesfully compiled with Rust stable (>= 1.71.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: `./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'` - in another shell run: `./target/release/examples/z_put` - then run `./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: `./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: `curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test` - get it back via the REST API: `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: `./target/release/zenohd --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: `curl http://localhost:8000/@/router/local` - get the volumes of the router (only memory by default): `curl 'http://localhost:8000/@/router/local/**/volumes/*'` - get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): `curl 'http://localhost:8000/@/router/local/**/storages/*'` - add another memory storage on `/demo/mystore/**`: `curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/router/local/config/plugins/storage_manager/storages/mystore` - check it has been created: `curl 'http://localhost:8000/@/router/local/**/storages/*'` . **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 desactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . > [!WARNING] > The following documentation pertains to the v0.6+ API, which comes many changes to the behaviour and configuration of Zenoh. To access the v0.5 version of the code and matching README, please go to the [0.5.0-beta.9](https://github.com/eclipse-zenoh/zenoh/tree/0.5.0-beta.9) tagged version. . ------------------------------- ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version than `zenohd`, and using for `zenoh` dependency the same version (or commit number) than 'zenohd'. Otherwise, incompatibilities in memory mapping of shared types between `zenohd` and the library can lead to a `"SIGSEV"` 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. . Note that the REST plugin is added to the configuration by the default value of the `--rest-http-port` CLI argument. . **[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. . **[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). Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenohd Version: 0.11.0-rc.3 Architecture: armel Maintainer: zenoh-dev@eclipse.org Installed-Size: 18589 Filename: 0.11.0-rc.3/zenohd_0.11.0-rc.3_armel.deb Size: 4563712 MD5sum: 93d8449fc11518a8a44585a379719cbf SHA1: f31dd062e8e84aeefb4ce95fcc31a007bb1326d1 SHA256: ea91ab3ae7a5ca61d6a8a06cc721efdb8853e2003c41ad577b4ddb60655a4c48 Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . [![CI](https://github.com/eclipse-zenoh/zenoh/workflows/CI/badge.svg)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3A%22CI%22) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![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/ . 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 . 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 . ------------------------------- ## 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 mantaining 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 succesfully compiled with Rust stable (>= 1.71.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: `./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'` - in another shell run: `./target/release/examples/z_put` - then run `./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: `./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: `curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test` - get it back via the REST API: `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: `./target/release/zenohd --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: `curl http://localhost:8000/@/router/local` - get the volumes of the router (only memory by default): `curl 'http://localhost:8000/@/router/local/**/volumes/*'` - get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): `curl 'http://localhost:8000/@/router/local/**/storages/*'` - add another memory storage on `/demo/mystore/**`: `curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/router/local/config/plugins/storage_manager/storages/mystore` - check it has been created: `curl 'http://localhost:8000/@/router/local/**/storages/*'` . **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 desactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . > [!WARNING] > The following documentation pertains to the v0.6+ API, which comes many changes to the behaviour and configuration of Zenoh. To access the v0.5 version of the code and matching README, please go to the [0.5.0-beta.9](https://github.com/eclipse-zenoh/zenoh/tree/0.5.0-beta.9) tagged version. . ------------------------------- ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version than `zenohd`, and using for `zenoh` dependency the same version (or commit number) than 'zenohd'. Otherwise, incompatibilities in memory mapping of shared types between `zenohd` and the library can lead to a `"SIGSEV"` 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. . Note that the REST plugin is added to the configuration by the default value of the `--rest-http-port` CLI argument. . **[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. . **[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). Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenohd Version: 0.11.0-rc.3 Architecture: amd64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 19724 Depends: libc6 (>= 2.29) Filename: 0.11.0-rc.3/zenohd_0.11.0-rc.3_amd64.deb Size: 4681588 MD5sum: 4446fedad70db3c759a97911d05c4e30 SHA1: c520a233db4186908672307e669bbb13933f8097 SHA256: d38ac62f0bab99a14eb1d0698594c49be51c8540e9034502544b0df4783646c3 Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . [![CI](https://github.com/eclipse-zenoh/zenoh/workflows/CI/badge.svg)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3A%22CI%22) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![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/ . 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 . 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 . ------------------------------- ## 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 mantaining 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 succesfully compiled with Rust stable (>= 1.71.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: `./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'` - in another shell run: `./target/release/examples/z_put` - then run `./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: `./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: `curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test` - get it back via the REST API: `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: `./target/release/zenohd --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: `curl http://localhost:8000/@/router/local` - get the volumes of the router (only memory by default): `curl 'http://localhost:8000/@/router/local/**/volumes/*'` - get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): `curl 'http://localhost:8000/@/router/local/**/storages/*'` - add another memory storage on `/demo/mystore/**`: `curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/router/local/config/plugins/storage_manager/storages/mystore` - check it has been created: `curl 'http://localhost:8000/@/router/local/**/storages/*'` . **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 desactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . > [!WARNING] > The following documentation pertains to the v0.6+ API, which comes many changes to the behaviour and configuration of Zenoh. To access the v0.5 version of the code and matching README, please go to the [0.5.0-beta.9](https://github.com/eclipse-zenoh/zenoh/tree/0.5.0-beta.9) tagged version. . ------------------------------- ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version than `zenohd`, and using for `zenoh` dependency the same version (or commit number) than 'zenohd'. Otherwise, incompatibilities in memory mapping of shared types between `zenohd` and the library can lead to a `"SIGSEV"` 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. . Note that the REST plugin is added to the configuration by the default value of the `--rest-http-port` CLI argument. . **[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. . **[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). Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh Package: zenohd Version: 0.11.0-rc.3 Architecture: arm64 Maintainer: zenoh-dev@eclipse.org Installed-Size: 17066 Filename: 0.11.0-rc.3/zenohd_0.11.0-rc.3_arm64.deb Size: 4153940 MD5sum: 794f7140a4f5634ce851da0dc3d544c9 SHA1: 9baa97ccae609e7802b847db7397f70a88bf12ea SHA256: d656118e3ca0cda74ad61cac296c6af01d3de1c06b2df3df3842e30c05fa0e66 Section: net Priority: optional Homepage: http://zenoh.io Description: Zenoh: Zero Overhead Pub/sub, Store/Query and Compute. . [![CI](https://github.com/eclipse-zenoh/zenoh/workflows/CI/badge.svg)](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3A%22CI%22) [![Documentation Status](https://readthedocs.org/projects/zenoh-rust/badge/?version=latest)](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest) [![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/ . 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 . 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 . ------------------------------- ## 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 mantaining 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 succesfully compiled with Rust stable (>= 1.71.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: `./target/release/zenohd --cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'` - in another shell run: `./target/release/examples/z_put` - then run `./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: `./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: `curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test` - get it back via the REST API: `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: `./target/release/zenohd --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: `curl http://localhost:8000/@/router/local` - get the volumes of the router (only memory by default): `curl 'http://localhost:8000/@/router/local/**/volumes/*'` - get the storages of the local router (the memory storage configured at startup on '/demo/example/**' should be present): `curl 'http://localhost:8000/@/router/local/**/storages/*'` - add another memory storage on `/demo/mystore/**`: `curl -X PUT -H 'content-type:application/json' -d '{"key_expr":"demo/mystore/**","volume":"memory"}' http://localhost:8000/@/router/local/config/plugins/storage_manager/storages/mystore` - check it has been created: `curl 'http://localhost:8000/@/router/local/**/storages/*'` . **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 desactivate the REST plugin . If not specified, the REST plugin will be active on any interface (`[::]`) and port `8000`. . > [!WARNING] > The following documentation pertains to the v0.6+ API, which comes many changes to the behaviour and configuration of Zenoh. To access the v0.5 version of the code and matching README, please go to the [0.5.0-beta.9](https://github.com/eclipse-zenoh/zenoh/tree/0.5.0-beta.9) tagged version. . ------------------------------- ## Plugins . > [!WARNING] > As Rust doesn't have a stable ABI, the plugins should be built with the exact same Rust version than `zenohd`, and using for `zenoh` dependency the same version (or commit number) than 'zenohd'. Otherwise, incompatibilities in memory mapping of shared types between `zenohd` and the library can lead to a `"SIGSEV"` 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. . Note that the REST plugin is added to the configuration by the default value of the `--rest-http-port` CLI argument. . **[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. . **[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). Vcs-Browser: https://github.com/eclipse-zenoh/zenoh Vcs-Git: https://github.com/eclipse-zenoh/zenoh