Bevor wir mit der Installation der Anwendung starten können, müssen wir zunächst den Client herunterladen. Der folgenden Link führt Sie zum Archiv cesium_client.tar.gz, welches die komplette Anwendung (clientseitiges JavaScript sowie serverseitiges Django-Framework) enthält:
Folgen Sie dem obigen Link und entpacken Sie das Archiv (z.B.) in den Ordner /home/user/Documents/workshop_webgis3d/cesium_client.
Nun können wir mit der eigentlichen Installation starten, zu der nur einige wenige Schritte notwendig sind:
Anlegen einer Datenbank für die Applikationslogik (Userobjekte etc.) sowie für die hochgeladenen GPX-Tracks. Öffnen Sie hierzu PgAdmin (Applications - Development - pgAdmin III), verbinden Sie sich mit localhost und erstellen Sie eine Datenbank mit dem Namen db_cesium:
CREATE DATABASE db_cesium;
Erweitern Sie die Datenbank um räumliche Operationen durch die Aktivierung von PostGIS (und prüfen Sie ggf. die erfolgreiche Installation):
CREATE EXTENSION postgis;
SELECT PostGIS_full_version();
Mit der obigen Datenbank sind alle Voraussetzungen für Django geschaffen. Bevor wir den Server (und damit die Anwendung) starten können, sollten wir die globalen systemabhängigen Einstellungen in Django auf Korrektheit prüfen. Da Django in Python geschrieben ist, ist Python (Version 2 oder 3) zwingend erforderlich. Prüfen Sie zunächst, ob in der Datei /cesium_client/geodjango/manage.py der korrekter Pfad zu Python eingetragen ist. Da unser Programmcode in Python3 geschrieben ist, muss dieser zu der Installation von Python 3 führen. Prüfen Sie dazu, ob Python 3 installiert ist und in welchem Pfad der Python-Interpreter installiert ist, indem Sie den folgenden Befehl in der Konsole ausführen:
whereis python3
Ist Python 3 installiert, kontrollieren Sie ob die erste Zeile in der o.g. manage.py den folgenden Angaben entspricht:
#!/usr/bin/env python3
Neben der korrekten Python Version ist es möglich, weitere globale Einstellungen für Django (z.B. Name der Datenbank) anzupassen. Öffnen Sie hierzu die Datei /cesium_client/geodjango/geodjango/settings.py und kontrollieren Sie, ob die Anagben innerhalb des Blocks DATABASES korrekt sind. Der Datenbankname muss dem zuvor erstellten Namen db_cesium entsprechen und für eine erfolgreiche Verbindung müssen die Datenbankverbingsparameter mit denen dieser DB übereinstimmen.
Sind die Datenbank angelegt und die Django-Einstellungen korrekt, können wir im Weiteren alle für die Appliaktion notwendigen Tabellen automatisiert von Django anlegen lassen. Öffnen Sie das Terminal und navigieren Sie dort zu dem Verzeichnis /home/user/Documents/workshop_webgis3d/cesium_client. Innerhalb dieses Ordners befindet sich die Datei ./manage.py, über die wir diverse Django-Operationen durchführen können. Bevor wir die Datei als Programm ausführen können, muss diese dem Betriebssystem als ausführbar gekennzeichnet werden. Machen Sie die Datei durch den folgenden Befehl im Terminal ausführbar:
chmod +x manage.py
Führen Sie im Anschluss den folgenden Befehl aus, um eine Datenbank-Synchronisation vorzunehmen:
./manage.py syncdb
Im Verlauf der Installation wird ein Superuser für die lokale Installation von Django angelegt. Wählen Sie hier einen beliebigen Namen und ein Kennwort und notieren Sie sich diese.
Einzig durch die vorherigen vier (!) Schritte sind Django und damit auch der Cesium-Client einsatzfähig. Der letzte Schritt ist das Starten eines Webservers, über den unsere Applikation erreichbar gemacht wird. Für die Entwicklung und einfache Demozwecke ist es ausreichend, den Djano eigenen Developmentserver zu nutzen. Diesen können wir im Terminal über den folgenden Befehl starten (aus dem gleichen Verzeichnis wie den vorheringen syncdb Befehl):
./manage.py runserver
Django ist up and running! Sie können den Client nun über die folgende URL in Ihrem Browser aufrufen und sich mit Ihrem User, den Sie während der Datenbank- Initialisierung angelegt haben, im Portal anmelden:
http://localhost:8000/static/client/index.html
Während der Arbeit mit Django muss das Terminal geöffnet bleiben, der Server kann mit der Tastenkombination Strg+C beendet werden.
Bemerkung
Möchten Sie sich - am Beispiel dieses Clients oder eines neuen Projekts - weiter in Django vertiefen, finden Sie in der offiziellen Dokumentation viele Hinweise und gute Tutorials. Für den ersten Einstieg ist das folgende Tutorial sehr empfehlenswert:
Sie haben mit wenigen Schritten Ihren ersten 3D-Client initialisiert. Als nächstes wollen wir mehr über die Funktionen des Clients erfahren und einen GPX-Track in das Portal laden.
