From c1a451fee8192139b7f79353d28ae68e4c5a0866 Mon Sep 17 00:00:00 2001
From: Anthony Borghi <anthony.borghi@veremes.com>
Date: Mon, 11 Feb 2019 16:39:17 +0100
Subject: [PATCH] =?UTF-8?q?ajout=20d'une=20proc=C3=A9dure=20de=20mise=20?=
=?UTF-8?q?=C3=A0=20jour=20et=20des=20sp=C3=A9cificit=C3=A9s=20pour=20la?=
=?UTF-8?q?=20version=202019.01.00?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
index_installation.rst | 1 +
installation/procedure_maj_gtf.md | 127 ++++++++++++++++++++++++++++++
2 files changed, 128 insertions(+)
create mode 100644 installation/procedure_maj_gtf.md
diff --git a/index_installation.rst b/index_installation.rst
index f3949b7..55720ac 100644
--- a/index_installation.rst
+++ b/index_installation.rst
@@ -5,3 +5,4 @@ Installation
:maxdepth: 2
installation/procedure_installation_gtf
+ installation/procedure_maj_gtf
diff --git a/installation/procedure_maj_gtf.md b/installation/procedure_maj_gtf.md
new file mode 100644
index 0000000..1aba847
--- /dev/null
+++ b/installation/procedure_maj_gtf.md
@@ -0,0 +1,127 @@
+# Procédure de mise à jour
+
+GTF dispose d’un installateur spécifique VAI qui permet d’assurer l’installation et la mise à jour du produit sans perte de configuration ni de données.
+
+## 1. Prérequis
+
+Avant toute mise à jour de GTF, pensez à sauvegarder tous les fichiers que vous avez pu modifier, en dehors de l'application. (properties du moteur, licence GTF, license(s) FME, templates de mail pour la création de compte / récupération de mot de passe, ...).
+
+## 2. Mise à jour de GTF
+
+Pour mettre à jour GTF, éditez le fichier update.cmd (Windows) ou update.sh (Linux) afin de définir les paramètres de votre installation.
+
+Les variables à modifier pour la mise à jour sont :
+
+<table align="center" class="docutils" border="1">
+<thead valign="middle" align="center">
+ <tr class="row-odd">
+ <td>
+ <b>Variable</b>
+ </td>
+ <td>
+ <b>Description</b>
+ </td>
+ </tr>
+</thead>
+
+<tbody valign="middle">
+<tr class="row-even">
+ <td>
+ dir
+ </td>
+ <td>
+ Répertoire d'installation (/var/www/gtf préférable pour Linux C:/server/gtf conseillé pour Windows)
+ </td>
+</tr>
+
+<tr class="row-odd">
+ <td>
+ dblogin
+ </td>
+ <td>
+ Compte d'un superutilisateur de la base
+ </td>
+</tr>
+
+<tr class="row-odd">
+ <td>
+ dbpswd
+ </td>
+ <td>
+ Mot de passe du compte superutilisateur
+ </td>
+</tr>
+
+<tr class="row-odd">
+ <td>
+ apacheService
+ </td>
+ <td>
+ Nom du service Apache exploité par l'application
+ </td>
+</tr>
+
+<tr class="row-odd">
+ <td>
+ apachePort
+ </td>
+ <td>
+ Port du service https du serveur Apache
+ </td>
+</tr>
+
+</tbody>
+</table>
+
+L’installateur de GTF (en mise à jour) assure les opérations suivantes :
+- Copie du code du serveur d’application Vitis
+- Copie du code du moteur GTF
+- Mise à jour du PHP
+- Configuration du serveur HTTPS Apache
+- Mise à jour de la base de données dans PostgreSQL
+
+
+Sur Linux, donner les droits d’exécution aux fichiers update.sh et setup_gtf-[version_gtf].[build_gtf].
+```
+chmod +x update.sh
+chmod +x setup_gtf-[version_gtf].[build_gtf]
+```
+
+Exécutez le script update.cmd ou update.sh pour lancer l’installation.
+
+
+Sur Windows, il faut attendre une minute environ pour avoir un retour dans la console.
+
+## 3. Spécificités liées aux versions
+
+### 2019.01.00
+
+#### SMTP
+
+Les properties liées aux paramètrage SMTP ont été déplacées dans les properties de Vitis.
+
+Pour éviter que l'application n'utilise les informations de GTF à la place des properties de Vitis, il est préférable de déplacer la configuration SMTP dans le fichier **[dir]/vas/rest/conf/gtf/properties.conf** dans le fichier **[dir]/vas/rest/conf/properties.conf**.
+
+Liste des properties concernées :
+```
+$properties['mail_sender'] = '************';
+$properties['nickname_sender'] = 'GTF v2019';
+$properties['smtp_host'] = '************';
+$properties['smtp_port'] = 587;
+$properties['smtp_authentification'] = true;
+$properties['smtp_login'] = '************';
+$properties['smtp_password'] = '************';
+```
+
+#### Template de mail par défaut
+
+Vous pourrez mettre à jour votre temlate de mail par défaut pour intégrer les nouvelles fonctionnalités :
+- Cryptage du résultat des traitements FME
+- Utilisation de l'interface de fichier pour délocalisation du système de fichiers
+- Utilisation d'un proxy interne à l'application pour améliorer la sécurité de vos logs et résultats FME.
+
+Dans la version 2019.01.00, un nouveau template de mail fera son apparition **default-v2019.01.00**.
+
+Si vous avez modifié le template de mail **default**, il faudra reprendre votre template pour integrer les nouveautés de **default-v2019.01.00**.
+
+Sinon vous pourrez simplement copier-coller **default-v2019.01.00** dans **default**. Vous pouvez aussi ne pas tenir compte des ses améliorations, mais il est possible que votre template ne fonctionne plus lors de l'activation d'une nouvelle fonctionnalité.
--
GitLab