40 Commits

Author SHA1 Message Date
Athanasius
e3053dc0b6 systemd: Updates for it to work with current paradigm 2021-07-06 13:29:29 +00:00
Athanasius
474e0e694d docs/Running: Correct virtualenv command to use env name 2021-07-06 12:49:29 +00:00
Athanasius
0e3ef098ab systemd/start-eddn-service: Now replacing scripts/run-from-source.sh
* Removed scripts/run-from-source.sh as it's now redundant.
* Added `--background` optional argument, only for when using
  `--from-source` to start-eddn-service.  The script will leave the
  service in the foreground, no output redirection, without it.

  It tells you the PID of the process when it's backgrounded, as well as
  placing it in the appropriate .pid file.
2021-07-06 11:17:52 +00:00
Athanasius
3116927b12 run-from-source: Moved into new ./scripts/ directory 2021-07-06 10:04:55 +00:00
Athanasius
4bfa81cde8 docs/Running: systemd files now in root rather than contrib/ 2021-07-06 10:04:13 +00:00
Athanasius
547ec2bc22 docs/Running: Section-ise the setup.py install section
* Moves the "you need to edit these files in the monitor" into a section
  related to this, rather than up in #concepts.
2021-07-05 14:36:24 +00:00
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
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
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
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