Come aggiornare Apache Tomcat in miniOrange On-Premise IAM

Su Linux, miniOrange in genere esegue Tomcat tramite systemd . La configurazione del servizio si trova nel file di unità e, spesso, in bin/setenv.sh.

Passaggio 1: Scopri la configurazione del servizio

Conferma il percorso di installazione, la destinazione del collegamento simbolico, l'istanza di Tomcat in esecuzione e la configurazione del servizio:

• Vedere la con i più recenti Collegamento simbolico e suo target:

  ls -la /opt/tomcat/

• Risolvi il problema con la cartella versionata reale:

  readlink -f /opt/tomcat/latest

• Esecuzione della JVM: CATALINA_HOME, classpath, opts:

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

• Unità Tomcat (avvio tramite ExecStart via catalina.sh):

  systemctl cat mo-idp-miniorange.service

• Ambiente condiviso: MO_IDP_FOLDER, percorsi di configurazione/log:

  cat /etc/mo-idp-server.env

Verifica che l'unità Tomcat utilizzi ${MO_IDP_FOLDER} (che punta al collegamento simbolico) e che gli altri servizi avviino i loro JAR da ${MO_IDP_FOLDER}/services/*.jar: questo è il motivo per cui la modifica del collegamento simbolico aggiorna l'intero stack in una sola volta.

Passaggio 2: Eseguire il backup dell'installazione corrente

• Crea un archivio di backup dell'installazione corrente:

  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>

• Conferma che il file di backup è stato creato:

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

• Verifica la validità dell'archivio:

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

Passaggio 3: Scarica ed estrai il nuovo Tomcat

• Vai alla directory di Tomcat:

  cd /opt/tomcat

• Scarica il nuovo pacchetto Tomcat:

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

• Estrai il pacchetto:

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

• Conferma che la nuova cartella esiste:

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

Passaggio 4: Migrare i dati nella nuova cartella (cp -a)

Utilizza il comando cp -a (copia, non sposta) in modo che la vecchia cartella rimanga intatta e tu possa ripristinare la versione precedente in tempo reale.

• Configurazione (conserva il tuo server.xml Contesto):

  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

• Applicazione, licenza, directory di runtime:

  # 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

• Rete di microservizi (tutti i file JAR, la configurazione e i certificati, esclusi i log di servizio di grandi dimensioni):

  # 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

Passaggio 5: Correggi la proprietà e verifica

• Correggi i permessi di accesso, quindi verifica il numero di file JAR, la configurazione/i certificati, lo script catalina.sh e lo spazio su disco disponibile:

  # 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

• Conferma: il numero di file JAR corrisponde al numero di servizi, i file di configurazione e i certificati sono presenti, moas esiste, catalina.sh è eseguibile e il disco non è quasi pieno.

Passaggio 6: Interrompere lo stack

• Interrompere tutti i servizi miniOrange (individuati tramite pattern), quindi i servizi di infrastruttura:

  # 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

Passaggio 7: Modificare il collegamento simbolico

• Punta il con i più recenti Crea un collegamento simbolico nella nuova cartella di Tomcat, quindi conferma la destinazione:

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

Passaggio 8: Avviare lo stack (prima l'infrastruttura e le dipendenze)

• Avvia prima l'infrastruttura, poi il registro e i servizi di configurazione, infine tutto il resto. Avviare prima Eureka e Config evita errori di registrazione temporanei:

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

Passaggio 9: verifica

• Verifica lo stato del servizio, la versione di Tomcat, i log del container e l'endpoint di accesso:

  # 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

• Conferma che il banner recita Apache Tomcat/9.0.120 (o la versione di destinazione).
• Conferma ogni mo-idp Il servizio, che include nginx, RabbitMQ e Redis, è attivamente in esecuzione.
• Verificare che gli endpoint di login/SSO rispondano e vengano visualizzati correttamente.

Passaggio 10: Annullamento (istantaneo)

• Poiché la cartella della vecchia versione non è mai stata modificata (cp -a), il rollback consiste in un singolo cambio di collegamento simbolico più un riavvio:

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

Fase 11: Pulizia (dopo alcuni giorni di stabilità)

• Elimina la vecchia cartella e il file tarball scaricato. Conserva l'archivio di backup ancora per un po':

  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