Comment mettre à niveau Apache Tomcat dans miniOrange On-Premise IAM

Sous Linux, miniOrange exécute généralement Tomcat via systemd . La configuration du service se trouve dans le fichier d'unité et, souvent, dans bin/setenv.sh.

Étape 1 : Découvrir la configuration du service

Veuillez vérifier le chemin d'installation, la cible du lien symbolique, le serveur Tomcat en cours d'exécution et la configuration du service :

• Voir le derniers lien symbolique et sa cible :

  ls -la /opt/tomcat/

• Résolvez le problème du dossier versionné réel :

  readlink -f /opt/tomcat/latest

• Exécution de la JVM : CATALINA_HOME, classpath, options :

  ps -ef | grep -i catalina | grep -v grep

• Unité Tomcat (ExecStart via catalina.sh) :

  systemctl cat mo-idp-miniorange.service

• Environnement partagé : MO_IDP_FOLDER, chemins de configuration/journalisation :

  cat /etc/mo-idp-server.env

Vérifiez que l'unité Tomcat utilise ${MO_IDP_FOLDER} (pointant vers le lien symbolique) et que les autres services lancent leurs JAR à partir de ${MO_IDP_FOLDER}/services/*.jar - c'est pourquoi le fait de rediriger le lien symbolique met à niveau toute la pile en une seule fois.

Étape 2 : Sauvegardez l’installation actuelle

• Créez une archive de sauvegarde de l'installation actuelle :

  sudo tar -czf /opt/mo-idp-backup-<ver>-$(date +%Y%m%d).tar.gz \
  -C /opt/tomcat --exclude='mo-idp-server-<ver>/services/logs' mo-idp-server-<ver>

• Confirmez que le fichier de sauvegarde a été créé :

  ls -lh /opt/mo-idp-backup-<ver>-*.tar.gz

• Vérifiez la validité de l'archive :

  sudo tar -tzf /opt/mo-idp-backup-<ver>-*.tar.gz > /dev/null && echo 'Archive OK'

Étape 3 : Téléchargez et extrayez le nouveau Tomcat

• Accédez au répertoire Tomcat :

  cd /opt/tomcat

• Téléchargez le nouveau package Tomcat :

  sudo wget https://archive.apache.org/dist/tomcat/tomcat-9/v<NewTomcatVer>/bin/apache-tomcat-<NewTomcatVer>.tar.gz

• Extraire le paquet :

  sudo tar -xzf apache-tomcat-<NewTomcatVer>.tar.gz

• Vérifiez que le nouveau dossier existe :

  ls -la /opt/tomcat/apache-tomcat-<NewTomcatVer>/

Étape 4 : Migrer les données dans le nouveau dossier (cp -a)

Utilisez cp -a (copier, et non déplacer) afin que l'ancien dossier reste intact pour une restauration instantanée.

• Configuration (préserve votre serveur.xml Contexte):

  sudo cp -a /opt/tomcat/latest/conf/. /opt/tomcat/apache-tomcat-<NewTomcatVer>/conf/

  sudo grep -i moas /opt/tomcat/apache-tomcat-<NewTomcatVer>/conf/server.xml   # confirm Context copied

• Répertoires de l'application, de la licence et de l'environnement d'exécution :

  # 1) sudo cp -a /opt/tomcat/latest/moas        /opt/tomcat/apache-tomcat-<NewTomcatVer>/moas
  
  # 2) sudo cp -a /opt/tomcat/latest/license.txt /opt/tomcat/apache-tomcat-<NewTomcatVer>/license.txt
  
  # 3) optional: carry historical logs / temp / work (or let them regenerate)
  sudo rm -rf /opt/tomcat/apache-tomcat-<NewTomcatVer>/logs /opt/tomcat/apache-tomcat-<NewTomcatVer>/temp /opt/tomcat/apache-tomcat-<NewTomcatVer>/work
  
  # 4) sudo cp -a /opt/tomcat/latest/logs /opt/tomcat/apache-tomcat-<NewTomcatVer>/logs
  
  # 5) sudo cp -a /opt/tomcat/latest/temp /opt/tomcat/apache-tomcat-<NewTomcatVer>/temp
  
  # 6) sudo cp -a /opt/tomcat/latest/work /opt/tomcat/apache-tomcat-<NewTomcatVer>/work

