Aller au contenu principal
Version: Any 26

Mise à jour d'une version existante

Préparation avant la montée en version​

Désactiver le planificateur de tâches​

Avant toute mise à jour, vous devez arrêter le planificateur de tâches pour éviter l'exécution de tâches pendant la migration.

Étapes :

  1. Arrêtez votre serveur d'applications Web (Tomcat)
  2. Modifiez le fichier settings.json
  3. Recherchez la section elastic-search-data → job → scheduler_settings
  4. Passez disabled à true :
{
"elastic-search-data": {
"job": {
"scheduler_settings": {
"disabled": true
}
}
}
}
  1. Redémarrez le serveur Web

Après la migration, remettez disabled à false et redémarrez.


Changements de configuration selon les versions​

Gestion du settings.json (version 17+)​

Depuis Any 17, le fichier settings.json ne doit contenir que les modifications et non toutes les valeurs par défaut.

Avant (versions < 17) :

  • Fichier settings.json complet avec toutes les valeurs

Après (versions ≥ 17) :

  • Fichier settings.json allégé (seulement vos modifications)
  • Les valeurs par défaut sont lues depuis settings-full.json

Action : Consultez settings-full.json pour voir les valeurs par défaut. Gardez uniquement vos customisations dans settings.json.

Configuration du cache Hazelcast (version 17+)​

Depuis Any 17, le cache Hazelcast est configuré via un fichier dédié au lieu de settings.json.

Avant (versions < 17) :

{
"cache": { ... } // Dans settings.json
}

Après (versions ≥ 17) :

<!-- Dans hazelcast.xml -->
<hazelcast>
<!-- Configuration du cache -->
</hazelcast>

Action : Si vous aviez des modifications dans la section cache de settings.json, reportez-les dans hazelcast.xml.

Pour plus de détails : Documentation Hazelcast

Reconfiguration shiro.ini pour le SSO​

Si vous utilisez une authentification SSO (Single Sign-On), vous devez reconfigurer le fichier shiro.ini après la mise à jour.

Consultez la section Connexion et authentification pour les détails de configuration.


Mise à jour de l'application Web​

Déploiement du nouveau WAR​

  1. Arrêtez Tomcat
  2. Supprimez l'ancien dossier any dans $TOMCAT_HOME/webapps/
  3. Supprimez l'ancien fichier any.war
  4. Copiez le nouveau fichier any.war dans $TOMCAT_HOME/webapps/
  5. Redémarrez Tomcat

L'application Web se redéploiera automatiquement.


Mise à jour du Messaging Server​

Déploiement du nouveau WAR​

  1. Arrêtez Tomcat
  2. Supprimez l'ancien dossier MessagingServer dans $TOMCAT_HOME/webapps/
  3. Supprimez l'ancien fichier MessagingServer.war
  4. Copiez le nouveau fichier MessagingServer.war dans $TOMCAT_HOME/webapps/
  5. Redémarrez Tomcat

Important : Désactivez le planificateur de tâches avant cette étape (voir Préparation avant la montée en version).


Mise à jour des objets de configuration​

Une fois tous les WAR redéployés et la nouvelle version lancée :

  1. Désactivez le planificateur (voir étape Préparation)
  2. Ouvrez votre navigateur et allez à <url de any>/rest/default/install/upgrade
  3. Connectez-vous avec vos identifiants administrateur
  4. Cliquez sur Mettre à jour la configuration

Les objets de configuration seront automatiquement migrés à la nouvelle version.

Après la migration, réactivez le planificateur en passant disabled à false dans settings.json.