INSTALL: Document how to install Lorry and Lorry Controller themselves

Installation is mostly covered by setup.py.  However the configuration
files, many of the directories, and the systemd commands are not.

Related to #2.

1 files changed, 37 insertions, 0 deletions

diff --git a/INSTALL b/INSTALL
index 99329fc..5344093 100644
--- a/INSTALL
+++ b/INSTALL
@@ -234,3 +234,40 @@ to it.  Only administrators of Lorry Controller should be permitted
 to push to it.
 
 The configuration files stored in CONFGIT are documented in README.
+
+## Installing Lorry and Lorry Controller
+
+1. In a copy of the Lorry source tree, run:
+
+        python3 setup.py install --install-layout=deb
+
+2. Install `lorry.conf` in `/etc/`
+
+3. Create the directories named in `lorry.conf`
+   (`bundle-dest`, `tarball-dest`, `working-area` settings),
+   owned by the Lorry user.
+
+4. In a copy of the Lorry Controller source tree, run:
+
+        python3 setup.py install --install-layout=deb
+
+5. Install `webapp.conf` in `/etc/lorry-controller/`
+
+6. Create the directories named in `webapp.conf`
+   (`configuration-directory` setting and parent directories for the
+   `statedb` and `status-html` settings), owned by the Lorry user.
+
+7. Install the unit files from Lorry Controller's source tree
+   (`units/lorry-controller-*`) in `/lib/systemd/system/`.  These may
+   need to be modified to specify the correct URL for the front-end
+   web server.
+
+8. Run `systemctl daemon-reload` to make systemd load the unit files.
+
+9. Enable and start as many MINION services as you want to run in
+   parallel.  For example, to create 5 services:
+
+        for i in $(seq 5); do
+		    systemctl enable lorry-controller-minion@$i.service
+			systemctl start lorry-controller-minion@$i.service
+		done