So aktualisieren Sie Apache Tomcat in miniOrange On-Premise IAM

Unter Linux läuft miniOrange typischerweise mit Tomcat unter systemd . Die Dienstkonfiguration befindet sich in der Unit-Datei und oft auch in bin/setenv.sh.

Schritt 1: Ermitteln Sie die Dienstkonfiguration

Bestätigen Sie den Installationspfad, das Ziel des symbolischen Links, den laufenden Tomcat-Server und die Dienstkonfiguration:

• Weitere Informationen im neuesten Symlink und sein Ziel:

  ls -la /opt/tomcat/

• Den Ordner mit der tatsächlichen Version auflösen:

  readlink -f /opt/tomcat/latest

• JVM wird ausgeführt: CATALINA_HOME, Klassenpfad, Optionen:

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

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

  systemctl cat mo-idp-miniorange.service

• Gemeinsame Umgebung: MO_IDP_FOLDER, Konfigurations-/Protokollpfade:

  cat /etc/mo-idp-server.env

Stellen Sie sicher, dass die Tomcat-Unit ${MO_IDP_FOLDER} (mit Verweis auf den Symlink) verwendet und dass andere Dienste ihre JAR-Dateien von ${MO_IDP_FOLDER}/services/*.jar starten – deshalb wird durch das Umverweisen des Symlinks der gesamte Stack gleichzeitig aktualisiert.

Schritt 2: Sichern Sie die aktuelle Installation

• Erstellen Sie ein Sicherungsarchiv der aktuellen Installation:

  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>

• Bestätigen Sie, dass die Sicherungsdatei erstellt wurde:

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

• Überprüfen Sie, ob das Archiv gültig ist:

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

Schritt 3: Laden Sie den neuen Tomcat herunter und extrahieren Sie ihn.

• Wechseln Sie in das Tomcat-Verzeichnis:

  cd /opt/tomcat

• Laden Sie das neue Tomcat-Paket herunter:

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

• Paket extrahieren:

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

• Prüfen Sie, ob der neue Ordner existiert:

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

Schritt 4: Daten in den neuen Ordner migrieren (cp -a)

Verwenden Sie cp -a (Kopieren, nicht Verschieben), damit der alte Ordner für ein sofortiges Rollback erhalten bleibt.

• Konfiguration (bewahrt Ihre server.xml Kontext):

  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

• Anwendungs-, Lizenz- und Laufzeitverzeichnisse:

  # 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

• Microservice-Mesh (alle JAR-Dateien, Konfigurationen, Zertifikate – ausgenommen umfangreiche Service-Logs):

  # 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

Schritt 5: Eigentumsverhältnisse klären und überprüfen

• Korrigieren Sie die Besitzverhältnisse und überprüfen Sie anschließend die Anzahl der JAR-Dateien, config/certs, catalina.sh und den verfügbaren Speicherplatz:

  # 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

• Bestätigen Sie: Die Anzahl der JAR-Dateien stimmt mit der Anzahl Ihrer Dienste überein, Konfiguration/Zertifikate sind vorhanden, moas existiert, catalina.sh ist ausführbar und die Festplatte ist nicht annähernd voll.

Schritt 6: Stapel anhalten

• Stoppen Sie zunächst alle miniOrange-Dienste (die anhand des Musters erkannt wurden), dann die Infrastrukturdienste:

  # 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

Schritt 7: Ändern Sie den symbolischen Link.

• Zeigen Sie auf die neuesten Erstellen Sie einen symbolischen Link im neuen Tomcat-Ordner und bestätigen Sie anschließend das Ziel:

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

Schritt 8: Den Stack starten (zuerst Infrastruktur und Abhängigkeiten)

• Zuerst die Infrastruktur bereitstellen, dann die Registry- und Konfigurationsdienste und anschließend alles andere. Durch das vorherige Initialisieren von Eureka und Config lassen sich vorübergehende Registrierungsfehler vermeiden.

  # 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}')

Schritt 9: Überprüfen

• Überprüfen Sie den Dienststatus, die Tomcat-Version, die Containerprotokolle und den Anmelde-Endpunkt:

  # 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

• Bestätigen Sie, dass auf dem Banner Folgendes steht: Apache Tomcat/9.0.120 (oder Ihre Zielversion).
• Bestätigen Sie alle mo-idp Der Dienst plus nginx, RabbitMQ und Redis läuft aktiv.
• Prüfen Sie, ob die Login-/SSO-Endpunkte korrekt antworten und angezeigt werden.

Schritt 10: Rollback (sofort)

• Weil der alte Versionsordner nie geändert wurde (cp -a), ist ein Rollback das Umklappen eines einzelnen symbolischen Links plus ein Neustart:

  # 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}')

Schritt 11: Aufräumen (nach einigen Tagen der Stabilität)

• Entfernen Sie den alten Ordner und das heruntergeladene Tarball-Archiv. Bewahren Sie das Sicherungsarchiv noch eine Weile auf:

  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