From c5b6fcddca80153daba328334bc48caa3a546ab5 Mon Sep 17 00:00:00 2001 From: Dmitry Vyukov Date: Thu, 29 Jun 2017 16:01:03 +0200 Subject: syz-hub: split client name and manager name This allows to reduce number of hub clients by grouping managers and creating one client per such group. --- docs/hub.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 docs/hub.md (limited to 'docs/hub.md') diff --git a/docs/hub.md b/docs/hub.md new file mode 100644 index 000000000..7b7cb3f8c --- /dev/null +++ b/docs/hub.md @@ -0,0 +1,33 @@ +# Connecting several managers via Hub + +`syz-hub` program can be used to connect several `syz-manager`'s together and +allow them to exchange programs. + +Build `syz-hub` with `make hub`. Then create a config file along the lines of: + +``` +{ + "http": ":80", + "rpc": ":55555", + "workdir": "/syzkaller/workdir", + "clients": [ + {"name": "manager1", "key": "6sCFsJVfyFQVhWVKJpKhHcHxpCH0gAxL"}, + {"name": "manager2", "key": "FZFSjthHHf8nKm2cqqAcAYKM5a3XM4Ao"}, + {"name": "manager3", "key": "fTrIBQCmkEq8NsvQXZiOUyop6uWLBuzf"} + ] +} +``` + +And start it with `bin/syz-hub -config hub.cfg`. Then add the following +additional parameters to `syz-manager` config files of each manager: + +``` + "name": "manager1", + "hub_client": "manager1", + "hub_addr": "1.2.3.4:55555", + "hub_key": "6sCFsJVfyFQVhWVKJpKhHcHxpCH0gAxL", +``` + +And start managers. Once they triage local corpus, they will connect to the hub +and start exchanging inputs. Both hub and manager web pages will show how many +inputs they send/receive from the hub. -- cgit mrf-deployment