third-party-mirrors/EDDN
1
0
Fork 0
mirror of https://github.com/EDCD/EDDN.git synced 2025-06-09 11:52:16 +03:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs/Running: Section-ise the setup.py install section

Browse Source 
* Moves the "you need to edit these files in the monitor" into a section
  related to this, rather than up in #concepts.
This commit is contained in:
Athanasius 2021-07-05 14:36:24 +00:00
parent 8f36f8dcfe
commit 547ec2bc22
1 changed files with 60 additions and 50 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
docs/Running-this-software.md
View File

@ -306,16 +306,8 @@ from the Gateway to the Relay and Monitor.
As the code currently (2021-05-16) stands it MUST run on a standalone host As the code currently (2021-05-16) stands it MUST run on a standalone host
such that everything is served relative to the path root, not a path prefix. such that everything is served relative to the path root, not a path prefix.
Also all of the `contrib/monitor` files have `eddn.edcd.io` hard-coded. You See also the [post-installation notes](#post-installation-steps) for some
will need to perform search and replace on the installed/live files to use a caveats about running this other than on the actual eddn.edcd.io host.
test host. The files in question are:
monitor/js/eddn.js
monitor/schemas.html
Replace the string `eddn.edcd.io` with the hostname you're using. You'll need
to perform similar substitutions if you change the configuration to use any
different port numbers.
--- ---
@ -403,15 +395,18 @@ It sets:
# Running # Running
You have some choices for how to run the application components: You have some choices for how to run the application components:
1. If you are just testing out code changes then you can choose to run ## Running scripts from source
If you are just testing out code changes then you can choose to run
this application directly from the source using the provided script in this application directly from the source using the provided script in
`contrib/run-from-source.sh`. `contrib/run-from-source.sh`. This assumes the `dev` environment.
1. Otherwise you will want to utilise the `setup.py` file to build and ## Running from installation
Otherwise you will want to utilise the `setup.py` file to build and
install the application files. You'll need to do some setup first as install the application files. You'll need to do some setup first as
there are necessary files *not* checked into git, because they're per there are necessary files *not* checked into git, because they're per
environment: environment:
### Performing the installation
1. Change directory to the top level of the git clone. 1. Change directory to the top level of the git clone.
1. Create a file `setup_env.py` with contents: 1. Create a file `setup_env.py` with contents:
@ -452,6 +447,21 @@ You have some choices for how to run the application components:
with an example config override file if you didn't already have a with an example config override file if you didn't already have a
`config.json` here. `config.json` here.
### Post-installation steps
If you're not using the `live` environment then there are some edits you
need to make.
All of the `contrib/monitor` files have the hostname `eddn.edcd.io`
hard-coded. You will need to perform search and replace on the
installed/live files to use a test host. The files in question are:
monitor/js/eddn.js
monitor/schemas.html
Replace the string `eddn.edcd.io` with the hostname you're using.
You'll need to perform similar substitutions if you change the
configuration to use any different port numbers.
--- ---
# Accessing the Monitor # Accessing the Monitor