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 :
- Arrêtez votre serveur d'applications Web (Tomcat)
- Modifiez le fichier
settings.json - Recherchez la section
elastic-search-data→job→scheduler_settings - Passez
disabledàtrue:
{
"elastic-search-data": {
"job": {
"scheduler_settings": {
"disabled": true
}
}
}
}
- 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.jsoncomplet avec toutes les valeurs
Après (versions ≥ 17) :
- Fichier
settings.jsonallé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
- Arrêtez Tomcat
- Supprimez l'ancien dossier
anydans$TOMCAT_HOME/webapps/ - Supprimez l'ancien fichier
any.war - Copiez le nouveau fichier
any.wardans$TOMCAT_HOME/webapps/ - Redémarrez Tomcat
L'application Web se redéploiera automatiquement.
Mise à jour du Messaging Server
Déploiement du nouveau WAR
- Arrêtez Tomcat
- Supprimez l'ancien dossier
MessagingServerdans$TOMCAT_HOME/webapps/ - Supprimez l'ancien fichier
MessagingServer.war - Copiez le nouveau fichier
MessagingServer.wardans$TOMCAT_HOME/webapps/ - 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 :
- Désactivez le planificateur (voir étape Préparation)
- Ouvrez votre navigateur et allez à
<url de any>/rest/default/install/upgrade - Connectez-vous avec vos identifiants administrateur
- 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.