ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

Tomcatへのインストール

Liferay DXP 2025.Q3+/Portal 2026.Q1+

注記

Jakarta より前の Liferay バージョンについては、 Tomcat への以前のバージョンのインストールを参照してください。

重要

Liferay-Tomcat バンドルまたは Docker イメージを使用することが、Liferay DXP の使用を開始する最も速い方法です。この記事は、Tomcatアプリケーションサーバーの設定を完全に制御したいユーザー向けです。

先に進む前に、 Liferay-Tomcat バンドルのインストールおよびデータベースの設定の記事を確認してください。

Tomcatにインストールするには、DXP WARファイルのインストール、依存関係のインストール、Tomcatの設定、およびDXPのデプロイが必要です。データベースとメールサーバーへの接続も設定する必要があります。

これを実現する最も簡単で手軽な方法は、Liferayの「Liferay-Tomcat」バンドルをダウンロードし、そこから依存関係、スクリプト、およびROOT.xmlを、以下に説明する場所へコピーすることです。それ以外の場合は、依存関係をダウンロードして、Tomcatを手動で設定することもできます。

前提条件

Tomcat をどのように構成するかに関わらず、ヘルプセンター (サブスクリプション) または Liferay コミュニティダウンロードからこれらのファイルをダウンロードしてインストールする必要があります。

DXP WARファイル
OSGi依存関係のZIPファイル
Tomcat 10+

Liferay DXP/Portal を実行するには、サポートされている Java バージョンが必要です。推奨設定については、 JVM構成を参照してください。

Tomcat サーバーの親フォルダは Liferay Home です。 $TOMCAT_HOME は Tomcat サーバーのフォルダを指します。通常は tomcat-[version] または apache-tomcat-[version] という名前になります。

DXP WARのインストール

Tomcat を新規インストールする場合は、 $CATALINA_BASE/webapps/ROOT フォルダーの内容を削除してください。これにより、Tomcatのデフォルトのホームページが削除されます。
DXP .war ファイルの内容を $CATALINA_BASE/webapps/ROOT に展開します。

依存関係のインストール

DXPは、Liferay-Tomcatバンドルに含まれる多くのJARファイルに依存しています。バンドルに含まれるJARファイルの中には、必ずしも必須ではないものもありますが、それでも役立つ場合があります。 Tomcat バンドルを使用していない場合は、ダウンロードした OSGi 依存関係 アーカイブと、以下に説明するサードパーティの JAR 依存関係を使用する必要があります。

OSGi Dependencies ZIP ファイルの内容を [Liferay Home]/osgi フォルダーに解凍します (このフォルダーが存在しない場合は作成してください)。 LiferayのOSGiランタイムは、これらのモジュールに依存しています。
DXP WARファイルには、MariaDBとPostgreSQLのドライバが含まれています。以前のWARにはそれらがありません。 WAR に使用しているサポート対象データベースのドライバが含まれていない場合は、データベースベンダーの JDBC JAR ファイルをダウンロードし、 $CATALINA_BASE/webapps/ROOT/WEB-INF/shielded-container-lib フォルダに配置してください。

サポートされているデータベースの一覧については、互換性マトリックスを参照してください。

注記

DXPにはHypersonicデータベースが同梱されており、テスト目的で役立ちます。本番環境ではHSQLを使用しないでください。

Tomcatの設定

TomcatでDXPを実行するための設定には、以下のタスクが含まれます。

JVMオプションの設定
DXPのWebアプリケーションコンテキストを指定する
プロパティと記述子の設定

setenv.bat、setenv.sh、startup.bat、startup.sh、shutdown.bat、およびshutdown.shファイルをDXPバンドルから$CATALINA_BASE/binフォルダにコピーします。それ以外の場合は、setenv.batおよびsetenv.shスクリプトを作成します。
setenv.sh スクリプトは、Tomcat のサーブレットコンテナである Catalina の JVM オプションを設定します。これらの選択肢の中には、Javaランタイム環境の場所も含まれる。この環境がサーバー上でグローバルに利用できない場合は、Tomcat が実行できるように、 setenv.sh スクリプトでその場所を設定してください。これを行うには、環境変数 と を DXP でサポートされている JRE に指定します。
```
export JAVA_HOME=/usr/lib/jvm/java-8-jdk
export PATH=$JAVA_HOME/bin:$PATH
```

次に、CatalinaのJVMオプションを設定してDXPをサポートするようにします。

CATALINA_OPTS="$CATALINA_OPTS -Dfile.encoding=UTF-8 -Djava.net.preferIPv4Stack=true -Dlog4j2.formatMsgNoLookups=true -Duser.timezone=GMT -Xms2560m -Xmx2560m -XX:MaxNewSize=1536m -XX:MaxMetaspaceSize=768m -XX:MetaspaceSize=768m -XX:NewSize=1536m -XX:SurvivorRatio=7"

