Tomcat 9.x のインストールに関する注意事項

最終公開日 : Aug 10, 2026

概要

注意:
  • この章では、Tomcat Application Server での TIBCO EBX® のクイックインストール例について説明します。
  • このアプリケーションサーバーのドキュメントを置き換えるものではありません。
  • インストールプロセスは、技術環境、アプリケーションの相互化、配信プロセス、組織の決定などのアーキテクチャ上の決定によって決定されるため、これらは一般的なインストールの推奨事項ではありません。
  • Tomcat 10.x はサポートされていません。
  • EBX® に必要なコンポーネントの完全な説明は、Java EE 展開の章に記載されています。
  • 予期しない動作を回避するために、クラスローディングシステム内の ebx.jar、 ebx-lz4.jar、またはその他のライブラリの重複を避けることがガイドラインとなります。
  • 以下の説明では、変数名 $CATALINA_HOME を使用して Tomcat インストールディレクトリを参照し、そこからほとんどの相対パスが解決されるようにします。ただし、$CATALINA_BASE ディレクトリが複数インスタンス構成に設定されている場合は、これらの各参照に使用する必要があります。
  • 安全な導入をナビゲートする方法については、セキュリティのベストプラクティスを参照してください。

要件

  • Java SE 11 または 17
  • Apache Tomcat 9.x
  • データベースと JDBC ドライバー
  • EBX® CD
以下も参照してください。:

Tomcat Application Server のインストール

  1. 以下 から Tomcat 9.x コアバイナリディストリビューションをダウンロードします。
    https://tomcat.apache.org/download-90.cgi
  2. インストーラーを実行するか、アーカイブを抽出して、デフォルトのオプションを使用して標準インストールを実行します。

EBX® ホームディレクトリの構成

  1. EBX\_HOME ディレクトリを作成します (例： C:\EBX\home、または /home/ebx)。
  2. EBX® CD から ebx.software/files/ebx.properties ファイルを EBX\_HOME にコピーします。この例では、次のファイルです。
    C:\EBX\home\ebx.properties、または /home/ebx/ebx.properties
  3. 必要に応じて、 ebx.properties ファイルを編集してデフォルトのデータベースを上書きします。デフォルトでは、スタンドアロンの H2 データベースが定義されています。サポートされている他のデータベースでは、プロパティキー ebx.persistence.factory のコメントを解除し、 h2.standalone のプロパティキーにコメントを付ける必要があります。

Tomcat Application Server と Java 仮想マシンの構成

  1. $CATALINA_HOME/conf/server.xml (または $CATALINA_BASE/conf/server.xml) ファイルを変更します。
    属性 encodedSolidusHandling="passthrough" を Connector エレメントに追加します。
    次の行を <Host> エレメントに追加します。
    <Context path="/ebx" crossContext="true" docBase="ebx.war"/>
    この例では、次のようになります。
    <Host name=...>
    ... ...
    <Context path="/ebx" crossContext="true" docBase="ebx.war"/>
    ... ...
    </Host>
  2. $CATALINA_HOME/conf/catalina.properties (または $CATALINA_BASE/conf/catalina.properties) ファイルの tomcat.util.scan.DefaultJarScanner.jarsToSkip 属性に以下の行を追加し、修正します。
    ebx.jar,\
    ebx-addons.jar,\
    ebx-lz4.jar,\
  3. Java 仮想マシンのプロパティを構成します。
    • Windows のコマンドプロンプト起動の場合
      setenv.bat ファイルを $CATALINA_HOME\bin または $CATALINA_BASE\bin に作成して、環境変数を設定します。このファイルには、少なくとも次の行が含まれます。

      set EBX_HOME=<path_to_the_directory_ebx_home>
      set EBX_OPTS=-Debx.home="%EBX_HOME%" -Debx.properties="%EBX_HOME%\ebx.properties"
      set JAVA_OPTS=%EBX_OPTS% -Dorg.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH=true %JAVA_OPTS%
      set CLASSPATH=<$CATALINA_HOME_or_$CATALINA_BASE>\compress\ebx-lz4.jar;%CLASSPATH%
      ここで、<$CATALINA\_HOME\_or\_$CATALINA\_BASE> は、設定されている場合、%CATALINA_HOME% または %CATALINA_BASE% に置き換える必要があります。それ以外の場合は、Tomcat のインストールディレクトリのパスに置き換える必要があります。
    • Tomcat をサービスとしてインストールした Windows ユーザーの場合
      Tomcat サービスマネージャー GUI ( タブ) を使用して Java オプションを設定します。
      GUI の Java オプションフィールドで、必ず別の行にオプションを設定してください。

      -Debx.home="<path_to_the_directory_ebx_home>"
      -Debx.properties="<path_to_the_directory_ebx_home>\ebx.properties"
      //US// パラメーターを使用してサービスを更新し、適切なクラスパス値を設定します。

      C:\> tomcat9 //US//Tomcat9 --Classpath="<$CATALINA_HOME_or_$CATALINA_BASE>\compress\ebx-lz4.jar;%CLASSPATH%"
      ここで、<$CATALINA\_HOME\_or\_$CATALINA\_BASE> は、設定されている場合、%CATALINA_HOME% または %CATALINA_BASE% に置き換える必要があります。それ以外の場合は、Tomcat のインストールディレクトリのパスに置き換える必要があります。
    • Unix シェル起動の場合
      setenv.sh ファイルを $CATALINA_HOME/bin または $CATALINA_BASE/bin に作成して、環境変数を設定します。このファイルには、少なくとも次の行が含まれます。

      EBX_HOME="<path_to_the_directory_ebx_home>"
      EBX_OPTS="-Debx.home=${EBX_HOME} -Debx.properties=${EBX_HOME}/ebx.properties"
      export JAVA_OPTS="${EBX_OPTS} -Dorg.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH=true ${JAVA_OPTS}"
      export CLASSPATH="<$CATALINA_HOME_or_$CATALINA_BASE>/compress/ebx-lz4.jar:${CLASSPATH}"
      <$CATALINA\_HOME\_or\_$CATALINA\_BASE> は、設定されている場合、${CATALINA_HOME} または ${CATALINA_BASE} に置き換える必要があります。それ以外の場合は、Tomcat のインストールディレクトリのパスに置き換える必要があります。
    注意:
    Tomcat オプション -Dorg.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH=true は、エンコードされたバックスラッシュを含む URL のブロックを回避します。
    注意：EBX® の起動に使用されるアカウントには、EBX\_HOME ディレクトリに対して作成/更新/削除の権限が必要です。
    注意:
    <path\_to\_the\_directory\_ebx\_home> は、 ebx.properties をコピーしたディレクトリです。この例では、 C:\EBX\home、または /home/ebx です。
    注意:
    データ圧縮ライブラリのネイティブインストールの場合は、CLASSPATH 環境変数で参照することだけを確認してください。

