Choucas Documentation Release latest September 09, 2016 Contents 1 INSTALLATION 1.1 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3 3 2 CONFIGURATION 2.1 Principe de l’application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.2 Configurer l’application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5 5 3 MANUEL UTILISATEUR 3.1 Screencasts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.2 Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7 7 4 AUTEURS 4.1 Credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 9 5 CHANGELOG 5.1 0.5 (2016-09-05) 5.2 0.4 (2016-09-03) 5.3 0.3 (2016-08-31) 5.4 0.2 (2016-08-06) 6 Indices and tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 11 11 11 11 13 i ii Choucas Documentation, Release latest Contents: Ceci est la documentation du projet CHOUCAS en cours de développement. Contents 1 Choucas Documentation, Release latest 2 Contents CHAPTER 1 INSTALLATION Ces instructions décrivent l’installation de Choucas sur un serveur de développement. 1.1 Requirements • Ubuntu Server 12.04 Precise Pangolin (http://releases.ubuntu.com/12.04/) or Ubuntu Server 14.04 Trusty Tahr (http://releases.ubuntu.com/14.04/) or Ubuntu Server 16.04 Xenial (http://releases.ubuntu.com/16.04/) A first estimation on system resources is : • 1 Go RAM • 10 Go disk space 1.2 Installation Installation postgresql/postgis Installation python Installation pip Installation git Installation virtualenv virtualenv projet source projet/bin/activate git clone dépot cd choucas pip install -r requirements.txt Edition settings.py *Création DB python manage.py makemigrations python manage.py migrate *Chargement des données fixtures 3 Choucas Documentation, Release latest python manage.py loaddata... python manage.py makemigrations python manage.py migrate *Démarrage du serveur python manage.py runserver Accès au serveur localhost http://localhost:8000 http://localhost:8000/admin Once the OS is installed (basic installation, with OpenSSH server), install the last version with the following commands : curl https://raw.githubusercontent.com/makinacorpus/Geotrek/master/install.sh > install.sh chmod +x install.sh ./install.sh You will be prompt for editing the base configuration file (settings.ini), using the default editor. notes If you leave localhost for the database host (dbhost value), a Postgresql with PostGis will be installed locally. In order to use a remote server (recommended), set the appropriate values for the connection. The connection must be operational (it will be tested during install). To make sure the application runs well after a reboot, try now : sudo reboot. And access the application http://yourserver/. You will be prompted for login, jump to loading data section, to create the admin user and fill the database with your data! Then edit etc/settings.ini to update host variable and /settings/custom.py to update IGN key. Install Geotrek on the new server: ./install.sh Restore database on the new server: sudo sudo sudo sudo make sudo 4 service geotrek stop -u postgres psql -c "drop database geotrekdb;" -u postgres psql -c "create database geotrekdb owner geotrek;" -u postgres pg_restore -d geotrekdb geotrekdb.backup update service geotrek start Chapter 1. INSTALLATION CHAPTER 2 CONFIGURATION 2.1 Principe de l’application Principe général : L’application permet de code blabla sdkjfkjdshf Dans cet exemple, le fichier contient : • l • l 2.2 Configurer l’application Rendez vous dans le fichier /choucas/settings.py, c’est ce fichier qui est la base de la configuration de l’application. Modifier nom de domaine de l’application $config['url'] = 'http://mon-domaine.com'; 5 Choucas Documentation, Release latest 6 Chapter 2. CONFIGURATION CHAPTER 3 MANUEL UTILISATEUR ... en cours de rédaction ... 3.1 Screencasts ( En français ) • Interface utilisateur • Interface administration 3.2 Modules Choucas est composé de différents modules. Outils cartographiques : • visualisation de couches de fond IGN, OSM... • visualisation de couches overlay (Ski, limites géo) • visualisation de couches métier (webcam, interventions, taracking) • Outils de recherche floue sur données ign, nominatim, BAN et métier • Accessoires à la carte (échelle, coordonnées sous curseur) • Saisie de coordonnées • Affichage altitude, commune sur évenement Gendloc - Outil de géolocalisation SMS/HTML5 : • SMS de localisation • SMS de tracking • SMS de partage photo Module de chat : • Salle opérationnelle • Postes avancés • Commandement 7 Choucas Documentation, Release latest • Secouriste • Capacité d’inclure un client html5 - requérant Module SMS : • SMS particulier, groupe • SMS automatique • Répertoire • Communication avec secouriste Module Alerte Secours Montagne Chaque module est accessible depuis le bandeau vertical. 8 Chapter 3. MANUEL UTILISATEUR CHAPTER 4 AUTEURS • Oton Čopi • Olivier Favre 4.1 Credits • django-leaflet by Makina Corpus • django-geojson by Makina Corpus • django-settings-export by Jakub Roztocil 9 Choucas Documentation, Release latest 10 Chapter 4. AUTEURS CHAPTER 5 CHANGELOG 5.1 0.5 (2016-09-05) • Add documentation 5.2 0.4 (2016-09-03) • Nettoyage du projet 5.3 0.3 (2016-08-31) • Add fixture unite • Add baselayers in LeafletGeoAdmin 5.4 0.2 (2016-08-06) • Add login django 11 Choucas Documentation, Release latest 12 Chapter 5. CHANGELOG CHAPTER 6 Indices and tables • genindex • modindex • search 13