Installation¶
Voraussetzungen¶
- Python Version >=3.6
- WAM (Installation in der folgenden Anleitung enthalten)
- Git (Linux/Windows) und Git Bash (Windows), falls direkt vom Quellcode installiert wird
Installation (Quellcode-Weg)¶
- Ordner anlegen und in diesen wechseln:
- Linux und Windows (Git Bash):
mkdir ~/StEmp-ABW/
cd ~/StEmp-ABW/
2. GitHub-Repository der WAM klonen und in den Master-Branch wechseln:
- Linux und Windows (Git Bash):
git clone https://github.com/rl-institut/WAM.git WAM
cd ./WAM/
git checkout master
- Einrichtung der WAM.
Entsprechend der WAM-Dokumentation (PostgreSQL, PostGIS, Celery, Umgebungsvariablen, benötigte Pakete etc.). Danach an dieser Stelle weiter.
Anmerkung: In der WAM-Dokumentation wird u. a. beschrieben, wie Sie via Conda eine virtuelle Umgebung erstellen und diese aktivieren. In den nächsten Schritten gehen wir davon aus, dass diese aktiviert ist.
4. GitHub-Repository des StEmp-Tools in das WAM-Verzeichnis klonen und in den Master-Branch wechseln:
- Linux und Windows (Git Bash):
git clone https://github.com/rl-institut/WAM_APP_stemp_abw.git stemp_abw
cd ./stemp_abw/
git checkout master
Anmerkung: falls noch nicht getan, im der Umgebungsvariable WAM_APPS
den Applikationennamen stemp_abw
eintragen - vgl. mit WAM-Dokumentation.
- Datenbankeinrichtung
- Linux und Windows (Git Bash):
Anmerkung: Falls nicht bereits geschehen ins WAM-Stammverzeichnis wechseln, in dem sich die Datei manage.py befindet.
python manage.py makemigrations
python manage.py migrate
- Datenmigration
Die benötigten Daten liegen auf Zenodo
und können mit dem bereitgestellten Skript get_fixtures_stemp_abw.py
über
Django fixtures
installiert werden.
- Linux und Windows (Git Bash):
python manage.py get_fixtures_stemp_abw
python manage.py loaddata stemp-abw_data_<VERSION>.json
Anmerkung: Falls der Downloadvorgang (get_fixtures_stemp_abw
) fehlschlägt, dann einfach den Datensatz von
Zenodo herunterladen, entpacken und die resultierende JSON-Datei
in das Fixtureverzeichnis (stemp_abw/fixtures
) kopieren.
Anmerkung: Der Ladevorgang der JSON-Daten (loaddata
) kann bis zu 15 Minuten dauern.
- Django-Server starten
- Linux und Windows (Git Bash):
./manage.py runserver 8888
Per Browser kann nun auf das Tool zugegriffen werden: http://127.0.0.1:8888/
Note
Kompatibilität: Die Versionsnummern des verwendeten Tools und der Daten müssen übereinstimmen.