onionperf install

metrics/ops/onionperf-ops.mdwn

@@ -36,6 +36,12 @@ sudo password that is specific to the host.
 On each host, a `tmux` session runs as the `cloud` user. This means that sudo
 is not generally needed for routine activities.
 
+The command to start looks like:
+
+```
+/usr/bin/python /usr/local/bin/onionperf measure --tor=/home/cloud/tor/src/or/tor --tgen=/home/cloud/shadow/src/plugin/shadow-plugin-tgen/build/tgen --tgen-listen-port 8080 --tgen-connect-port 80 --twistd=/usr/local/bin/twistd
+```
+
 ## Changes to OnionPerf since last deployment
 
 The OnionPerf codebase has undergone significant development since the op-*
@@ -66,3 +72,30 @@ way that OnionPerf is deployed.
 * Built-in twistd webserver used for sharing analysis results was removed,
   so that the data can be served by an external webserver (e.g. Apache)
 
+## Deploying an OnionPerf
+
+Follow instructions at https://2019.www.torproject.org/docs/debian.html.en to
+install tor package.
+
+Add Debian backports repository following instructions at
+https://backports.debian.org/Instructions/#index2h2
+
+Don't start tor at startup:
+
+```
+systemctl stop tor.service
+systemctl mask tor.service
+```
+
+(mask prevents it from ever being started as a service)
+
+Install python-stem from backports:
+
+```
+apt install -t buster-backports python-stem
+```
+
+Install OnionPerf dependencies with apt:
+
+apt install libglib2.0-0 libigraph0v5 python-ipaddress python-lxml python-matplotlib python-netifaces python-networkx python-nose python-numpy python-scipy
+