メインコンテンツまでスキップ
Waters Japan

NuGenesis SDMS で使用される Apache Tomcat のバージョンをアップグレードする方法 - WKB111885

Article number: 111885To English version

目的または目標

NuGenesis SDMS Web サーバーで Apache Tomcat のバージョンをアップグレードする。

環境

  • NuGenesis 9 SDMS
    • 既定の Apache Tomcat v9.0.8
  • NuGenesis 8 SDMS
    • 既定の Apache Tomcat v6.0.29
  • NuGenesis 9 用に使用できる Apache Tomcat の新しいバージョン(最低限 Java 8 Update 172 x86 付き):
    • v9.0.x x8632 ビット版 Windows 配布
  • NuGenesis 8 用に使用できる Apache Tomcat の新しいバージョン(すべて Java 7 Update 2 x86 付き):
    • v6.0.x x86
    • v7.0.x x86
    • v8.0.x x86
    • v8.5.x x86

手順

  1. Apache Tomcat の最新の「32 ビット版 Windows zip」配布を https://tomcat.apache.org からダウンロードします。
  2. ファイルを独自のフォルダーに解凍します。例えば、Tomcat 6.0.53 の場合は、ドライブ:\Program Files (x86)\apache-tomcat-6.0.53 に解凍します。Tomcat 9.0.44 の場合は、ドライブ:\Program Filex (x86)\Waters\apache-tomcat-9.0.44 に解凍します。新しいバージョンの Tomcat の下のディレクトリー構造は、NuGenesis SDMS で展開された Tomcat フォルダーの構造をミラー化する必要があります
  3. メモ帳で以下のファイルを開きます:
    • NuGenesis 8 の場合:ドライブ:\Program Files (x86)\apache-tomcat-X.Y.ZZ\conf\server.xml
    • NuGenesis 9 の場合:ドライブ:\Program Files (x86)\Waters\apache-tomcat-X.Y.ZZ\conf\server.xml
  4. server.xml の末尾(「</Host>」行の上部)に以下の行を追加します:
    • <Context path="/ngaudit/servlet" docBase="NGAudit" reloadable="true" cookies="true" useHttpOnly="false"/>
    • <Context path="/servlet" docBase="WebVision" reloadable="true" />
  5. server.xml を保存して閉じます
  6. NuGenesis Web アプリを新しい Tomcat フォルダーにコピーします:
    • NuGenesis 8:
      1. フォルダードライブ:\Program Files (x86)\apache-tomcat-6.0.29\webapps\NGAudit をドライブ:\Program Files (x86)\apache-tomcat-X.Y.ZZ\webapps にコピーします
      2. フォルダードライブ:\Program Files (x86)\apache-tomcat-6.0.29\webapps\WebVision をドライブ:\Program Files (x86)\apache-tomcat-X.Y.ZZ\webapps にコピーします
    • NuGenesis 9:
      1. フォルダードライブ:\Program Files (x86)\Waters\apache-tomcat-9.0.8\webapps\NGAudit をドライブ:\Program Files (x86)\Waters\apache-tomcat-X.Y.ZZ\webapps にコピーします
      2. フォルダードライブ:\Program Files (x86)\Waters\apache-tomcat-9.0.8\webapps\WebVision をドライブ:\Program Files (x86)\Waters\apache-tomcat-X.Y.ZZ\webapps にコピーします
  7. 新しいサービスを作成します。管理者権限で、cmd.exe で以下を実行します。「XYZZ」を Tomcat のバージョン番号に置き換えます:
    • ドライブ:\Program Files (x86)\apache-tomcat-X.Y.ZZ\bin\service.bat install tomcatXYZZ
    • :service.bat は、Apache Tomcat の Windows 配布でのみ入手できます。service.bat が Bin フォルダーに存在しない場合は、間違った配布がインストールされたか、不完全/破損しています。NuGenesis での使用およびこの手順の使用は、「32 ビット版 Windows」配布のみがサポートされています
  8. services.msc を開き、Tomcat サービスを設定します:
    1. 既定の Apache Tomcat サービスである「Apache Tomcat 9」、および存在する可能性のある古いバージョンの Tomcat を停止します
    2. 古い Tomcat サービスの[スタートアップの種類]を[無効]に設定します
    3. 最新の Tomcat サービスを起動し、[スタートアップの種類]を[自動]に設定します
  9. オプションで、古い Tomcat サービスをアンインストールします。手順については、「追加情報」セクションを参照してください

