オンプレミスTomcat 10.1.Xのインストールノート

最終公開日 : Sep 16, 2026
Related information
EBX® メタデータ管理アプリケーションのインストールに関する注意事項

概要

この章では、TIBCO EBX® がすでにインストールされているTomcatのオンプレミス環境におけるEBX® メタデータ管理アプリケーションの簡易インストール例について説明します。
EBX® メタデータ管理アプリケーションには、以下が必要です。
上記のコンポーネントをインストールおよび設定した後、EBX® メタデータ管理アプリケーションが利用可能であることを確認するために、最終確認を実行します。
詳細については、Tomcat 10.1.Xのインストールノートを参照してください。

EBX® メタデータ分類器と分類器データベース

このセクションの情報を使用して、分類器と分類器データベースをインストール、設定、および実行します。

要件

開始する前に、システムに以下がインストールされていることを確認してください。
  • Python 3.11.x + pipenv v2026.5.2 または Docker CLI (「設定と起動」を参照)
  • データベース: SQLite、PostgreSQL、Microsoft SQL Server、またはOracleデータベース (ORM SQLAlchemy経由)
    詳細については、サポートされているデータベースを参照してください。

設定と起動

ターゲット環境でEBX® メタデータ分類器Pythonアプリケーションをインストール、設定、および実行するには、以下のいずれかの方法を使用します。

オプション1: スタンドアロンインストール

  1. EBX® インストールCDから ebx.software/ebx-metadata/classifierディレクトリを作業ディレクトリにコピーします。
    この例では、ディレクトリは/opt/ebxにコピーされるため、EBX® メタデータ分類器ディレクトリは/opt/ebx/classifierに配置されます。
  2. /opt/ebx/classifierディレクトリにある setEnv.sh (Linux) または setEnv.bat (Windows) ファイルのシステムプロパティを更新して、正しいロギングディレクトリとデータベース接続を使用するようにします。
    注意:
    EBX\_METADATA\_CLASSIFIER\_LOG\_DIRで指定されたディレクトリが書き込み可能であることを確認してください。
    注意:
    SQLiteデータベースを使用する場合、EBX\_METADATA\_CLASSIFIER\_SQLALCHEMY\_URLで定義されたディレクトリファイルが書き込み可能であることを確認してください。
    以下の例はLinuxに適用されます。
    ##################################################################
    ## Set the path to the EBX Metadata Classifier application log directory
    ##################################################################
    export EBX_METADATA_CLASSIFIER_LOG_DIR="ebx/logs"

    ##################################################################
    ## The database connection URL in SQLAlchemy format.
    ##    Examples:
    ##      SQLite:      sqlite:///<sqlite_db_file>
    ##      PostgreSQL:  postgresql://<username>:<password>@<host>:<port>/<database_name>
    ##################################################################
    export EBX_METADATA_CLASSIFIER_SQLALCHEMY_URL=sqlite:///ebx/data/sqlite/ebx-metadata-classifier.db
    EBX® メタデータ分類器がSQLite以外のデータベースを使用するように設定されている場合、対応するドライバーをインストールする必要があります。例えばPostgreSQLの場合、以下のコマンドを実行して psycopg2-binary Pythonモジュールをインストールする必要があります。
    export PIPENV_PIPFILE="/opt/ebx/classfifier/ebx_metadata_classifier/Pipfile"
    pipenv install psycopg2-binary
    注記:
    詳細については、SQLAlchemyデータベースURLを参照してください。
  3. 必要なPythonモジュールを設定およびインストールするために、install-classifier.sh (Linux) または install-classifier.bat (Windows) を実行します。
    注意:
    EBX® が新しいバージョンに更新されるたびに、この手順を再度実行してください。
  4. 分類器サービスを起動してテストします。
    • Linuxの場合: start-classifier.sh
    • Windowsの場合: start-classifier.bat
    サービスが起動した後、以下のURLにアクセスできることを確認してください: https://:/api
  5. (オプション): 分類器サービスを停止するには、stop-classifier.sh (Linux) または stop-classifier.bat (Windows) を実行します。

オプション2: Dockerコンテナとして実行

Dockerfileベースのインストールを使用して、ホストマシン上でEBX® メタデータ分類器Dockerコンテナを実行します。
  1. EBX® インストールCDから ebx.software/ebx-metadata/classifierディレクトリを作業ディレクトリにコピーします。
    この例では、ディレクトリは/opt/ebxにコピーされるため、EBX® メタデータ分類器ディレクトリは/opt/ebx/classifierに配置されます。
  2. EBX® メタデータ分類器Dockerイメージを作成するには、/opt/ebx/classifierディレクトリで以下のコマンドを実行します。
    docker build -f docker/Dockerfile -t ebx-metadata-classifier:6.2.3 .
    デフォルトでは、このイメージは以下のDockerボリュームを定義します。
    • /app/ebx/logs — EBX® メタデータ分類器のログファイル用
    • /app/ebx/data/sqlite — SQLiteデータベースファイルの保存用
  3. EBX® メタデータ分類器Dockerイメージを起動するには、以下のコマンドを実行します。
    docker run -p 5000:5000 -v /my_custom/data:/app/ebx/data -d ebx-metadata-classifier:6.2.3
    EBX® メタデータ分類器Dockerコンテナは、以下の環境変数を使用して設定できます。
    環境変数名 説明 デフォルト値
    EBX\_METADATA\_CLASSIFIER\_ LOG\_LEVEL EBX® メタデータ分類器モジュールのロギングレベル。 INFO
    EBX\_METADATA\_CLASSIFIER\_ SQLALCHEMY\_URL SQLAlchemy形式のデータベース接続URL。 sqlite:////app/ebx/data/sqlite/ebx-metadata-classifier.db
