update doc after deployment

doc/historic/upgrade_v11.md

@@ -57,24 +57,24 @@ A priori pas de blocage, la mise à jour des extensions sera à faire en même t
 
 * déploiement sur test5
 
-    cd /var/opentalent/git/ot_typo3
-    git fetch origin feature/v8-4762-upgrade_v11
-    git checkout feature/v8-4762-upgrade_v11
-    
-    cd /var/www/typo3
+      cd /var/opentalent/git/ot_typo3
+      git fetch origin feature/v8-4762-upgrade_v11
+      git checkout feature/v8-4762-upgrade_v11
+      
+      cd /var/www/typo3
 
 * je copie colle le contenu du composer.json dans celui de test5 
 
-    php7.4 composer.phar update
+      php7.4 composer.phar update
 
 * je met à jour le fichier `cli` avec le bon chemin d'accès : `/var/www/typo3/vendor/bin/typo3`
 
-    mv public/.htaccess public/.htaccess.old
-    cp public/typo3/sysext/install/Resources/Private/FolderStructureTemplateFiles/root-htaccess public/.htaccess
+      mv public/.htaccess public/.htaccess.old
+      cp public/typo3/sysext/install/Resources/Private/FolderStructureTemplateFiles/root-htaccess public/.htaccess
 
 * je rajoute les premières lignes custom du .htaccess
 
-    touch public/typo3conf/ENABLE_INSTALL_TOOL
+      touch public/typo3conf/ENABLE_INSTALL_TOOL
 
 * je me rends à l'adresse `https://sub.test5.opentalent.fr/typo3/install.php`
 * je lance la maj de la structure de la DB
@@ -97,3 +97,166 @@ Je renomme le fichier composer.json et je créé un symlink vers le nouveau comp
     mv composer.json composer.json.orig
     ln -s /var/opentalent/git/ot_typo3/composer.json ./composer.json
     php7.4 composer.phar install
+
+
+## Mise en oeuvre
+
+Je me connecte en SSH à prod-front
+
+    ssh exploitation@prod-front
+
+
+
+### Mise en maintenance
+
+Je met à jour le message de maintenance :
+
+    cd /var/www/typo3
+    nano public/maintenance.html
+
+J'active le mode maintenance :
+    
+    nano public/.htaccess
+
+
+Je décommente les lignes :
+
+    #RewriteCond %{REMOTE_ADDR} !^10\.8\.0\.
+    #RewriteCond %{REQUEST_URI} !/maintenance.html$ [NC]
+    #RewriteRule .* /maintenance.html [R=302,L]
+
+Je vérifie depuis un appareil hors VPN que la maintenance est bien active.
+
+### Snapshot
+
+Tony réalise un snapshot de prod-front
+
+### Dump de la DB
+
+Je lance un dump de la DB :
+
+    cd ~
+    ./dump_typo3.sh
+
+### Upgrade
+
+    cd /var/opentalent/git/ot_typo3
+    git fetch origin release/0.7
+    git checkout release/0.7
+
+    cd /var/www/typo3
+
+
+Je renomme le fichier composer.json et je créé un symlink vers le nouveau composer.json versionné dans le repo ot_typo3 :
+
+    mv composer.json composer.json.orig
+    ln -s /var/opentalent/git/ot_typo3/composer.json ./composer.json
+    rm composer.lock
+    rm -r vendor/*
+    php7.4 composer.phar install
+
+
+Je met à jour le fichier `cli` avec le bon chemin d'accès :
+
+     nano cli
+
+On remplace `/var/www/typo3/vendor/bin/typo3cms` par `/var/www/typo3/vendor/bin/typo3`
+
+On va devoir remplacer le fichier .htaccess, sans désactiver le mode maintenance :
+
+    cp public/typo3/sysext/install/Resources/Private/FolderStructureTemplateFiles/root-htaccess public/.htaccess.new
+    nano public/.htaccess.new
+
+Ajouter les lignes suivantes :
+
+    # <--- Opentalent rules
+
+    #SetEnvIf Remote_Addr ^10\.8\.0\.[0-255] TYPO3_CONTEXT=Development
+    
+    # Enable / Disable the opentalent ot_optimizer middlewares
+    SetEnv TYPO3_OPTIMIZE 1
+    
+    RewriteCond %{REMOTE_ADDR} !^10\.8\.0\.
+    RewriteCond %{REQUEST_URI} !/maintenance.html$ [NC]
+    RewriteRule .* /maintenance.html [R=302,L]
+
+    # Opentalent rules --->
+
+Puis remplacer le .htaccess existant :
+
+    mv public/.htaccess public/.htaccess.old
+    mv public/.htaccess.new public/.htaccess
+
+Vérifier que le mode maintenance est toujours activé à l'extérieur
+
+J'active le mode install de typo3 :
+
+      touch public/typo3conf/ENABLE_INSTALL_TOOL
+
+Je me rends à l'adresse `https://ohcluses.opentalent.fr/typo3/install.php`
+
+Je lance la maj de la structure de la DB
+
+Je lance l'upgrade wizard, et j'exécute toutes les tâches
+
+Je reset les préférences du backend user
+
+Je maj les packs de langues
+
+Je flush le cache
+
+
+J'ouvre en édition le fichier suivant :
+
+    sudo nano /etc/php/7.4/cli/conf.d/20-apcu.ini
+
+Et j'ajoute la ligne :
+
+    apc.enable_cli=on
+
+Puis je lance les dernières commandes :
+
+    sh cli cache:flush
+    sh cli referenceindex:update
+
+
+
+
+Je vérifie l'installation
+
+
+### Désactivation du mode maintenance 
+
+J'édite le fichier .htaccess
+
+    cd /var/www/typo3
+    nano public/.htaccess
+
+
+Je commente les lignes :
+
+    RewriteCond %{REMOTE_ADDR} !^10\.8\.0\.
+    RewriteCond %{REQUEST_URI} !/maintenance.html$ [NC]
+    RewriteRule .* /maintenance.html [R=302,L]
+
+### Nettoyage après upgrade
+
+Si tout fonctionne bien, je retire les fichiers devenus inutiles :
+
+    rm composer.json.orig
+    rm public/.htaccess.old
+
+
+Supprimer les champs et tables en zzz_ depuis le BE typo3
+
+
+### Release
+
+Finaliser la release dans GitKraken
+
+Switcher sur master sur prod-front :
+
+    cd /var/opentalent/git/ot_typo3
+    git checkout master
+    git pull
+