追加情報

互換性

Apache Tomcat 9.x または 10.x は最低でも Java 8 が必要であるため、NuGenesis 8 は、これらのバージョンの Tomcat と互換性がありません。

基本クラスが「java.*」ではなく「jakarta.*」になっており、NuGenesis サーブレットを起動できないため、NuGenesis 9 は Apache Tomcat 10.x と互換性がありません。

関連項目:NuGenesis 9 SDMS の Java ランタイム環境をアップグレードする方法

古い Tomcat サービスのアンインストール

  1. services.msc を開き、廃止された Tomcat サービスをダブルクリックし、サービス名を記録します。上記のインストール手順によると、「Tomcat9」または「tomcatXYZZ」である可能性があります
  2. 管理者権限でコマンドプロンプトを開きます
  3. ディレクトリーを、廃止された Tomcat インストールの \bin フォルダーに変更します。例:ドライブ:\Program Files (x86)\Waters\apcahe-tomcat-9.0.8\bin
  4. ステップ 1 で記録したサービス名に置き換えて、次のコマンドを実行します:
    • service.bat uninstall serviceName
  5. このコマンドが正常に完了すると、メッセージ「The service 'serviceName' has been removed」(サービス「サービス名」が削除されました)がコマンドプロンプトに表示され、サービスは services.msc に表示されなくなります

設定

既定では、Tomcat 設定ツールである tomcat9w.exe は、上記の手順によってインストールされる新しい Tomcat サービスを設定しません。このツールをダブルクリックすると、次のメッセージが表示されます:「The specified service does not exist as an installed service. Unable to open the service 'tomcat9'」(指定されたサービスはインストールされたサービスとして存在しません。サービス「tomcat9」を開けません)。新しい Tomcat サービスで設定ツールを使用するには:

  1. 管理者権限でコマンドプロンプトを開きます
  2. Tomcat インストールディレクトリー(既定:ドライブ:\Program Files (x86)\Waters\apache-tomcat-9.0.X\bin)に変更します
  3. 次のコマンドを入力します(ここで、「tomcatXYZZ」はアップグレード手順のステップ 7 で使用したものと同じサービス名です):
    • tomcat9w.exe //ES//tomcatXYZZ
  4. Tomcat9w が実行され、新しい Tomcat サービスの設定が表示されます

アップグレード後

Tomcat のバージョンを更新するとき、アプリケーションサーバー IQ の実行時に 4 つの失敗したファイルが表示されることがあります。

1 - 古いバージョンの Tomcat のフォルダーからファイルおよびその構造を削除しないでください。
2 - 削除すると、これらの 4 つのファイルが欠落しますが、アプリケーションの使用には影響しません。

ファイル:

ドライブ\Program Files (x86)\Waters\apache-tomcat-oldversion\webapps\WebVision\ngv_common.js

ドライブ\Program Files (x86)\Waters\apache-tomcat-oldversion\webapps\WebVision\WEB-INF\lib\NGWebVision.jar

ドライブ\Program Files (x86)\Waters\apache-tomcat-oldversion\webapps\NGAudit\web-inf\lib\NGAudit.jar

ドライブ\Program Files (x86)\Waters\apache-tomcat-oldversion\webapps\WebVision\web-inf\lib\ojdbc14.jar

 

id111885, SDMS, SDMS8, SDMS8NU, SUPISDMS, SUPNG, upgrade