choucas-docs Documentation
Transcription
choucas-docs Documentation
choucas-docs Documentation Version latest 17 September 2016 Table des matières 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-docs Documentation, Version latest Contents : Ceci est la documentation du projet CHOUCAS en cours de développement. Table des matières 1 choucas-docs Documentation, Version latest 2 Table des matières CHAPITRE 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 python manage.py loaddata... python manage.py makemigrations python manage.py migrate 3 choucas-docs Documentation, Version latest *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 Chapitre 1. INSTALLATION CHAPITRE 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-docs Documentation, Version latest 6 Chapitre 2. CONFIGURATION CHAPITRE 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 — Secouriste — Capacité d’inclure un client html5 - requérant Module SMS : — SMS particulier, groupe — SMS automatique — Répertoire — Communication avec secouriste 7 choucas-docs Documentation, Version latest Module Alerte Secours Montagne Chaque module est accessible depuis le bandeau vertical. 8 Chapitre 3. MANUEL UTILISATEUR CHAPITRE 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-docs Documentation, Version latest 10 Chapitre 4. AUTEURS CHAPITRE 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-docs Documentation, Version latest 12 Chapitre 5. CHANGELOG CHAPITRE 6 Indices and tables — genindex — modindex — search 13