Aller au contenu principal

Configuration

Premier utilisateur​

Connectez-vous à l'application avec le service d'authentification préalablement configuré.

Pour faire de ce premier utilisateur un administrateur (après sa connexion), exécutez en SQL :

INSERT INTO lebontag.lbt_user_userrole (u_id, ur_id) VALUES(1, 1);

Données OSM​

Données OSM de référence​

Les données OSM de référence doivent contenir certaines métadonnées (contributeur, date, changeset, etc.).

Rendez-vous sur https://download.openstreetmap.fr/extracts/europe/ et téléchargez le fichier contenant votre zone de travail, par exemple :

Placez le fichier téléchargé sur le serveur, dans "/opt/lebontag-v2/osm/source/".

Renommez-le "data.osm.pbf" (ou alors modifiez le paramètre "osm_pbffile" en base ou depuis l'interface d'administration).

Attention : ne jamais supprimer ce fichier, il sera utilisé par l'application pour charger les données.

Téléchargez également le fichier "state.txt" associé, par exemple :

Notez le nombre de la "sequenceNumber" contenu dans ce fichier, par exemple : 6844104.

Écrivez ce nombre dans le nouveau fichier /opt/lebontag-v2/osm/replication/sequence.txt, par exemple :

$ echo 6844104 > /opt/lebontag-v2/osm/replication/sequence.txt

Remplacez 0000000 par ce nombre dans la table lebontag.lbt_repl_state, par exemple :

UPDATE lebontag.lbt_repl_state SET last_done_seq=6844104 WHERE id=1;

Spécifiez l'URL de réplication des données (fichiers de diff par minute) à partir de "https://download.openstreetmap.fr/replication".

Par exemple "https://download.openstreetmap.fr/replication/europe/france/languedoc_roussillon/herault/minute/".

En SQL :

INSERT INTO lebontag.lbt_setting (s_name, s_value) VALUES ('osm_repl_server','https://download.openstreetmap.fr/replication/europe/france/languedoc_roussillon/herault/minute/') ON CONFLICT (s_name) DO UPDATE SET s_value = EXCLUDED.s_value;

Enfin, déclenchez le chargement des données de référence dans la base à l'aide d'un script osm2pgsql :

$ sudo -E /opt/lebontag-v2/scripts/lbt-load-data.sh

Le fichier journal du chargement sera créé dans "/opt/lebontag-v2/log/lbt-load-data/". Vérifiez son contenu.

CRON​

Les 2 tâches CRON suivantes nettoient les logs et les fichiers téléchargés et mettent à jour la base osm2pgsql avec les objets validés dans LeBonTag.

echo 'MAILTO=""
0 0 * * * root /opt/lebontag-v2/cron/lbt-cleaning.sh
0 1 * * * root /opt/lebontag-v2/cron/lbt-update-db-by-osc.sh' > /etc/cron.d/lebontag-v2

Service de réplication​

Ce service télécharge et agrège chaque heure les mises à jour OSM par minute (il remplace l'ancien appel à une API Overpass).

Avant d'activer ce service, au moins 1 emprise doit avoir été créée dans l'application.

$ cp /opt/lebontag-v2/services/* /etc/systemd/system/
$ systemctl daemon-reload
$ systemctl enable --now lbt-pipeline.timer

Pour exécuter immédiatement le service :

$ systemctl start lbt-pipeline.service

Configuration depuis l'interface​

  • Associez les utilisateurs à des emprises, des groupes métier, des rôles, etc.
  • Activez des groupes d'objets ou créez-en de nouveaux.
  • Paramétrez les droits de validation.

Journalisation​

  • /log/lbt-autovalidation : objets OSM auto-validés
  • /log/lbt-fetch : récupération des objets OSM modifiés
  • /log/lbt-footprints-intersection : intersection entre objets modifiés et emprises
  • /log/lbt-load-data : chargement des données de référence
  • /log/lbt-update-db-by-osc : mise à jour de la base de données par les objets validés