JVMオプションの説明

オプション	説明
`-Dfile.encoding=UTF-8`	DXPにはUTF-8ファイルエンコーディングが必要です。
`-Djava.net.preferIPv4Stack=true`	IPv6スタックよりもIPv4スタックを優先する。
`-Dlog4j2.formatMsgNoLookups=true`	リモートコード実行（RCE）の脆弱性を解決します。詳細については、 LPS-143663 を参照してください。
`-Duser.timezone=GMT`	DXPでは、アプリケーションサーバーのJVMがGMTタイムゾーンを使用することが求められます。

メモリ引数の説明

メモリ引数	説明
`-Xms`	ヒープの初期スペース。
`-Xmx`	ヒープの最大スペース。
`-XX:NewSize`	最初の新しいスペース。通常、新しいサイズをヒープ全体の半分に設定すると、より小さな新しいサイズを使用するよりもパフォーマンスが向上します。
`-XX:MaxNewSize`	最大の新しいスペース。
`-XX:SurvivorRatio`	新しいスペースとSurvivor領域の比率。 Survivor領域は、古い世代の領域に昇格する前に、若い世代のオブジェクトを保持します。

注記

DXPをインストールした後、これらの設定（これらのJVMオプションを含む）をさらに調整することで、パフォーマンスを向上させることができます。詳細については、 Liferay のチューニングおよび JVM のチューニングを参照してください。

Tomcatの設定を続行します。

Liferay-Tomcat バンドルがある場合は、その $CATALINA_BASE/conf/Catalina/localhost/ROOT.xml ファイルをアプリケーションサーバー内の対応する場所にコピーします。ファイルパスが存在しない場合は作成し、 ROOT.xml ファイルを作成します。

ROOT.xml ファイルは、DXP の Web アプリケーションコンテキストを指定します。例えば、
```
<Context crossContext="true">
    <JarScanner className="com.liferay.support.tomcat.util.scan.NOPJarScanner" />

    

    
</Context>
```
crossContext="true" を設定すると、複数の Web アプリケーションが同じクラスローダーを使用できるようになります。この設定には、JAASレルムを設定するためのコメント付きの手順とタグが含まれています。

重要

デフォルトの Liferay Portal の Web コンテキストは、XML ファイル名を変更することで変更できます (例: localhost:8080/ から localhost:8080/myportal)。ただし、これは推奨されません。
URIエンコーディングは必ずUTF-8を使用してください。 Tomcat バンドルから $CATALINA_BASE/conf/server.xml ファイルをサーバーにコピーします。そうでない場合は、 $CATALINA_BASE/conf/server.xml ファイルを開き、 URIEncoding="UTF-8" を redirectPort=8443 を使用する HTTP および AJP コネクタに追加します。以下に例を示します。

古い：
```
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
```
新しい：
```
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />
```
古い：
```
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
```
新しい：
```
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" URIEncoding="UTF-8" />
```
アクセスログの書き込みを控える (オプション) には、 Valve 要素をコメントアウトします。 $CATALINA_BASE/conf/server.xml 内。ここにコメントアウトされています。
```

```

必要に応じて、 $CATALINA_HOME/conf/logging.properties ファイルで次のログレベルを設定します。

org.apache.catalina.startup.Catalina.level=INFO
org.apache.catalina.startup.ClassLoaderFactory.level=SEVERE
org.apache.catalina.startup.VersionLoggerListener.level=WARNING
org.apache.level=WARNING

$CATALINA_HOME/conf/web.xmlで、アプリケーションサーバーがアプリケーションの JAR ファイルやクラス内の注釈などの追加のメタデータを検索するかどうかを指定します。 web-app 要素の属性 metadata-complete="true" を設定すると、アプリケーションサーバーに追加のメタデータがないことが伝えられます。この設定にすると、アプリケーションサーバーの起動が速くなります。デフォルトでは、追加のメタデータをチェックします。
Unix、Linux、またはMac OSを使用している場合は、 $CATALINA_HOME/bin および $CATALINA_BASE/bin フォルダー内のシェルスクリプトを実行可能にするには、各フォルダーで次のコマンドを実行します。
```
chmod a+x *.sh
```

LiferayのTomcatサポートJARは、DXPウェブアプリケーションの一部です。 DXPはJARファイルのファイルスキャナを使用します。 DXPがJARファイルを使用するには、そのJARファイルが共通クラスローダーに存在している必要があります。 Catalina がファイルにアクセスできるようにするには、 $CATALINA_BASE/conf/catalina.properties ファイルを開き、 common.loader プロパティのカンマ区切り値リストの先頭にこの値を追加します。

"${catalina.home}/webapps/ROOT/WEB-INF/lib/support-tomcat.jar",

チェックポイント:

