Apache Tomcatの手動アップグレード

ダウンロード オプション

  • PDF     (2.3 MB)
    Adobe Reader を使ってさまざまなデバイスで表示
  • ePub     (2.3 MB)
    iPhone、iPad、Android、ソニーの Reader、または Windows Phone 上で、さまざまなアプリを使って表示
  • Mobi (Kindle)     (1.6 MB)
    Kindle デバイスで、または Kindle アプリを使って複数のデバイスで表示
Updated: 2025 年 3 月 28 日
Document ID:222803

偏向のない言語

この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブ ランゲージの取り組みの詳細は、こちらをご覧ください。

翻訳について

シスコは世界中のユーザにそれぞれの言語でサポート コンテンツを提供するために、機械と人による翻訳を組み合わせて、本ドキュメントを翻訳しています。ただし、最高度の機械翻訳であっても、専門家による翻訳のような正確性は確保されません。シスコは、これら翻訳の正確性について法的責任を負いません。原典である英語版（リンクからアクセス可能）もあわせて参照することを推奨します。

    はじめに

    このドキュメントでは、CCEでApache Tomcatを手動でアップグレードする方法について説明します。

    前提条件

    要件

    次の項目に関する知識があることが推奨されます。

    • Contact Center Enterprise(CCE)12.6
    • Apache Tomcat

    使用するコンポーネント

    このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。

    • CCE 12.6
    • Apache Tomcat 9.x

    このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

    アップグレード

    ほとんどの場合、Cisco Upgrade Tomcat Utilityを使用してTomcatを更新することで脆弱性が解決されます。Tomcatのアップグレードが失敗したり、設定が破損したり、新しいユーザがOnlineにあるファイルを使用してTomcatを更新したりすることがあります。

    caution-icon

    注意：この手順を開始する前に、VMスナップショットを作成してください。TACに連絡して、サポートを依頼してください。

    アップグレード前

    1. Tomcat Webサイト(http://archive.apache.org/dist/tomcat/tomcat-9/)からTomcatインストーラ(apache-tomcat-version.exe)をダウンロードします。

    2. インストーラをUnified CCEコンポーネントVMにコピーします。このアップグレードでは、tomcatバージョン9.0.89を使用しました。

      

    Index /dist/tomcat

    この実習では、AWサーバを使用してTomcatをアップグレードしました。

    現在のTomcatのアンインストール

    ステップ 1：ディストリビュータサービスを停止します。

    Stop the Distributor Service

    ステップ 2：Windows services.mscからTomcat、IIS admin、およびWorld Wide Webサービスを停止します。

    Services.mscを開きます。

    Open Services.msc

    Click Apache Tomcat9

    Click IIS Admin Services

    Click World Wide Web

    ステップ 3：「プログラムの追加と削除」から既存のTomcatバージョンをアンインストールします。

    1. Control Panel > Program and Features > Select Tomcatの順に開きます。

               
    Open Control Panel

    Click Uninstall or Change

    2. 「アンインストール/変更」をクリックします。

        

    Uninstall or Change

    Advanced Security Settings for Tomcat

              

    Remove All Files in Apache Tomcat

    Uninstallation Complete

    Tomcatのインストール

    ステップ 1：Apache Tomcatインストーラ（EXEファイル）をc:\Temp:

    Install Tomcat

    ステップ 2：管理者としてCMDから、次のコマンドを使用してインストーラを実行します。

    note-icon

    注：バージョンは異なることがあります。C:\temp\apache-tomcat-9.0.89.exe /s /D=C:\icm\tomcat

    Installation Prompts

    ステップ 3： プロンプトに従ってインストールします。変更または検索が必要なオプションは、JREフォルダ用の1つだけです。

    Proceed with Installation

    Tomcatディレクトリを削除するバックアップTomcatフォルダ

    インストールが完了したら、作業を開始する前に、再起動が必要になった場合に備えてTomcatフォルダをバックアップする必要があります。

    ステップ 1：作成したTomcatフォルダをバックアップします。

    c:\icm\tomcat

    ステップ 2：ディレクトリ「C:\icm\tomcat\webapps\docs」を削除します。

    ステップ 3：ディレクトリ「C:\icm\tomcat\webapps\manager」を削除します。

    ステップ 4：'C:\icm\tomcat\webapps\ROOT'ディレクトリを削除します。

    Tomcatファイルのコピー

    ステップ 1：管理者としてCMDを開き、次の4つのクエリを実行します。

    • copy /Y C:\icm\bin\setup.war C:\icm\tomcat\webapps\setup.war
    • copy /Y C:\icm\install\unifiedconfig.war C:\icm\tomcat\webapps\unifiedconfig.war
    • copy /Y C:\icm\install\cceadmin.war C:\icm\tomcat\webapps\cceadmin.war
    • copy /Y C:\icm\install\ccbu-common-shindig-server.war C:\icm\tomcat\webapps\ROOT.war

    Open CMD as Administrator

    ステップ 2：コマンドプロンプトから、次の手順を実行します。

    1. "%CCE_JAVA_HOME%\bin\java" -cp C:\icm\bin Unzip C:\icm\install\unifiedconfig-realm-assembly.zip C:\icm\tomcat\lib
    2. "%CCE_JAVA_HOME%\bin\java" -cp C:\icm\bin Unzip C:\icm\install\shindig-cache-assembly.zip C:\icm\tomcat\lib

    Proceed with Steps at the Command Prompt

    ステップ 3：コマンドプロンプトから次の手順を実行して、ICMからtomcatディレクトリにjarファイルをコピーします。

    1. copy /Y C:\icm\bin\catalina.properties C:\icm\tomcat\conf\catalina.properties
    2. copy /Y C:\icm\bin\icm-websetup-shared.jar C:\icm\tomcat\lib\icm-websetup-shared.jar
    3. copy /Y C:\icm\bin\registry.jar C:\icm\tomcat\lib\registry.jar
    4. copy /Y C:\icm\bin\jntservices.jar C:\icm\tomcat\lib\jntservices.jar
    5. md C:\icm\tomcat\bin\i386 （ディレクトリの作成）
    6. copy /Y C:\icm\bin\isapi_redirect.dll C:\icm\tomcat\bin\i386\isapi_redirect.dll
    7. copy /Y C:\icm\bin\web.xml C:\icm\tomcat\conf\web.xml
    8. copy /Y C:\icm\bin\catalina-jmx-remote.jar C:\icm\tomcat\lib\catalina-jmx-remote.jar
    9. copy /Y C:\icm\install\web.config C:\icm\tomcat\bin\i386\web.config
    10. copy /Y C:\icm\bin\server.xml.IIS.custom C:\icm\tomcat\conf\server.xml

    Proceed with Next Steps at Command Prompt

    見つからないファイルの追加

    ステップ 1：次の手順では、Tomcatインストールが正しく動作している稼働中のサーバから、uriworkermap.propertiesとworkers.propertiesの2つのファイルに移動します。 

    1. 2つのファイルが欠落していることに注意してください。

    Two Files Missing2. 作業中のサーバーから不足しているファイルをコピーします。

    Copy the Missing Files from a Working Server

    ステップ 2：Apache tomcatレジストリキーのオプションに不足しているレジストリ情報を追加します。 

    次の情報はICMに固有であり、デフォルトでは追加されません。

    Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apacheソフトウェア基盤\Procrun 2.0\Tomcat9\Parameters\Java

    オプションに追加された情報オプションの最後の行の後にキーを押します。後続の文字列は、ハイフンを含めて追加する必要があります。

    -DCM_ROOT=C:\icm

    -Dcom.sun.management.jmxremote.ssl.need.client.auth=false

    -Dcom.sun.management.jmxremote.authenticate=false

    -Dcom.sun.management.jmxremote.port=1299

    -Dcom.sun.management.jmxremote.ssl=false

    -XX:MaxPermSize=128m

    -Dfile.encoding=UTF8

    -Dclient.encoding.override=UTF-8

    Add Missing Registry Information

    継承を有効にしてTomcatサービスを開始する

    ステップ 1：tomcatおよびIISサービスを開始する前の最後の手順では、フォルダの継承を検証します。この手順を実行しないと、IISがリダイレクトisapi.dllファイルを使用しようとしたときに「500 internal server error」が返されます。 

    IISには、Tomcatフォルダに対する権限がありません。

        1. c:\icm\ に移動します。
        2. フォルダTomcatを見つけます。
        3. 右クリックして[プロパティ]を選択します。
        4. Security > Advancedの順に選択します。
        5. Enable Inheritanceをクリックします。
        6. [APPLY] をクリックします。

    ユーザ権限はc:\icmから継承されます。

    Inherited User Rights

    Advanced Security Settings for Tomcat

    ステップ 2：version コマンドを実行して、更新されたバージョンがインストールされていることを確認します。

    Verify the Updated Version

    ステップ 3：ディストリビュータサービスを開始します。

    Start the Distributor Service

    ステップ 4：services.mscからApache Tomcat、IIS、およびWorld Wide Webサービスを開始します。

    Start Apache Tomcat, IIS and World Wide Web Service

    IIS Admin Service

    World Wide Web Publishing

    確認

    cceadminページが問題なくロードされ、ログインできるかどうかを検証します。

    snechikk_12-1730558384372

    更新履歴

    改定 発行日 コメント
    1.0
    28-Mar-2025
    初版
    TAC Authored

    シスコ エンジニア提供

    • サヌープN V
      シスコTAC

    このドキュメントは役に立ちましたか?

    Feedbackフィードバック

    シスコに問い合わせ

    このドキュメントは次の製品に対応しています