kopia lustrzana https://github.com/glidernet/ogn-python
Update readme
rodzic
830d0e47fb
commit
dedffb88e2
36
README.md
36
README.md
|
@ -34,11 +34,11 @@ For best performance you should use [TimescaleDB](https://www.timescale.com), wh
|
||||||
apt-get install redis-server
|
apt-get install redis-server
|
||||||
```
|
```
|
||||||
|
|
||||||
5. Set the configuration.
|
5. Optional: Custom configuration file
|
||||||
Let the environment variable `OGN_CONFIG_MODULE` point to the configuration file:
|
Write a custom configuration file and let the environment variable `OGN_CONFIG_MODULE` point to the configuration file:
|
||||||
|
|
||||||
```
|
```
|
||||||
export OGN_CONFIG_MODULE="config/default.py"
|
export OGN_CONFIG_MODULE="config/my_custom_configuration.py"
|
||||||
```
|
```
|
||||||
|
|
||||||
6. Create database
|
6. Create database
|
||||||
|
@ -95,7 +95,13 @@ For best performance you should use [TimescaleDB](https://www.timescale.com), wh
|
||||||
```
|
```
|
||||||
flask database import_ddb
|
flask database import_ddb
|
||||||
```
|
```
|
||||||
|
|
||||||
|
14. Optional: Use supervisord
|
||||||
|
You can use [Supervisor](http://supervisord.org/) to control the complete system. In the directory deployment/supervisor
|
||||||
|
we have some configuration files to feed the database (ogn-feed), run the celery worker (celeryd), the celery beat
|
||||||
|
(celerybeatd), the celery monitor (flower), and the python wsgi server (gunicorn). All files assume that
|
||||||
|
we use a virtual environment in "/home/pi/ogn-python/venv". Please edit if necessary.
|
||||||
|
|
||||||
There is also a [Vagrant](https://www.vagrantup.com/) environment for the development of ogn-python.
|
There is also a [Vagrant](https://www.vagrantup.com/) environment for the development of ogn-python.
|
||||||
You can create and start this virtual machine with `vagrant up` and login with `vagrant ssh`.
|
You can create and start this virtual machine with `vagrant up` and login with `vagrant ssh`.
|
||||||
The code of ogn-python will be available in the shared folder `/vagrant`.
|
The code of ogn-python will be available in the shared folder `/vagrant`.
|
||||||
|
@ -116,13 +122,13 @@ The following scripts run in the foreground and should be deamonized
|
||||||
- Start a task server (make sure redis is up and running)
|
- Start a task server (make sure redis is up and running)
|
||||||
|
|
||||||
```
|
```
|
||||||
celery -A ogn_python.collect worker -l info
|
celery -A app.collect worker -l info
|
||||||
```
|
```
|
||||||
|
|
||||||
- Start the task scheduler (make sure a task server is up and running)
|
- Start the task scheduler (make sure a task server is up and running)
|
||||||
|
|
||||||
```
|
```
|
||||||
celery -A ogn_python.collect beat -l info
|
celery -A app.collect beat -l info
|
||||||
```
|
```
|
||||||
|
|
||||||
### Flask - Command Line Interface
|
### Flask - Command Line Interface
|
||||||
|
@ -161,20 +167,20 @@ Most commands are command groups, so if you execute this command you will get fu
|
||||||
|
|
||||||
### Available tasks
|
### Available tasks
|
||||||
|
|
||||||
- `ogn_python.collect.celery.update_takeoff_landings` - Compute takeoffs and landings.
|
- `app.collect.celery.update_takeoff_landings` - Compute takeoffs and landings.
|
||||||
- `ogn_python.collect.celery.update_logbook_entries` - Add/update logbook entries.
|
- `app.collect.celery.update_logbook_entries` - Add/update logbook entries.
|
||||||
- `ogn_python.collect.celery.update_logbook_max_altitude` - Add max altitudes in logbook when flight is complete (takeoff and landing).
|
- `app.collect.celery.update_logbook_max_altitude` - Add max altitudes in logbook when flight is complete (takeoff and landing).
|
||||||
- `ogn_python.collect.celery.import_ddb` - Import registered devices from the DDB.
|
- `app.collect.celery.import_ddb` - Import registered devices from the DDB.
|
||||||
- `ogn_python.collect.celery.update_receivers_country_code` - Update country code in receivers table if None.
|
- `app.collect.celery.update_receivers_country_code` - Update country code in receivers table if None.
|
||||||
- `ogn_python.collect.celery.purge_old_data` - Delete AircraftBeacons and ReceiverBeacons older than given 'age'.
|
- `app.collect.celery.purge_old_data` - Delete AircraftBeacons and ReceiverBeacons older than given 'age'.
|
||||||
- `ogn_python.collect.celery.update_stats` - Create stats and update receivers/devices with stats.
|
- `app.collect.celery.update_stats` - Create stats and update receivers/devices with stats.
|
||||||
- `ogn_python.collect.celery.update_ognrange` - Create receiver coverage stats for Melissas ognrange.
|
- `app.collect.celery.update_ognrange` - Create receiver coverage stats for Melissas ognrange.
|
||||||
|
|
||||||
If the task server is up and running, tasks could be started manually. Here we compute takeoffs and landings for the past 90 minutes:
|
If the task server is up and running, tasks could be started manually. Here we compute takeoffs and landings for the past 90 minutes:
|
||||||
|
|
||||||
```
|
```
|
||||||
python3
|
python3
|
||||||
>>>from ogn_python.collect.celery import update_takeoff_landings
|
>>>from app.collect.celery import update_takeoff_landings
|
||||||
>>>update_takeoff_landings.delay(last_minutes=90)
|
>>>update_takeoff_landings.delay(last_minutes=90)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
Ładowanie…
Reference in New Issue