diff options
author | Ben Hutchings <ben.hutchings@codethink.co.uk> | 2020-05-18 17:58:06 +0100 |
---|---|---|
committer | Ben Hutchings <ben.hutchings@codethink.co.uk> | 2020-06-09 17:39:40 +0100 |
commit | 3dc0ce64d7dca2e42c592fe81596225e6460afb4 (patch) | |
tree | 4ef1de3e1a0aef88d977b4cbe512b06c07732277 | |
parent | d8763429d847ead2d4359b09aab70dc7f2272bb1 (diff) | |
download | lorry-controller-3dc0ce64d7dca2e42c592fe81596225e6460afb4.tar.gz |
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.
-rw-r--r-- | INSTALL | 37 |
1 files changed, 37 insertions, 0 deletions
@@ -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 |