ファイルエンコーディング、ユーザータイムゾーン、優先プロトコルスタックは、 setenv.sh スクリプトで設定されます。
デフォルトの使用可能メモリとメタスペース制限が設定されている。
$CATALINA_BASE/conf/Catalina/localhost/ROOT.xmlはWebアプリケーションコンテキストを宣言している。
$CATALINA_BASE/conf/server.xmlは、UTF-8エンコーディングを設定している。
$CATALINA_BASE/conf/server.xmlは、ホストアクセスログを書き込むための値を宣言していない。(オプション)
$CATALINA_HOME/conf/logging.propertiesは、必要なログレベルを設定している。
$CATALINA_HOME/conf/web.xmlは、タグハンドラープールを設定し、Java 8をJSPコンパイラとして設定している。
$CATALINA_HOME/conf/web.xmlは、アプリケーションサーバーが追加のメタデータを検索しないように指定している。(オプション)
Tomcatのbinフォルダ内のスクリプトは実行可能である。
$CATALINA_BASE/conf/catalina.propertiesのcommon.loaderプロパティは、Catalinaに必要なJARへのアクセスを許可している。

アプリケーションサーバーは、DXPを実行するように設定されています。

データベース構成

DXPにはデモンストレーション目的には最適なハイパーソニックデータベースが組み込まれていますが、 は本番環境では使用しないでください。本番環境では、フル機能のサポートされているRDBMSを使用してください。データベースの設定方法については、データベースの設定を参照してください。

Liferay DXPは、DXPに組み込まれているデータソースを使用する（推奨）か、アプリケーションサーバー上に作成したデータソースを使用してデータベースに接続できます。

DXP を初めて実行するときに、セットアップウィザードを使用して、DXP の組み込みデータソースをデータベースで構成できます。または、データベースの portal-ext.properties ファイルで、データベースのデータベーステンプレートに基づいてデータソースを構成することもできます。

それ以外の場合は、Tomcatでデータソースを設定できます。

Tomcatデータソースの設定

データベースサーバーがインストールされ、正常に動作していることを確認してください。別のマシンにインストールされている場合は、DXPマシンからアクセスできることを確認してください。
DXP WAR またはデータベースベンダーから JDBC JAR を入手し、 $TOMCAT_HOME/lib/ext フォルダーにコピーします。

$CATALINA_BASE/conf/Catalina/localhost/ROOT.xml を開き、Web アプリケーション のコンテキスト にデータソースを リソース として追加します。

<Context...>
    ...
    <Resource
        name="jdbc/LiferayPool"
        auth="Container"
        factory="com.zaxxer.hikari.HikariJNDIFactory"
        type="jakarta.sql.DataSource"
        minimumIdle="10"
        maxLifetime="0"
        maximumPoolSize="85"
        driverClassName="com.mysql.jdbc.Driver"
        dataSource.user="[place your user name here]"
        dataSource.password="[place your password here]"
        jdbcUrl="jdbc:mysql://localhost/lportal?characterEncoding=UTF8&amp;dontTrackOpenResources=true&amp;holdResultsOpenOverStatementClose=true&amp;useFastDateParsing=false&amp;useUnicode=true"
    />
</Context>

データベースのURL、ユーザー名、パスワードを適切な値に置き換えてください。なお、Liferayでは、データベース接続プールにデフォルトで Hikari CPを使用します。

[Liferay_Home] にあるportal-ext.propertiesファイルで、データソースを指定してください。例えば、
```
jdbc.default.jndi.name=jdbc/LiferayPool
```

データソースが設定されました。

JNDI接続を使用している場合は、 TomcatでのJNDIの設定を参照してください。

メール設定

メールを設定する最も簡単な方法は、DXP に組み込まれているメールセッションを使用することです。組み込みのメールセッションを使用する場合は、このセクションをスキップしてください。

Tomcatを使用してメールセッションを管理する場合は、次の手順に従います。

$CATALINA_BASE/conf/Catalina/localhost/ROOT.xml を開き、Web アプリケーション コンテキスト でメールセッションを リソース として定義します。例示されているメールセッションの値を、ご自身の値に置き換えてください。

<Context...>
    ...
    <Resource
        name="mail/MailSession"
        auth="Container"
        type="jakarta.mail.Session"
        mail.pop3.host="[place POP mail host here]"
        mail.pop3.port="110"
        mail.smtp.host="[place SMTP mail host here]"
        mail.smtp.port="465"
        mail.smtp.user="[place user name here]"
        mail.smtp.password="[place password here]"
        mail.smtp.auth="true"
        mail.smtp.starttls.enable="true"
        mail.smtp.socketFactory.class="jakarta.net.ssl.SSLSocketFactory"
        mail.imap.host="[place IMAP mail host here]"
        mail.imap.port="993"
        mail.transport.protocol="smtp"
        mail.store.protocol="imap"
    />
</Context>