この章では、Tomcat Application Server での TIBCO EBX® のクイックインストール例について説明します。
このアプリケーションサーバーのドキュメントを置き換えるものではありません。
インストールプロセスは、技術環境、アプリケーションの相互化、配信プロセス、組織の決定などのアーキテクチャ上の決定によって決定されるため、これらは一般的なインストールの推奨事項ではありません。
Tomcat 10.x はサポートされていません。
EBX® に必要なコンポーネントの完全な説明は、Java EE 展開の章に記載されています。
予期しない動作を回避するために、クラスローディングシステム内の ebx.jar、ebx-lz4.jar、またはその他のライブラリの重複を避けることがガイドラインとなります。
以下の説明では、変数名 $CATALINA_HOME を使用して Tomcat インストールディレクトリを参照し、そこからほとんどの相対パスが解決されるようにします。ただし、$CATALINA_BASE ディレクトリが複数インスタンス構成に設定されている場合は、これらの各参照に使用する必要があります。
安全な展開をナビゲートする方法については、セキュリティのベストプラクティスを参照してください。
Java SE 17 または 21 LTS
Apache Tomcat 9.x
データベースと JDBC ドライバー
EBX® CD
以下 から Tomcat 9.x コアバイナリディストリビューションをダウンロードします。
インストーラーを実行するか、アーカイブを抽出して、デフォルトのオプションを使用して標準インストールを実行します。
EBX_HOME ディレクトリを作成します (例：C:\EBX\home、または /home/ebx)。
EBX® CD から ebx.software/files/ebx.properties ファイルを EBX_HOME にコピーします。この例では、次のファイルです。
C:\EBX\home\ebx.properties または /home/ebx/ebx.properties
必要に応じて、ebx.properties ファイルを編集してデフォルトのデータベースをオーバーライドします。デフォルトでは、スタンドアロンの H2 データベースが定義されています。サポートされている他のデータベースでは、プロパティキー ebx.persistence.factory のコメントを解除し、h2.standalone のプロパティキーにコメントを付ける必要があります。
$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>
$CATALINA_HOME/conf/catalina.properties (または $CATALINA_BASE/conf/catalina.properties) ファイルの tomcat.util.scan.DefaultJarScanner.jarsToSkip 属性に以下の行を追加し、変更します。
ebx.jar,\
ebx-addons.jar,\
ebx-lz4.jar,\
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] タブ) を使用して 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® 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.2.224.jar (デフォルトの永続化ファクトリー) は ebx.software/lib/lib-h2 ディレクトリから取得されます。
これらのコンポーネントの詳細な説明は、ソフトウェアコンポーネントの章に記載されています。もちろん、これらのコンポーネントがすでにクラスローディングシステムに展開されている場合は、それらを重複して展開する必要はありません。
データ圧縮ライブラリ専用のディレクトリ (例：$CATALINA_HOME/compress または $CATALINA_BASE/compress) を作成し、そこにコピーします。
ライブラリが、以前に更新された CLASSPATH 環境変数によって示されるディレクトリにコピーされていることを確認します。
EBX® CD から ebx.software/lib/ebx.jar ファイルを $CATALINA_HOME/lib/ (または $CATALINA_BASE/lib/) ディレクトリにコピーします。この例では、次のようになります。
$CATALINA_HOME/lib/ebx.jar
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 アプリケーション
$CATALINA_HOME/webapps/ebx-authentication.war：認証アプリケーション
Tomcat の起動後、ブラウザーに次の URL を入力して EBX® Web アプリケーションを実行します。http://localhost:8080/ebx/
EBX® ウィザードは、最初の起動時に初期リポジトリのデフォルトのプロパティを構成するのに役立ちます。