diff --git a/index_installation.rst b/index_installation.rst index f3949b70634a90e063976211a22a742e30559705..55720acbd3c2379a8c1ea7533ffda2cb2e31e5eb 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 0000000000000000000000000000000000000000..1aba8479815024e3f8a82fa21839095584f95e98 --- /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é.