{ "componentChunkName": "component---src-templates-article-js", "path": "/migration-notes/migration-2026.1.0", "result": {"data":{"asciidoc":{"html":"

Migration de 2025.3.0 vers 2026.1.0

\n
\n
\n
\n\n\n\n\n\n
\n
Warning
\n		\nPour installer cette version, vous devez déjà avoir installé la 2025.3.0 au préalable.\nLes migrations depuis des versions 2025.2.0 ou inférieures ne sont pas supportées.\n
\n
\n
\n\n\n\n\n\n
\n
Note
\n		\nUne base de données MySQL 8.0 (ou dans certains cas Oracle 19c) est obligatoire pour le fonctionnement de l’application depuis la version 2024.1.0.\n
\n
\n
\n

Aucune manipulation particulière n’est requise pour le changement de version.\nLe remplacement des war automatise la mise à jour de la base de données.

\n
\n
\n
    \n
  • \n

    À faire systématiquement avant une mise en production : Un test sur une copie de base de données de production pour valider le déploiement.

    \n
    • \n
\n
\n
\n
\n
\n

Recommandations préalables

\n
\n
\n

Nous insistons sur les points suivants :

\n
\n
\n
    \n
  • \n

    Lisez le guide d’administration

    \n
    • \n
  • \n

    Faites une sauvegarde de votre base de données et de vos fichiers (répertoire application_data) avant toute installation

    \n
    • \n
  • \n

    Ne faites pas vos modifications en production directement, validez la mise à jour sur un environnement dédié à partir des données de production avant de lancer une mise à jour réelle

    \n
    • \n
  • \n

    Cette version inclut plusieurs migrations de données nécessaires a la fiabilisation et la sécurisation de l’utilisation

    \n
    • \n
  • \n

    Si possible, testez sur un environnement d’homologation ISO à la production (avec une sauvegarde de la production et du répertoire des données application_data)

    \n
    • \n
\n
\n
\n
\n
\n

Changements techniques

\n
\n
\n
    \n
  • \n

    Spring Boot passe de la version 2.1.x (fin de vie) à 2.7.x (supportée) depuis la version 2024.3.0

    \n
    • \n
  • \n

    Les bibliothèques embarquées sont mises à jour notamment pour des raisons de sécurité depuis la version 2024.3.0

    \n
    • \n
  • \n

    Suppression de l’accès aux APIs via http://votre-serveur/edixit/api toutes les APIs doivent être accédées via http://votre-serveur/api depuis la version 2024.3.0

    \n
    • \n
\n
\n
\n
\n
\n

Changements fonctionnels

\n
\n
\n
    \n
  • \n

    Mise à jour des paramètres réglementaires conformément à la Loi de Finances et à la Loi de Financement de la Sécurité Sociale 2026

    \n
    • \n
  • \n

    Ajustements des calculs et simulateurs en fonction des nouveaux barèmes fiscaux et sociaux

    \n
    • \n
\n
\n
\n\n\n\n\n\n
\n
Important
\n		\nÀ partir de la version 2026.2.0, des upgrades techniques majeurs sont à venir, notamment l’upgrade vers Java 17 et Wildfly 26. Une nouvelle version d’API V2 sera également introduite et coexistera avec l’API V1 existante.\n
\n
\n
\n
\n
\n

Recommandations préalables

\n
\n
\n
    \n
  • \n

    Lisez le guide d’administration

    \n
    • \n
  • \n

    Faites une sauvegarde de votre base de données et de vos fichiers avant toute installation

    \n
    • \n
  • \n

    Ne faites pas vos modifications en production directement, validez la mise à jour sur un environnement dédié à partir des données de production avant de lancer une mise à jour réelle

    \n
    • \n
  • \n

    Cette version inclut plusieurs migrations de données nécessaires a la fiabilisation et la sécurisation de l’utilisation

    \n
    • \n
\n
\n
\n
\n
\n

Mise à jour serveur

\n
\n
\n

Procédure de mise à jour

\n
\n
    \n
  • \n

    Faites un backup de votre base de données avant toute chose

    \n
    • \n
  • \n

    Faites un backup de votre installation Wildfly

    \n
    • \n
  • \n

    Faites un backup de votre répertoire application_data

    \n
    • \n
  • \n

    Copiez les wars présents dans le .zip dans votre répertoire $WILFLY_HOME/standalone/deployments

    \n
    • \n
  • \n

    Intégrez les fichiers spécifiques à votre version dans le répertoire application_data

    \n
    • \n
\n
\n
\n
\n

Procédure de rollback

\n
\n
    \n
  • \n

    Arrêtez Wildfly

    \n
    • \n
  • \n

    Restaurez votre backup de BDD

    \n
    • \n
  • \n

    Pas besoin de restaurer votre répertoire application_data

    \n
    • \n
  • \n

    Supprimez les .war actuels de $WILFLY_HOME/standalone/deployments

    \n
    • \n
  • \n

    Installez les .war precedents dans $WILFLY_HOME/standalone/deployments

    \n
    • \n
  • \n

    Redémarrez Wildfly

    \n
    • \n
  • \n

    Par sécurité, redémarrez Wildfly (pour éviter certaines fuites mémoire du moteur BIRT)

    \n
    • \n
\n
\n
\n
\n
\n
\n

Mise à jour Docker

\n
\n
\n
    \n
  • \n

    Arrêtez vos containers

    \n
    • \n
  • \n

    Faites un backup de votre base de données et vos répertoires mappés

    \n
    • \n
  • \n

    Changez la version dans vos descripteurs de déploiement

    \n
    • \n
  • \n

    Relancez vos containers

    \n
    • \n
\n
\n
\n
\n
\n

FAQ

\n
\n
\n

Problème de timeout au déploiement de l’application

\n
\n

Pour permettre à vos déploiements de se faire il est nécessaire d’augmenter les timeout du ou des serveurs Wildfly.\nLa propriété jboss.as.management.blocking.timeout est configurée automatiquement à 1200 secondes.\nSi toutefois ce temps était insuffisant vous pouvez l’augmenter dans le fichier $EDIXIT_HOME/wildfly/standalone/standalone.xml.

\n
\n
\n
\n
<system-properties>\n    ...\n    <property name=\"jboss.as.management.blocking.timeout\" value=\"1200\"/>\n    ...\n</system-properties>
\n
\n
\n
\n

Vous devez aussi augmenter le timeout du scanner de déploiement en standalone pour cela :\najoutez l’attribut deployment-timeout avec la valeur 1200 qui correspond à 1200 secondes (20 minutes)

\n
\n
\n
\n
<subsystem xmlns=\"urn:jboss:domain:deployment-scanner:2.0\">\n    <deployment-scanner path=\"deployments\"\n        relative-to=\"jboss.server.base.dir\"\n        deployment-timeout=\"1200\"\n        scan-interval=\"5000\"\n        runtime-failure-causes-rollback=\"${jboss.deployment.scanner.rollback.on.failure:false}\"/>\n</subsystem>
\n
\n
\n
\n
\n
","document":{"title":"Migration de 2025.3.0 vers 2026.1.0"}}},"pageContext":{"id":"88d27a84-66cd-578a-b0a5-d3e882940496"}}, "staticQueryHashes": ["1586626695"]}