EBX® およびサードパーティライブラリの展開

  1. EBX® CD から $CATALINA_HOME/lib/ (または $CATALINA_BASE/lib/) ディレクトリにコピーします。ただし、データ圧縮ライブラリは除いてください。今回の例では、以下のようになります。
    $CATALINA_HOME/lib/javax.mail-1.5.6.jar は、 ebx.software/lib/lib-mail ディレクトリから取得されます。
    $CATALINA_HOME/lib/h2-2.1.212.jar (デフォルトの永続化ファクトリー、 ebx.software/lib/lib-h2 ディレクトリ下)
    これらのコンポーネントの詳細な説明は、ソフトウェアコンポーネントの章に記載されています。もちろん、これらのコンポーネントがすでにクラスローディングシステムに展開されている場合は、それらを重複して展開する必要はありません。
  2. データ圧縮ライブラリ専用のディレクトリ (例：$CATALINA_HOME/compress または $CATALINA_BASE/compress) を作成し、そこにコピーします。
    注意:
    ライブラリが、以前に更新された CLASSPATH 環境変数によって示されるディレクトリにコピーされていることを確認します。
  3. EBX® CD から ebx.software/lib/ebx.jar ファイルを $CATALINA_HOME/lib/ (または $CATALINA_BASE/lib/) ディレクトリにコピーします。この例では、次のようになります。
    $CATALINA_HOME/lib/ebx.jar

EBX® Web アプリケーションの展開

  1. EBX® CD から ebx.software/webapps/wars-packaging にある war ファイルを $CATALINA_HOME/webapps/ (または $CATALINA_BASE/webapps/) ディレクトリにコピーします。この例では、次のようになります。
    $CATALINA_HOME/webapps/ebx.war：EBX® アプリケーションの初期化サーブレット
    $CATALINA_HOME/webapps/ebx-root-1.0.war：データモデルに共通のデフォルトモジュールの提供
    $CATALINA_HOME/webapps/ebx-manager.war：マスターデータ管理 Web アプリケーション
    $CATALINA_HOME/webapps/ebx-dataservices.war：データサービス Web アプリケーション
    $CATALINA_HOME/webapps/ebx-dma.war：データモデルアシスタント Web アプリケーション
    $CATALINA_HOME/webapps/ebx-ui.war：ユーザーインターフェイス Web アプリケーション

EBX® アプリケーションの開始

  1. Tomcat の起動後、ブラウザーに次の URL を入力して EBX® Web アプリケーションを実行します。http://localhost:8080/ebx/
  2. EBX® ウィザードは、最初の起動時に初期リポジトリのデフォルトのプロパティを構成するのに役立ちます。