Commit 2231d276 authored by PECQUOT's avatar PECQUOT

Merge branch 'release/3.8.0' into develop

parents b950c370 777ba445
......@@ -10,7 +10,7 @@
<groupId>fr.ifremer.reefdb</groupId>
<artifactId>reefdb</artifactId>
<version>3.7.6-SNAPSHOT</version>
<version>3.8.0</version>
<packaging>pom</packaging>
<name>Reef DB</name>
......
......@@ -4,7 +4,7 @@
<parent>
<groupId>fr.ifremer.reefdb</groupId>
<artifactId>reefdb</artifactId>
<version>3.7.6-SNAPSHOT</version>
<version>3.8.0</version>
</parent>
<artifactId>reefdb-core</artifactId>
......
......@@ -4,7 +4,7 @@
<parent>
<groupId>fr.ifremer.reefdb</groupId>
<artifactId>reefdb</artifactId>
<version>3.7.6-SNAPSHOT</version>
<version>3.8.0</version>
</parent>
<artifactId>reefdb-ui-swing</artifactId>
......
==========================================================
Relation entre les versions de l'applicative et de la base
==========================================================
Présentation
------------
......@@ -20,14 +16,12 @@ Historique des versions de base
Le tableau suivant résume les différents liens entre les versions :
+---------------------+-----------------+---------------------------+
| Version BD Récif | Version BD Test | Version schema BD |
+=====================+=================+===========================+
+ 0.1 + 2015.03.06 + 2.4.0 +
+---------------------+-----------------+---------------------------+
+ 2.7.3 + 2015.03.27-2 + 2.4.0.42 +
+---------------------+-----------------+---------------------------+
|---------------------|-----------------|---------------------------|
| 0.1 | 2015.03.06 | 2.4.0 |
| 2.7.3 | 2015.03.27-2 | 2.4.0.42 |
Consulter le [log complet](../../quadrige3-core/fr/versions.html)
Légende :
......@@ -40,8 +34,5 @@ Documentation
Voici la documentation disponible, concernant la base de données embarquée :
- `Tables de la base de données`_ embarquée (HSQLDB);
- `Entitées Hibernate`_, utilisées dans le code et les requêtes Hibernate.
.. _Tables de la base de données: ../quadrige3-core-client/hibernate/tables/index.html
.. _Entitées Hibernate: ../quadrige3-core-client/hibernate/entities/index.html
\ No newline at end of file
- [Tables de la base de données](../../quadrige3-core/quadrige3-core-client/hibernate/tables/index.html) embarquée (HSQLDB);
- [Entitées Hibernate](../../quadrige3-core/quadrige3-core-client/hibernate/entities/index.html), utilisées dans le code et les requêtes Hibernate.
=======
Accueil
=======
.. image:: ../images/splash.png
![splash](../images/splash.png)
Présentation
~~~~~~~~~~~~
------------
Bienvenue sur le site de l'application BD Récif Océan Indien.
**BD Récif** est un outil de saisie de données utilisé pour le suivi et la surveillance des `récifs coraliens`_.
Il est utilisé notamment en océan indien, par l'`Ifrecor`_, l'`Ifremer`_ et le `MNHN`_.
.. _récifs coraliens: https://fr.wikipedia.org/wiki/R%C3%A9cif_corallien
.. _Ifrecor: http://www.ifrecor.com
.. _Ifremer: http://www.ifremer.fr
.. _MNHN: http://www.mnhn.fr
**BD Récif** est un outil de saisie de données utilisé pour le suivi et la surveillance des [récifs coraliens](https://fr.wikipedia.org/wiki/R%C3%A9cif_corallien).
Il est utilisé notamment en océan indien, par l'[Ifrecor](http://www.ifrecor.com), l'[Ifremer](http://www.ifremer.fr) et le [MNHN](http://www.mnhn.fr).
Installation
~~~~~~~~~~~~
------------
- Télécharger la `dernière version stable`_ de l'application ou `une autre version`_.
- Télécharger la [dernière version stable](https://www.ifremer.fr/quadrige3_resources/reefdb/download/reefdb.zip) de l'application ou [une autre version](https://forge.ifremer.fr/frs/?group_id=252).
- Après téléchargement, décompresser l'archive dans un dossier.
Note : Aucun pré-requis logiciel n'est nécessaire au lancement de BD Récif. Nous
préconisons cependant d'avoir au moins 1Go de mémoire.
.. _dernière version stable: https://www.ifremer.fr/quadrige3_resources/reefdb/download/reefdb.zip
.. _une autre version: https://forge.ifremer.fr/frs/?group_id=252
Utilisation
~~~~~~~~~~~
-----------
Lancement
---------
### Lancement
- Sous windows, double-cliquez sur le fichier **reefdb.exe**.
- Sous linux, exécuter le fichier **reefdb.sh**.
Première utilisation
--------------------
### Première utilisation
Lors d'une première utilisation, l'application démarre et affiche l'écran de
gestion des bases de travail. Il suffit alors d'installer une base via l'action
......@@ -61,21 +48,16 @@ fonctionnel.
Note: Il est aussi possible de restaurer une base de données depuis un fichier zip via l'action **Restaurer**.
Besoin d'aide ?
---------------
Pour comprendre le fonctionnement et l'usage des écrans de l'application, consultez `le manuel utilisateur`_.
.. _le manuel utilisateur: http://wwz.ifremer.fr/quadrige3_support/BD-Recif/Manuel-utilisateur-Fiches-Techniques
### Besoin d'aide ?
Pour comprendre le fonctionnement et l'usage des écrans de l'application, consultez [le manuel utilisateur](http://wwz.ifremer.fr/quadrige3_support/BD-Recif/Manuel-utilisateur-Fiches-Techniques).
En cas de problème technique, `contactez le support`_ de la cellule d'administration de Quadrige².
En cas de problème technique, [contactez le support](http://wwz.ifremer.fr/quadrige3_support) de la cellule d'administration de Quadrige².
.. _contactez le support: http://wwz.ifremer.fr/quadrige3_support
Captures d'écran
~~~~~~~~~~~~~~~~
----------------
- Ecran de saisie principale :
.. image:: ../images/screenshot_home.png
\ No newline at end of file
![screenshot](../images/screenshot_home.png)
\ No newline at end of file
==========================================
Installation du serveur de synchronisation
==========================================
Cette page décrit comment installer le serveur servant à la synchronisation vers une base quadrige3.
Pré-requis
~~~~~~~~~~
----------
Avant l'installation du serveur, veuillez vérifier les éléments suivants :
......@@ -17,13 +14,11 @@ Avant l'installation du serveur, veuillez vérifier les éléments suivants :
Utiliser pour cela l'outil Quadrige².
Installation du serveur
~~~~~~~~~~~~~~~~~~~~~~~
-----------------------
Déploiement sans Tomcat (version autonome)
------------------------------------------
### Déploiement sans Tomcat (version autonome)
Télécharger la dernière version de l'application serveur en `cliquant ici
<https://forge.ifremer.fr/frs/?group_id=252#title_quadrige3-synchro-server>`_ .
Télécharger la dernière version de l'application serveur en [cliquant ici](https://forge.ifremer.fr/frs/?group_id=252#title_quadrige3-synchro-server)
Puis suivez les étapes suivantes :
......@@ -60,8 +55,7 @@ note :
Ces écrans servent uniquement pour le développement et les tests (ex: pour vérifier que le serveur est bien démarré).
Déploiement avec Tomcat
-----------------------
### Déploiement avec Tomcat
**Configuration par variables d'environnement**
......@@ -84,24 +78,23 @@ Vouc pouvez choisir de déployer sous une serveur Tomcat :
Editer le fichier ``<TOMCAT_HOME>/bin/startup.sh``.
Ajouter, tout en haut du script, les lignes suivantes ::
quadrige3_config_path=/path/to/config/file; export quadrige3_config_path
quadrige3_workspace_path=/path/to/working/directory; export quadrige3_workspace_path
JAVA_OPTS="${JAVA_OPTS} -Dquadrige3.basedir=${quadrige3_workspace_path} -Dsynchro-server.config=${quadrige3_config_path}"; export JAVA_OPTS
Ajouter, tout en haut du script, les lignes suivantes :
quadrige3_config_path=/path/to/config/file; export quadrige3_config_path
quadrige3_workspace_path=/path/to/working/directory; export quadrige3_workspace_path
JAVA_OPTS="${JAVA_OPTS} -Dquadrige3.basedir=${quadrige3_workspace_path} -Dsynchro-server.config=${quadrige3_config_path}"; export JAVA_OPTS
* Sous Windows :
Editer le script de lancement de Tomcat ``<TOMCAT_HOME>/bin/startup.bat``
Ajouter, tout en haut du script, les lignes suivantes ::
Ajouter, tout en haut du script, les lignes suivantes :
set quadrige3_config_path=c:\path\to\config\file
set quadrige3_workspace_path=c:\path\to\working\directory
set JAVA_OPTS=-Dquadrige3.basedir=${quadrige3_workspace_path} -Dsynchro-server.config=${quadrige3_config_path}
set quadrige3_config_path=c:\path\to\config\file
set quadrige3_workspace_path=c:\path\to\working\directory
set JAVA_OPTS=-Dquadrige3.basedir=${quadrige3_workspace_path} -Dsynchro-server.config=${quadrige3_config_path}
.
**Configuration par contexte (META-INF/context.xml)**
......@@ -113,28 +106,28 @@ Un déploiement sans modification des scripts de Tomcat est possible :
- Editer le fichier ``<UNZIPED_WAR>/META-INF/context.xml``
- Décommenté les parties XML suivantes, et renseigner les attributs XML : ``url``, ``username``, ``password``, ``value`` (``/path/to/config/file``) ::
<Resource
name="quadrige3-ds"
auth="Container"
type="javax.sql.DataSource"
driverClassName="oracle.jdbc.driver.OracleDriver"
url="jdbc:oracle:thin:@<HOST>:1521:<INSTANCE>"
username="<USER>"
password="<PWD>"
maxActive="20"
maxIdle="2"
maxWait="-1"
/>
<!-- Use to set the configuration file path (default path is: <WAR>/WEB-INF/classes/synchro-server.config) -->
<Environment
name="synchro-server.config"
type="java.lang.String"
value="/path/to/config/file"
override="false"
/>
- Décommenté les parties XML suivantes, et renseigner les attributs XML : ``url``, ``username``, ``password``, ``value`` (``/path/to/config/file``) :
> <Resource
> name="quadrige3-ds"
> auth="Container"
> type="javax.sql.DataSource"
> driverClassName="oracle.jdbc.driver.OracleDriver"
> url="jdbc:oracle:thin:@HOST:1521:INSTANCE"
> username="USER"
> password="PWD"
> maxActive="20"
> maxIdle="2"
> maxWait="-1"
> />
>
> <!-- Use to set the configuration file path (default path is: <WAR>/WEB-INF/classes/synchro-server.config) -->
> <Environment
> name="synchro-server.config"
> type="java.lang.String"
> value="/path/to/config/file"
> override="false"
> />
- Reconstruire le fichier ``.war``, puis dployer sous Tomcat comme précédemment (sans modifier les scripts de lancement).
......@@ -144,16 +137,16 @@ note :
Configuration du client
~~~~~~~~~~~~~~~~~~~~~~~
-----------------------
Pour utiliser le serveur de synchronisation, il faut :
- Télécharger et dézipper BD Récif (cliquer `ici
<https://forge.ifremer.fr/frs/?group_id=252#title_bdrecif>`_). Si nécessaire laisser la mise à jour automatique se faire.
- Télécharger et dézipper BD Récif (cliquer [ici](https://forge.ifremer.fr/frs/?group_id=252#title_bdrecif).
Si nécessaire laisser la mise à jour automatique se faire.
- Fermer BD Récif
- Editer le fichier <REEFDB>/config/reefdb.config et ajouter les lignes suivantes :
- Editer le fichier ``<REEFDB>/config/reefdb.config`` et ajouter les lignes suivantes :
* reefdb.synchronization.site.url=http\://localhost\:8080
* reefdb.authentication.extranet.site.url=${reefdb.synchronization.site.url}
* reefdb.authentication.intranet.site.url=${reefdb.synchronization.site.url}
......@@ -165,9 +158,9 @@ Pour utiliser le serveur de synchronisation, il faut :
=> La synchronisation sera bien accessible (menu activé)
Troubleshooting
~~~~~~~~~~~~~~~
---------------
Les modifications faites dans les tables du référentiel ne sont pas visibles tous de suite, lorsque l'on déclenche une importation des données.
Il est cependant possible de réduire le délai d'attente, en appellant (depuis un navigateur) l'adresse suivante :
http://<HOST>:<PORT>/<WEBAPP_NAME>/service/import/referential/updateDate/clear
``http://<HOST>:<PORT>/<WEBAPP_NAME>/service/import/referential/updateDate/clear``
=========================
Installation, Mise à jour
=========================
Installation
~~~~~~~~~~~~
------------
Authentification serveur
------------------------
### Authentification serveur
Certaines actions de l'application nécessitent l'authentification de l'utilisateur, comme la suppression d'une observation ou d'une enquête.
Pour cela, l'application effectue des requêtes HTTP sur deux url paramétrables (Intranet et Extranet)
......@@ -23,11 +19,8 @@ et la connexion au site d'authentification ne sera plus nécessaire.
Les paramètres à configurer :
- reefdb.authentication.intranet.site.url : url d'authentification Intranet
- reefdb.authentication.intranet.site.timeout : délai d'attente Intranet en ms (par défaut 5000)
- reefdb.authentication.extranet.site.url : url d'authentification Extranet
- reefdb.authentication.extranet.site.timeout : délai d'attente Extranet en ms (par défaut 5000)
Note: Pour une utilisation en mode testeur, il est possible de désactiver l'authentification en configurant :
......@@ -40,11 +33,10 @@ Dans ce mode, la synchronisation des données vers le serveur sera désactivée.
-----
Mise à jour automatique
~~~~~~~~~~~~~~~~~~~~~~~
-----------------------
Présentation
------------
### Présentation
**BD Récif** utilise un mécanisme simple pour effectuer les mises à jour de ses
différents composants.
......@@ -53,20 +45,19 @@ On distingue deux types de composants :
- les composants logiciels :
1. Mise à jour de la JRE
2. Mise à jour du lanceur BD Récif
3. Mise à jour du programme BD Récif
4. Mise à jour des fichiers de traductions
5. Mise à jour des fichiers d'aide
1. Mise à jour de la JRE
2. Mise à jour du lanceur BD Récif
3. Mise à jour du programme BD Récif
4. Mise à jour des fichiers de traductions
5. Mise à jour des fichiers d'aide
- les compoasants de données :
1. Mise à jour des référentiels de la base de données.
2. Mise à jour de la configuration d'exploitation
3. Les plugins, comme le traitement d'export des données (Job Talend).
1. Mise à jour des référentiels de la base de données.
2. Mise à jour de la configuration d'exploitation
3. Les plugins, comme le traitement d'export des données (Job Talend).
Principe des mises à jour
-------------------------
### Principe des mises à jour
Chaque composant est contenu dans un répertoire et possède un fichier
obligatoirement nommé **version.appup** qui contient la version du composant.
......@@ -80,55 +71,45 @@ ${project.url}/reefdb-application.properties
contient la description des dernières versions disponibles.
::
jre.version=@jreVersion@
> jre.version=@jreVersion@
linux.i386.jre.url=zip:http://nexus.nuiton.org/nexus/content/repositories/jvm/com/oracle/jre/@jreVersion@/jre-@jreVersion@-linux-i586.zip
windows.i386.jre.url=zip:http://nexus.nuiton.org/nexus/content/repositories/jvm/com/oracle/jre/@jreVersion@/jre-@jreVersion@-windows-i586.zip
windows.x86.jre.url=zip:http://nexus.nuiton.org/nexus/content/repositories/jvm/com/oracle/jre/@jreVersion@/jre-@jreVersion@-windows-i586.zip
linux.amd64.jre.url=zip:http://nexus.nuiton.org/nexus/content/repositories/jvm/com/oracle/jre/@jreVersion@/jre-@jreVersion@-linux-x64.zip
windows.amd64.jre.url=zip:http://nexus.nuiton.org/nexus/content/repositories/jvm/com/oracle/jre/@jreVersion@/jre-@jreVersion@-windows-x64.zip
launcher.version=@launcherVersion@
> launcher.version=@launcherVersion@
launcher.url=zip:@distributionUrl@/fr/ifremer/reefdb/reefdb-ui-swing-launcher/@launcherVersion@/reefdb-ui-swing-launcher-@launcherVersion@-bin.zip
reefdb.version=@projectVersion@
> reefdb.version=@projectVersion@
reefdb.url=zip:@distributionUrl@/fr/ifremer/reefdb/reefdb-ui-swing/@projectVersion@/reefdb-ui-swing-@projectVersion@-standalone.zip
i18n.version=@projectVersion@
> i18n.version=@projectVersion@
i18n.url=zip:@distributionUrl@/fr/ifremer/reefdb/reefdb-ui-swing/@projectVersion@/reefdb-ui-swing-@projectVersion@-i18n.zip
help.version=@projectVersion@
> help.version=@projectVersion@
help.url=zip:@distributionUrl@/fr/ifremer/reefdb/reefdb-ui-swing/@projectVersion@/reefdb-ui-swing-@projectVersion@-help.zip
Pour les composants de données, on utilise le fichier de propriétés disponible
sur le réseau à l'adresse suivante:
${project.url}/reefdb-data.properties
::
db.version=@dbVersion@
> db.version=@dbVersion@
db.url=zip:@projectUrl@/reefdb-db-@dbVersion@.zip
db.auth=false
config.version=@configVersion@
> config.version=@configVersion@
config.url=zip:@projectUrl@/reefdb-config.zip
config.auth=false
Mise à jour de la configuration en exploitation
-----------------------------------------------
### Mise à jour de la configuration en exploitation
La section 'config' dans le fichier de configuration des composants de données, donne la possibilité de fixer certaines options de BD Récif dans l'environnement d'exploitation.
Dans le fichier reefdb.config (inclus dans l'archive pointée par 'config.url'), on peut par exemple spécifier les urls d'authentification, du serveur de synchronisation,
ainsi que toute option de la `Configuration`_ .
.. _Configuration: ./config-report.html#detail_reefdb
ainsi que toute option de la [Configuration](./config-report.html#detail_reefdb) .
Utilisation dans BD Récif
-------------------------
### Utilisation dans BD Récif
Au démarrage de l'application le fichier est lu et si un des composants est
plus récent dans la description du fichier de mises à jour, il est téléchargé
......@@ -140,8 +121,7 @@ possible d'avoir le composant directement à la racine de l'archive).
Vous pouvez télécharger les composants fournis dans le fichier des mises à jours.
Mettre en place une nouvelle mise à jour
----------------------------------------
### Mettre en place une nouvelle mise à jour
Pour pouvoir définir une nouvelle mise à jour, il faut donc modifier le fichier
de mises à jour :
......@@ -151,16 +131,14 @@ de mises à jour :
3. changer l'url de téléchargement du composant.
4. déployer l'archive
Mise à jour sécurisées
----------------------
### Mise à jour sécurisées
La mise à jour de la base est sécurisée, à savoir que l'url d'accès au zip de
la base requière un mot de passe.
Le fichier de mise à jour quand à lui sera toujours disponible publiquement.
Pré-requis à la création d'une nouvelle version de BD Récif
-----------------------------------------------------------
### Pré-requis à la création d'une nouvelle version de BD Récif
Pour pouvoir créer une nouvelle version de BD Récif, il nous faut connaitre la
dernière mise à jour de la base.
......
===============
Fonctionnalités
===============
Abstract
--------
Ce document décrit les fonctionnalités de la **BD Récif**, à savoir:
- `Gestionnaire de base`_
- `Gestionnaire de référentiel`_
Gestionnaire de base
--------------------
La BD Récif utilise une base de travail compatible **quadrige3**, l'application permet
de gérer ces bases, à savoir :
- Installer une base à partir d'une url distante via le mécanisme de mise à jour intégré.
- Mise à jour automatique via le mécanisme de mise à jour intégré (mis à jour des référentiels).
- Archiver les données de BD Récif (base de travail / pièces-jointes) (sous forme d'archive zip).
- Archiver les données de BD Récif puis les supprimer , permet alors de pouvoir installer une nouvelle base ou importer des données de BD Récif.
- Restaurer les données de BD Récif : permet d'importer les données d'une autre instance de BD Récif précedemment exportées.
Le format de l'archive d'un export est le suivant :
::
reefdb-1.0/
|-- data
| |-- db
| | |-- quadrige3.data
| | |-- quadrige3.log
| | |-- quadrige3.properties
| | |-- quadrige3.script
| | `-- version.appup
| `-- meas_files
| `-- SAMPLE
| |-- OBJ100000
| | `-- SAMPLE-OBJ100000-100002.asc
| |-- OBJ100015
| | `-- SAMPLE-OBJ100015-100001.dat
| |-- OBJ100018
| | `-- SAMPLE-OBJ100018-100002.dat
| |-- OBJ100022
| | `-- SAMPLE-OBJ100022-100003.dat
| `-- OBJ100040
| `-- SAMPLE-OBJ100040-100004.dat
`-- config
|-- reefdb.config
`-- version.appup
Pour le moment si vous voulez restaurer une base sans les autres données
(pièces-jointes), il vous suffit alors simplement de créer une
archive zip qui respecte ce format.
Pour utiliser ces fonctionnalités, rendez-vous sur l'écran **Gestionnaire de base**
(Menu fichier -> Gestionnaire de base).
Gestionnaire de référentiel
---------------------------
BD Récif permet de gérer certains référentiels temporaires via des imports csv.
Afin de faciliter l'utilisation du format des imports, il est possible d'exporter
pour chaque type d'import un exemple de fichier avec le bon format.
Pour import ces référentiels, rendez-vous sur l'écran **Import des référentiels
temporaires** (Menu Administration -> Réferentiels temporaires).
A noter que cet écran est protégé par un mot de passe pour mieux contrôler les
ajouts de référentiels.
On décrit les différents imports possibles et leur format.
====
Home
====
.. image:: ./images/splash.png
![splash](./images/splash.png)
Presentation
~~~~~~~~~~~~
------------
Welcome to the technical web site of the Reef DB application.
**Reef DB** (*BD Récif* in french) aims to manage data on `Coral reef`_. It is used in particular in Indian Ocean by
french institutes (`Ifrecor`_, `Ifremer`_, `MNHN`_).
.. _Coral reef: https://en.wikipedia.org/wiki/Coral_reef
.. _Ifrecor: http://www.ifrecor.com
.. _Ifremer: http://www.ifremer.fr
.. _MNHN: http://www.mnhn.fr
**Reef DB** (*BD Récif* in french) aims to manage data on [Coral reef](https://en.wikipedia.org/wiki/Coral_reef).
It is used in particular in Indian Ocean by french institutes ([Ifrecor](http://www.ifrecor.com), [Ifremer](http://www.ifremer.fr), [MNHN](http://www.mnhn.fr)).
Installation
~~~~~~~~~~~~
------------
- Download the `latest release`_ or `another release`_;
- Download the [latest release](https://www.ifremer.fr/quadrige3_resources/reefdb/download/reefdb.zip) or [another release](https://forge.ifremer.fr/frs/?group_id=252);
- Unzip the downloaded archive in a folder.
.. _latest release: https://www.ifremer.fr/quadrige3_resources/reefdb/download/reefdb.zip
.. _another release: https://forge.ifremer.fr/frs/?group_id=252
Use
~~~
---
Launch
------
### Launch
- Under Window, click on file **reefdb.exe**.
- Under linux, launch the file **reefdb.sh**.
First use
---------
### First use
When first used, the application starts and displays the screen of
management of the bases of work. Just install a database via the action
......@@ -53,21 +41,16 @@ This operation can be long (download time): be patient.
Note: It is also possible to restore a database from a zip file via the action **Restore**.
Need help ?
-----------
To be in the use of the screens of the application, refer to `the user manual`_ (french).
.. _the user manual: http://wwz.ifremer.fr/quadrige3_support/BD-Recif/Manuel-utilisateur-Fiches-Techniques
### Need help ?
To be in the use of the screens of the application, refer to [the user manual](http://wwz.ifremer.fr/quadrige3_support/BD-Recif/Manuel-utilisateur-Fiches-Techniques) (french).
In case of a technical problem, `contact the the support`_ of the Quadrige² administration team.
In case of a technical problem, [contact the the support](http://wwz.ifremer.fr/quadrige3_support) of the Quadrige² administration team.
.. _contact the the support: http://wwz.ifremer.fr/quadrige3_support
Screenshot
~~~~~~~~~~
----------
- Main entry screen:
.. image:: ./images/screenshot_home.png
\ No newline at end of file
![screenshot](./images/screenshot_home.png)
\ No newline at end of file
=========================
Installation, Mise à jour
=========================
Installation
~~~~~~~~~~~~
Authentification serveur
------------------------
Certaines actions de l'application nécessitent l'authentification de l'utilisateur, comme la suppression d'une observation ou d'une enquête.
Pour cela, l'application effectue des requêtes HTTP sur deux url paramétrables (Intranet et Extranet)
et vérifie le login/mot de passe par le protocole basic d'authentification HTTP.
Veillez à paramétrer les points d'entrées (sous Apache par exemple) en ouvrant ces url à l'extérieur pour l'Extranet et à l'intérieur pour l'Intranet,
ainsi qu'un fichier .htaccess pointant sur le système de gestion d'authentification utilisateurs adéquat (exemple LDAP).
La première fois qu'un utilisateur s'authentifie correctement, ses informations sont stockées dans la base de données locale de BD Récif
et la connexion au site d'authentification ne sera plus nécessaire.
Les paramètres à configurer :
- reefdb.authentication.intranet.site.url : url d'authentification Intranet
- reefdb.authentication.intranet.site.timeout : délai d'attente Intranet en ms (par défaut 5000)
- reefdb.authentication.extranet.site.url : url d'authentification Extranet
- reefdb.authentication.extranet.site.timeout : délai d'attente Extranet en ms (par défaut 5000)
Note: Pour une utilisation en mode testeur, il est possible de désactiver l'authentification en configurant :
- reefdb.authentication.disabled=true
L'application demandera alors un login/password spécifique que vous devrez demander à votre administrateur.
Dans ce mode, la synchronisation des données vers le serveur sera désactivée.
-----
Mise à jour automatique
~~~~~~~~~~~~~~~~~~~~~~~
Présentation
------------
**BD Récif** utilise un mécanisme simple pour effectuer les mises à jour de ses
différents composants.
On distingue deux types de composants :
- les composants logiciels :
1. Mise à jour de la JRE
2. Mise à jour du lanceur BD Récif
3. Mise à jour du programme BD Récif
4. Mise à jour des fichiers de traductions
5. Mise à jour des fichiers d'aide
- les compoasants de données :
1. Mise à jour des référentiels de la base de données.
2. Mise à jour de la configuration d'exploitation
3. Les plugins, comme le traitement d'export des données (Job Talend).
Principe des mises à jour
-------------------------
Chaque composant est contenu dans un répertoire et possède un fichier
obligatoirement nommé **version.appup** qui contient la version du composant.
Les deux types de composant ont des cylces de vie et de mises à jour différents,
ils sont donc gérés dans deux fichiers sépararés.
Pour les composants logiciels, on utilise le fichier de propriétés disponible
sur le réseau à l'adresse suivante:
${project.url}/reefdb-application.properties
contient la description des dernières versions disponibles.