Installation, Mise à jour

Installation

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

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 :

Mise à jour de la JRE
Mise à jour du lanceur BD Récif
Mise à jour du programme BD Récif
Mise à jour des fichiers de traductions
Mise à jour des fichiers d’aide

les compoasants de données :

Mise à jour des référentiels de la base de données.
Mise à jour de la configuration d’exploitation
Les plugins, comme le traitement d’export des données (Job Talend).

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: http://doc.e-is.pro/reefdb/reefdb-application.properties

contient la description des dernières versions disponibles.

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.url=zip:@distributionUrl@/fr/ifremer/reefdb/reefdb-ui-swing-launcher/@launcherVersion@/reefdb-ui-swing-launcher-@launcherVersion@-bin.zip

reefdb.version=@projectVersion@ reefdb.url=zip:@distributionUrl@/fr/ifremer/reefdb/reefdb-ui-swing/@projectVersion@/reefdb-ui-swing-@projectVersion@-standalone.zip

i18n.version=@projectVersion@ i18n.url=zip:@distributionUrl@/fr/ifremer/reefdb/reefdb-ui-swing/@projectVersion@/reefdb-ui-swing-@projectVersion@-i18n.zip

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: http://doc.e-is.pro/reefdb/reefdb-data.properties

db.version=@dbVersion@ db.url=zip:@projectUrl@/reefdb-db-@dbVersion@.zip db.auth=false

config.version=@configVersion@ config.url=zip:@projectUrl@/reefdb-config.zip config.auth=false

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 .

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é puis l’application l’intègre.

Chaque composant téléchargeable doit être un fichier zip (mais d’autre formats d’archivage sont possibles) et contenir un seul répertoire (il n’est pas 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.

Pour pouvoir définir une nouvelle mise à jour, il faut donc modifier le fichier de mises à jour :

changer la version du composant
créer l’archive de la mise à jour
changer l’url de téléchargement du composant.
déployer l’archive

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.

Pour pouvoir créer une nouvelle version de BD Récif, il nous faut connaitre la dernière mise à jour de la base.

Ainsi nous pourrons monter les versions du fichier de mise à jour automatiquement.

Les autres composants (jre, BD Récif, i18n, help, plugins) sont automatiquement gérés lors de la création de la nouvelle version.