Mise à jour mineure

En cas de mise à jour mineure:

• faire une sauvegarde de votre répertoire applicatif
• se positionner dans le répertoire applicatif

git stash (à faire dans le cas où il y a eu des modifications dans le code de l application, ceci vous fera perdre ces modifications)
git fetch
git checkout tags/$(git tag --sort=committerdate | grep -E '19\.04\.([0-9]+)$' | tail -1) -b $(git tag --sort=committerdate | grep -E '19\.04\.([0-9]+)$' | tail -1)

• créer le lien symbolique vers le référentiel ban

ln -s [docservers]/referential/ban/indexes [repertoire MaarchCourrier]/referential/ban/indexes

Mise à jour majeure

La procédure ci-dessous décrit les étapes de migration de la version n-1 à cette version.
Attention si vous êtes en plus ancienne à la n-1 , il faut bien passer tous les scripts de migration (exemple : 1804.sql, 1810.sql et les migrates.sh). Voir la documentation des migrations antérieures
Attention de respecter scrupuleusement les prérequis de la version pour l'environnement cible de migration.

En cas de changement de serveur

• Procéder à une installation from scratch avec l'assistant
• Migrer la base de données (pg_dump) d'origine en écrasant la base de l'installeur
• Déplacer les fichiers xml du custom d'origine, sauf le apps/maarch_entreprise/xml/config.xml créé par l'installeur
• Remonter les docservers
• Remonter Maarch Capture et ses tâches planifiées par copie de répertoire
• Copier les autres tâches planifiées

Actions à effectuer

• Mettre à jour Maarch Courrier :

  • git fetch
  • git checkout tags/$(git describe --tags git rev-list --tags=19.04.* --max-count=1) -b $(git describe --tags git rev-list --tags=19.04.* --max-count=1)

• Les courriels sont maintenant envoyés à la volée, il faut donc supprimer tous les appels aux batchs sendmail ainsi que la purge des logs sendmail dans la crontab.

• Passer le script qui se trouve ici : sql/1904.sql (Si vous êtes déjà sur une branche > 19.04, le script se trouve ici migration/19.04/1904.sql)

• Créer le dossier docserver acknowledgment_receipts puis modifier le chemin dans la table docservers

Script de Migration

	Attention: Dans le cas où vous êtes en multiinstance, il faut bien passer le script 1904.sql sur toutes les bases avant de passer les scripts ci-dessous

Lancer le script migrate.sh qui se trouve dans migration/19.04

Ce script lance migrateSendmail.php qui va enregistrer la configuration Email du fichier xml dans la nouvelle table (configurations) ainsi que de rapatrier tous les précédents envois d'emails dans la nouvelle table (emails).

cd migration/19.04
chmod +x migrate.sh
./migrate.sh

Vhost

Afin de ne pas sauvegarder certains mots de passe de configuration en clair dans la base de données, ceux-ci sont chiffrés en amont.
Pour cela, une clé de chiffrement est nécessaire.
Rajouter cette ligne dans le vhost du serveur, et MODIFIER la valeur de la clé :

SetEnv MAARCH_ENCRYPT_KEY "Security Key Maarch Courrier 2008"

Cette clé ne doit pas être transmise à l'extérieur car elle permet de déchiffrer les mots de passe sauvegardés en base de données (serveur de messagerie).

Imagick

L'extension IMagick est maintenant obligatoire, et non plus optionnelle

apt-get install php-imagick

BREAKING CHANGES

• Le dossier smartphone a été supprimé. L'application standard est de plus en plus compatible smartphone/tablette. (passage en V2 progressif)

• La colonne external_contact_id de la table contact_addresses a été transformé en external_id de type json. Toutes les valeurs présentes dans la colonne seront affiliés à un identifiant Maarch 2 GEC ({'m2m' : "123456789"}).

• La colonne external_id de la table res_letterbox a été transformé en type json et sera dédié aux identifiants externes d'autres applications. Toutes les valeurs présentes dans la colonne seront enregistrés dans la colonne external_reference. Les attributs possibles du json sont : publikId, localeoId.

• La liste des résultats (des bannettes) qui pouvait être modifiée est maintenant unique et limitée.

Suppression de colonnes dans la base de données

Les colonnes listées ci-après ont été supprimées de la base de données.