Cómo actualizar Apache Tomcat en miniOrange On-Premise IAM

En Linux, miniOrange normalmente ejecuta Tomcat bajo systemd . La configuración del servicio se encuentra en el archivo de unidad y, a menudo, en bin/setenv.sh.

Paso 1: Descubra la configuración del servicio.

Confirme la ruta de instalación, el destino del enlace simbólico, el servidor Tomcat en ejecución y la configuración del servicio:

• Consulte las más reciente Enlace simbólico y su destino:

  ls -la /opt/tomcat/

• Resolver la carpeta versionada real:

  readlink -f /opt/tomcat/latest

• Ejecutando JVM: CATALINA_HOME, classpath, opts:

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

• Unidad Tomcat (ExecStart a través de catalina.sh):

  systemctl cat mo-idp-miniorange.service

• Entorno compartido: MO_IDP_FOLDER, rutas de configuración/registro:

  cat /etc/mo-idp-server.env

Confirme que la unidad Tomcat utiliza ${MO_IDP_FOLDER} (apuntando al enlace simbólico) y que otros servicios ejecutan sus JAR desde ${MO_IDP_FOLDER}/services/*.jar; por eso, al volver a apuntar el enlace simbólico se actualiza toda la pila a la vez.

Paso 2: Realice una copia de seguridad de la instalación actual.

• Cree un archivo de copia de seguridad de la instalación actual:

  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>

• Confirme que se creó el archivo de copia de seguridad:

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

• Verifique que el archivo sea válido:

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

Paso 3: Descargue y extraiga el nuevo Tomcat.

• Vaya al directorio de Tomcat:

  cd /opt/tomcat

• Descarga el nuevo paquete de Tomcat:

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

• Extraer el paquete:

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

• Confirme que la nueva carpeta existe:

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

Paso 4: Migrar los datos a la nueva carpeta (cp -a)

Utilice cp -a (copiar, no mover) para que la carpeta antigua permanezca intacta y permita una reversión instantánea.

• Configuration (conserva tu servidor.xml Contexto):

  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

• Directorios de aplicación, licencia y tiempo de ejecución:

  # 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

• malla de microservicios (todos los archivos JAR, configuración y certificados, excluyendo los registros de servicio voluminosos):

  # 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

Paso 5: Corrija la propiedad y verifique.

• Corrija la propiedad y luego verifique la cantidad de JAR, config/certs, catalina.sh y el espacio en disco:

  # 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

• Confirme: el número de archivos JAR coincide con el número de servicios, la configuración y los certificados están presentes, moas existe, catalina.sh es ejecutable y el disco no está casi lleno.

Paso 6: Detener la pila

• Detenga todos los servicios de miniOrange (detectados por patrón) y luego los servicios de infraestructura:

  # 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

Paso 7: Cambiar el enlace simbólico

• Apunta el más reciente Cree un enlace simbólico en la nueva carpeta de Tomcat y, a continuación, confirme el destino:

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

Paso 8: Iniciar la pila (primero la infraestructura y las dependencias)

• Primero, configure la infraestructura, luego el registro y los servicios de configuración, y después todo lo demás. Inicializar Eureka y Config primero evita fallos de registro transitorios.

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

Paso 9: verificar

• Compruebe el estado del servicio, la versión de Tomcat, los registros del contenedor y el punto final de inicio de sesión:

  # 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

• Confirma que el banner dice Apache Tomcat / 9.0.120 (o su versión de destino).
• Confirmar cada mo-idp El servicio, junto con nginx, RabbitMQ y Redis, está en funcionamiento.
• Confirme que los puntos finales de inicio de sesión/SSO responden y se visualizan correctamente.

Paso 10: Reversión (instantánea)

• Porque la carpeta de versiones antiguas nunca se modificó (cp -a), la reversión es un cambio de un solo enlace simbólico más un reinicio:

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

Paso 11: Limpieza (después de unos días de estabilidad)

• Elimine la carpeta antigua y el archivo tar descargado. Conserve el archivo de copia de seguridad durante un tiempo más:

  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