注記:
ホスト上で複数のコンテナを実行できますが、エントリポートは異なる必要があります (例: -p 5001:5000)。

EBX® メタデータ管理モジュール

このセクションの以下のトピックでは、EBX® メタデータ管理モジュールを設定およびデプロイする方法について説明します。

要件

EBX® メタデータ管理モジュールを設定およびデプロイする前に、Tomcat 10.1.Xのインストールノートおよびサポートされているアプリケーションサーバーの指示に従って、EBX® 6.2.3と以下の追加機能がインストールされていることを確認してください。
  • TIBCO EBX® Digital Asset Managerアドオン (DAMA)
  • TIBCO EBX® Data Exchangeアドオン (DINT)
  • TIBCO EBX® Data Model and Data Visualizationアドオン (DMDV)
  • TIBCO EBX® Insightアドオン (DPRA)
  • TIBCO EBX® Information Searchアドオン (TESE)
詳細については、TIBCO EBX® アドオンの管理を参照してください。

設定

  1. EBX® インストールCDから ebx.software/ebx-metadata/config/ebx-metadata.propertiesをEBX\_HOMEディレクトリにコピーします。
  2. EBX\_HOMEディレクトリにある ebx-metadata.propertiesファイルを次のように更新します。
    ##################################################################################################
    ###
    ### EBX Metadata configuration
    ###
    ##################################################################################################

    ##################################################################################################
    # Directory for DAMA files
    ##################################################################################################
    ebx-metadata.dama.directory=${ebx.home}/metadata/dama

    ##################################################################################################
    # Specific directories for DAMA files
    #  Set one of these properties to use a different location for a DAMA data drive
    ##################################################################################################
    #ebx.metadata.dama.builtins.path=${ebx-metadata.dama.directory}/builtins
    #ebx.metadata.dama.allusers.path=${ebx-metadata.dama.directory}/allusers
    #ebx.metadata.dama.admin.path=${ebx-metadata.dama.directory}/admin
    #ebx.metadata.dama.learning.path=${ebx-metadata.dama.directory}/learning
    #ebx.metadata.dama.bow.path=${ebx-metadata.dama.directory}/bow

    ##################################################################################################
    # Directory for startup and trial staging archives
    ##################################################################################################
    ebx-metadata.init.directory=${ebx.home}/metadata/init

    ##################################################################################################
    ## Directory for temporary resources
    ##################################################################################################
    # When set, allows to specify a directory for temporary files different from java.io.tmpdir.
    # Default value is java.io.tmpdir
    ebx-metadata.temp.directory=${java.io.tmpdir}

    ##################################################################################################
    # Startup waiting time for ebx-metadata (in seconds)
    ##################################################################################################
    ebx-metadata.waiting.time=600

    ##################################################################################################
    # Maximum number of predictions returned by Metadata Classifier
    ##################################################################################################
    ebx-metadata.classifier.maxNumberOfPredictions=10
  3. EBX® インストールCDから ebx.software/ebx-metadata/config/initフォルダを、ebx-metadata.propertiesで指定された ebx-metadata.init.directoryにコピーします。
    注意:
    ebx-metadata.dama.directoryで指定されたディレクトリが書き込み可能であることを確認してください。
  4. 以下の行を ebx.propertiesファイルに追加して、EBX® メタデータのロギングを設定します。
    #Metadata Log4J Properties:
    ebx.log4j.category.log.wbp.ebx-metadata=            INFO, Console, ebxFile:ebx-metadata
  5. $CATALINA_HOME/binまたは$CATALINA_BASE/binにある setenv.sh (Linux) または setenv.bat (Windows) ファイルを修正して、環境変数 ebx-metadata.propertiesと ebx-metadata-classifier.urlを追加します。
    • Unixシェル起動の場合:
      EBX_OPTS="${EBX_OPTS} -Debx-metadata.properties=${EBX_HOME}/ebx-metadata.properties -Debx-metadata-classifier.url=http://<EBX_METADATA_CLASSIFIER_HOST>:<EBX_METADATA_CLASSIFIER_PORT>"
    • Windowsコマンドプロンプト起動の場合:
      set EBX_OPTS="%EBX_OPTS%" -Debx-metadata.properties="%EBX_HOME%\ebx-metadata.properties" -Debx-metadata-classifier.url="http://<EBX_METADATA_CLASSIFIER_HOST>:<EBX_METADATA_CLASSIFIER_PORT>"

デプロイ

TomcatにEBX® メタデータモジュールをデプロイするには:
  1. EBX® インストールCDから ebx.software/ebx-metadata/webapps/wars-packaging/ebx-metadata.warファイルを$CATALINA_HOME/webapps/ (または$CATALINA_BASE/webapps/) ディレクトリにコピーします。
  2. Tomcat起動後、ブラウザで以下のURLを入力してEBX® Webアプリケーションを実行します: http://localhost:8080/ebx/

EBX® メタデータエージェント

詳細については、TIBCO® メタデータエージェントのインストールを参照してください。

最終確認

Tomcatが正常に起動した後、EBX® メタデータ管理アプリケーションが正しくインストールされたことを確認するために、以下を使用します。
  • ログに以下のメッセージが表示されていることを確認します: Module ebx-metadata repository initialization complete.
  • EBX® UIで、メインツールバーのパースペクティブのリストに** Metadata**が含まれていることを確認します。含まれている場合、インストールが成功したことを示します。
詳細については、メタデータパースペクティブへのアクセスを参照してください。

制限事項

EBX® Container Editionを使用する場合、EBX® メタデータ分類器をコンテナ外にインストールすることはサポートされていません。