• maillage de microservices (tous les fichiers JAR, la configuration, les certificats — à l'exclusion des journaux de service volumineux) :

  # 1) sudo mkdir -p /opt/tomcat/apache-tomcat-<NewTomcatVer>/services
  
  # 2) sudo rsync -a --exclude 'logs' \
  /opt/tomcat/latest/services/ /opt/tomcat/apache-tomcat-<NewTomcatVer>/services/
  
  # 3) sudo mkdir -p /opt/tomcat/apache-tomcat-<NewTomcatVer>/services/logs

Étape 5 : Corriger la propriété et vérifier

• Corrigez les droits d'accès, puis vérifiez le nombre de fichiers JAR, config/certs, catalina.sh et l'espace disque :

  # 1) sudo chown -R root:root /opt/tomcat/apache-tomcat-<NewTomcatVer>
  
  # 2) verify — JAR count auto-counts, so it matches whatever the mesh contains
  sudo find /opt/tomcat/apache-tomcat-<NewTomcatVer>/services/ -maxdepth 1 -name '*.jar' | wc -l
  
  # 3) sudo ls /opt/tomcat/apache-tomcat-<NewTomcatVer>/services/ | grep -E 'config|certs'
  
  # 4) sudo ls /opt/tomcat/apache-tomcat-<NewTomcatVer>/                # bin conf lib logs moas services temp webapps work
  
  # 5) sudo ls -la /opt/tomcat/apache-tomcat-<NewTomcatVer>/bin/catalina.sh   # must exist and be executable
  
  # 6) df -h /opt

• Vérifiez : le nombre de fichiers JAR correspond au nombre de services, les fichiers de configuration et les certificats sont présents, moas existe, catalina.sh est exécutable et le disque n’est pas presque plein.

Étape 6 : Arrêter la pile

• Arrêtez tous les services miniOrange (détectés par modèle), puis les services d'infrastructure :

  # 1)MO_SERVICES=$(systemctl list-units 'mo-idp-*.service' --all --no-legend | awk '{print $1}')
  
  # 2) sudo systemctl stop $MO_SERVICES
  
  # 3) sudo systemctl stop nginx.service rabbitmq-server.service redis-server.service
  
  # 4) systemctl list-units --type=service | grep -iE 'orange|redis|rabbit|nginx'   # confirm all stopped

Étape 7 : Modifier le lien symbolique

• Pointez le derniers Créez un lien symbolique vers le nouveau dossier Tomcat, puis confirmez la cible :

  sudo ln -sfn /opt/tomcat/apache-tomcat-<NewTomcatVer> /opt/tomcat/latest
  
  readlink -f /opt/tomcat/latest        # must show the new versioned folder

Étape 8 : Démarrer la pile (infrastructure et dépendances en premier)

• Commencez par mettre en place l'infrastructure, puis les services de registre et de configuration, et enfin le reste. Initialiser Eureka et la configuration en premier permet d'éviter les échecs d'enregistrement temporaires.

  # 1) infrastructure
  sudo systemctl start redis-server.service rabbitmq-server.service nginx.service
  sudo ss -tlnp | grep -E ':6379|:5672|:80'     # confirm listening
  
  # 2) registry + config first
  sudo systemctl start mo-idp-eurekaserver.service mo-idp-configserver.service
  sleep 25
  
  # 3) all remaining mo-idp services, discovered by pattern
  sudo systemctl start $(systemctl list-unit-files 'mo-idp-*.service' --no-legend | awk '{print $1}')

Étape 9: vérifier

• Vérifiez l'état du service, la version de Tomcat, les journaux du conteneur et le point de terminaison de connexion :

  # 1) systemctl list-units --type=service | grep -iE 'orange|redis|rabbit|nginx'
  
  # 2) sudo /opt/tomcat/latest/bin/version.sh | grep 'Server version'
  
  # 3) sudo tail -30 /opt/tomcat/latest/logs/catalina.$(date +%Y-%m-%d).log
  
  # 4) curl -I -k https://<miniorange_URL> 2>&1 | head -5

• Vérifiez que la bannière indique Apache Tomcat/9.0.120 (ou votre version cible).
• Confirmer chaque mo-idp Le service, comprenant nginx, RabbitMQ et Redis, est pleinement opérationnel.
• Vérifiez que les points de terminaison de connexion/SSO répondent et s'affichent correctement.

Étape 10 : Restauration (instantanée)

• Parce que l'ancien dossier versionné n'a jamais été modifié (cp -a), la restauration consiste en une simple inversion de lien symbolique suivie d'un redémarrage :

  # 1) sudo systemctl stop $(systemctl list-units 'mo-idp-*.service' --all --no-legend | awk '{print $1}')
  
  # 2) sudo ln -sfn /opt/tomcat/mo-idp-server-<ver> /opt/tomcat/latest
  
  # 3) sudo systemctl start mo-idp-eurekaserver.service mo-idp-configserver.service && sleep 25 && \
  
  # 4) sudo systemctl start $(systemctl list-unit-files 'mo-idp-*.service' --no-legend | awk '{print $1}')

Étape 11 : Nettoyage (après quelques jours de stabilité)

• Supprimez l'ancien dossier et l'archive tar téléchargée. Conservez l'archive de sauvegarde encore quelque temps :

  sudo rm -rf /opt/tomcat/mo-idp-server-<ver>            # old folder
  
  sudo rm -f  /opt/tomcat/apache-tomcat-<NewTomcatVer>.tar.gz  # downloaded tarball
  # keep /opt/mo-idp-backup-<ver>-*.tar.gz a while longer