miniOrangeオンプレミス環境でApache Tomcatをアップグレードする方法 IAM

Linuxでは、miniOrangeは通常、systemd上でTomcatを実行します。サービスの設定はユニットファイル、多くの場合bin/setenv.shに記述されています。

ステップ1：サービス構成を検出する

インストールパス、シンボリックリンクのターゲット、実行中のTomcat、およびサービス構成を確認してください。

• ジョブの設定方法については、 最新の シンボリックリンクとそのターゲット:

  ls -la /opt/tomcat/

• 実際のバージョン管理されたフォルダーを解決します。

  readlink -f /opt/tomcat/latest

• JVM の実行: CATALINA_HOME、クラスパス、オプション:

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

• Tomcatユニット（catalina.sh経由のExecStart）：

  systemctl cat mo-idp-miniorange.service

• 共有環境: MO_IDP_FOLDER、config/log パス:

  cat /etc/mo-idp-server.env

Tomcat ユニットが ${MO_IDP_FOLDER} (シンボリックリンクを指している) を使用していること、および他のサービスが ${MO_IDP_FOLDER}/services/*.jar から JAR を起動していることを確認してください。これが、シンボリックリンクを再設定するとスタック全体が一度にアップグレードされる理由です。

ステップ2：現在のインストールをバックアップする

• 現在のインストール環境のバックアップアーカイブを作成します。

  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>

• バックアップファイルが作成されたことを確認してください。

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

• アーカイブが有効であることを確認してください。

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

ステップ3：新しいTomcatをダウンロードして解凍します

• Tomcatディレクトリに移動してください。

  cd /opt/tomcat

• 新しいTomcatパッケージをダウンロードしてください：

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

• パッケージを抽出します。

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

• 新しいフォルダが存在することを確認してください。

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

ステップ4：データを新しいフォルダに移行する（cp -a）

cp -a （コピー、移動ではない）を使用すると、元のフォルダがそのまま残るため、すぐにロールバックできます。

• 　 （あなたの サーバー.xml コンテクスト）：

  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

• アプリケーション、ライセンス、ランタイムディレクトリ:

  # 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

• マイクロサービスメッシュ （すべてのJARファイル、設定ファイル、証明書 - 大容量のサービスログを除く）：

  # 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

ステップ5：所有権を修正し、検証する

• 所有権を修正した後、JARファイルの数、config/certsファイル、catalina.shファイル、およびディスク容量を確認してください。

  # 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

• 確認してください：JARファイルの数がサービス数と一致していること、config/certsファイルが存在すること、moasが存在すること、catalina.shが実行可能であること、ディスク容量がほぼ満杯ではないこと。

ステップ6：スタックを停止する

• パターンによって検出されたすべての miniOrange サービスを停止し、次にインフラストラクチャ サービスを停止します。

  # 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

ステップ7：シンボリックリンクを変更する

• ポイント 最新の 新しいTomcatフォルダにシンボリックリンクを作成し、ターゲットを確認します。

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

ステップ8：スタックを開始する（まずインフラストラクチャと依存関係から）

• まずインフラストラクチャを起動し、次にレジストリと構成サービスを起動し、最後にその他のすべてを起動します。EurekaとConfigを最初にシードすることで、一時的な登録エラーを回避できます。

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

ステップ9：確認

• サービスの状態、Tomcatのバージョン、コンテナのログ、およびログインエンドポイントを確認してください。

  # 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

• バナーの内容を確認してください Apache Tomcat/9.0.120 （または、お使いのターゲットバージョン）。
• すべて確認 mo-idp サービスに加え、nginx、RabbitMQ、およびRedisが稼働中です。
• ログイン／SSOエンドポイントが正しく応答し、正しく表示されることを確認してください。

ステップ10：ロールバック（即時）

• 古いバージョンのフォルダは変更されなかったため（cp -a）、ロールバックは単一のシンボリックリンクの反転と再起動です。

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

ステップ11：クリーンアップ（数日間安定した状態が続いた後）

• 古いフォルダとダウンロードしたtarballを削除してください。バックアップアーカイブはもう少しの間保持してください。

  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