From 8e0fa61c06fd12c502ea171bee65f5fd63ccb158 Mon Sep 17 00:00:00 2001 From: Rasmus Dahlberg Date: Fri, 7 Apr 2023 21:34:13 +0200 Subject: Add docs --- docs/setup.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/setup.md (limited to 'docs/setup.md') diff --git a/docs/setup.md b/docs/setup.md new file mode 100644 index 0000000..7e4bdb8 --- /dev/null +++ b/docs/setup.md @@ -0,0 +1,19 @@ +# Setup + +`onion-grab` has been tested on Ubuntu/Debian based systems. If you are running +a large measurement, you may run into issues that are **OS related**. + +## Hints + + - We disabled and stopped `systemd-resolved`, which eventually causes some or + all DNS requests to be blocked when running with many concurrent workers. + - We used Google's `8.8.8.8` and `8.8.4.4`, which [supports 1500qps][] per IP. + - You may need to tinker with `ulimit` and `sysctl`, e.g., if observing that + there are too many open file descriptors or similar. See for example the + value of `ulimit -n` and `sysctl net.ipv4.ip_local_port_range` + +[supports 1500qps]: https://developers.google.com/speed/public-dns/docs/isp + +## Credit + +Björn Töpel helped us debug some of these OS-related issues. -- cgit v1.2.3