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/connecting_several_managers.md | 28 ---------------------------- docs/hub.md | 33 +++++++++++++++++++++++++++++++++ 2 files changed, 33 insertions(+), 28 deletions(-) delete mode 100644 docs/connecting_several_managers.md create mode 100644 docs/hub.md (limited to 'docs') diff --git a/docs/connecting_several_managers.md b/docs/connecting_several_managers.md deleted file mode 100644 index 9925bbfb6..000000000 --- a/docs/connecting_several_managers.md +++ /dev/null @@ -1,28 +0,0 @@ -# How to connect 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 `go install github.com/google/syzkaller/syz-hub`. Then create a config file along the lines of: - -``` -{ - "http": ":80", - "rpc": ":55555", - "workdir": "/syzkaller/workdir", - "managers": [ - {"name": "manager1", "key": "6sCFsJVfyFQVhWVKJpKhHcHxpCH0gAxL"}, - {"name": "manager2", "key": "FZFSjthHHf8nKm2cqqAcAYKM5a3XM4Ao"}, - {"name": "manager3", "key": "fTrIBQCmkEq8NsvQXZiOUyop6uWLBuzf"} - ] -} -``` - -And start it with `$GOPATH/syz-hub -config hub.cfg`. Then add the following additional parameters to `syz-manager` config files of each manager: - -``` - "name": "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. 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