37 Commits

Author SHA1 Message Date
Athanasius
50d7af3149 docs/Running: Catch up installation docs with current scripting 2021-07-05 14:16:08 +00:00
Athanasius
0bcb9cc545 docs/Running: Specify network/firewall config, correct some paths and ...
* <hr> between sections
* Document the ports that *must* be open to the internet.
* Apache will require the proxy_http module.
* Move the github clone earlier in instructions, as part of ensuring
  paths exist when they should.
* Note about needing to do hostname and port substitutions in monitor
  files if not using the standard values.
* Link to other sections where appropriate.
2021-07-05 12:52:50 +00:00
Athanasius
fcd316c7d4 docs/Running: Edit and expand LetsEncrypt section 2021-07-02 18:04:34 +00:00
Athanasius
096ccab9fb docs/Running: Outline for using Apache 2021-07-01 17:30:48 +00:00
Athanasius
4e343fe444 docs/running: a start on apache config 2021-07-01 18:11:13 +01:00
Athanasius
451b93db1d docs/Running: Correct placement of "Reverse Proxy with nginx" section 2021-07-01 15:41:44 +01:00
Athanasius
d16e222a99 docs/Running: Mandate the python venv installation
Let's stop guessing at how the reader wants to do it and just *tell*
them how to do it instead.

Python virtual environment, done.
2021-06-14 17:12:43 +01:00
Athanasius
db7b69473b docs/: Add example override config file 2021-06-14 17:12:28 +01:00
Athanasius
c6db4b2733 docs/Running: ${HOME} not ~ / python venv un-versioned symbolic link
* Let's stick with Bourne Shell, not BASH-isms.
* If we make everything use ~/eddn/python-venv symbolic link then
there's less to update in the future.
2021-06-14 16:52:04 +01:00
Athanasius
165a00599f docs/Running: We should use a python venv 2021-06-14 15:15:10 +01:00
Athanasius
5dc0e345fa docs/Running-this-software: Call out contrib/systemd 2021-06-14 12:33:14 +01:00
Athanasius
c383d97fee docs: Basic instructions on putting existing LetsEncrypt cert files in place 2021-06-04 15:24:40 +01:00
Athanasius
adaa6822f0 docs: Add some information from the VPS Anthor has been using. 2021-06-04 14:22:14 +01:00
Athanasius
e47b3e4021 docs/Running: Correct and clarify the Apache Proxy examples. 2021-05-19 11:32:42 +01:00
Athanasius
c5070c7754 docs/Running: Be explicit about the mysql password use 2021-05-19 11:28:03 +01:00
Athanasius
ad236365f8 docs/running: Add dpkg output of the tested VM.
The debian-vm-dpkg_-l.txt is likely the most useful as it includes the
exact versions of the packages.  This might help resolve any "uh,
doesn't work on *my* system" conundrums.
2021-05-17 08:25:34 +01:00
Athanasius
5f12722c9f docs/running: Order steps more logically.
* Also adds some minimal Apache guidance for Reverse Proxy setup.
2021-05-16 20:59:03 +01:00
Athanasius
ae4f54b608 docs/running: Move DB init after DB install/setup
* Also we might as well make examples clearer by assuming
  `~/eddn/dev/EDDN/` for the git clone.
2021-05-16 20:47:34 +01:00
Athanasius
f195a53872 docs/running: Detail the ports each process uses and why. 2021-05-16 20:45:03 +01:00
Athanasius
7dce35d442 docs/running: expand/correct/improve iptables rules for VM testing 2021-05-16 20:30:53 +01:00
Athanasius
a64ca249d1 docs/running: Add section on needing to search/replace monitor files 2021-05-16 20:27:56 +01:00
Athanasius
66bb88abca docs/running: cp -r not cp -p 2021-05-16 19:31:10 +01:00
Athanasius
e12f6f1f70 docs/running: Init SQL schema & port 9091 also needs forwarding to VM 2021-05-16 18:09:57 +01:00
Athanasius
031981893c docs/running: Example settings override file & misc grammar 2021-05-16 17:35:30 +01:00
Athanasius
ae73b346fd docs: Add example of a settings override file 2021-05-16 17:29:37 +01:00
Athanasius
b4359286af docs/running: multiple schemas can be outdated 2021-05-16 17:26:09 +01:00
Athanasius
4e9cecaf1e docs/running: nginx serves the schema files 2021-05-16 17:25:20 +01:00
Athanasius
854e20501c docs/running: missing ' which ' 2021-05-16 17:23:49 +01:00
Athanasius
5c9f01be7a docs/running: formatting & correct RELAY_HTTP_BIND_ADDRESS/RELAY_HTTP_PORT 2021-05-16 17:19:59 +01:00
Athanasius
4229d59450 docs/running: Formatting fixups. 2021-05-16 17:12:52 +01:00
Athanasius
1e4eb9e0e1 docs/running: Be more explicit about using an override file for config 2021-05-16 16:51:32 +01:00
Athanasius
ea87cea80b docs/running: Generalise the VM host name in example 2021-05-16 16:35:01 +01:00
Athanasius
2656efc828 docs/running: Notes on testing in a VM
* The useradd command is adding a user.
* How to quit out of `mysql.
* The `requirements.txt` is in this PR now.
* How to disable the message duplicates check.
* If you're double-proxying you need to set that up, and some firewall
  redirects too.
2021-05-16 16:32:12 +01:00
Athanasius
193863e686 docs/running: Much more progress
* Installing a mariadb server and creating the database, plus db user
  and permissions.
* Installing to ~/.local/ with setup.py script.
* Installing the monitor files.
* Installing the schema files.
* Installing `netdata` Debian package for performance stats.
* Installing and configuring nginx as reverse proxy.
2021-05-16 15:31:57 +01:00
Athanasius
8ee650c8db docs/running: Expand on Gateway passing messages on, start 'Running' section 2021-05-16 11:19:37 +01:00
Athanasius
a8a6fd15a4 docs/Running: You can specify an overrides config file 2021-05-16 10:35:59 +01:00
Athanasius
d2d2122609 docs: Add initial version of Running-this-software.md 2021-05-16 09:35:20 +01:00