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

WebLogicにLiferayをインストールする

Liferay DXP 2026.Q1

アプリケーションサーバーとしてWebLogicを使用している場合は、DXPをWebLogic管理対象サーバーにインストールすることを強くお勧めします。 管理対象サーバーは、DXPをすばやく起動または停止でき、クラスター構成に変換できます。

注

これらの手順を実行するには、Jakarta ベースの WebLogic 15.1.1.0 以降が必要です。 WebLogicの以前のバージョンがインストールされている場合、JakartaベースのLiferayをインストールすることはできません。 Java EE ベースの Liferay の旧バージョンと Java EE ベースの WebLogic をペアリングする手順については、 の手順 を参照してください。

前提条件

WebLogicのドキュメントに従って、管理サーバーと管理対象サーバーを構成します。

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

これらのファイルは、 カスタマーポータルからダウンロードしてください。 なお、WebLogic専用のWARファイルが存在することに注意してください。

  • WebLogic版のDXP WARファイル
  • OSGi依存関係のZIPファイル

DXP WARの準備

  1. DXP WARファイルを任意の場所に解凍します。

  2. 展開された WAR の portal-ext.properties という名前のファイルを、展開された WAR の WEB-INF/classes フォルダに作成します。

  3. portal-ext.propertiesファイルで、liferay.homeプロパティをLiferay Homeフォルダパスに設定します。 WebLogicでは、 [Liferay Home] は通常ドメインのフォルダ (weblogic/domains) に設定されますが、任意のローカルフォルダを使用することもできます。 例えば、

    liferay.home=/full/path/to/your/liferay/home/folder
    重要

    liferay.home ディレクトリには、Portal/DXP osgi/ ディレクトリが含まれている必要があります。

  4. DXP WARファイルを展開し、 portal-ext.properties ファイルを WEB-INF/classes フォルダーにコピーして、 portal-ext.properties をDXP WARファイルにパッケージ化します。

  5. オプションで、拡張されたDXP WARを再度WARできます。 DXPをデプロイする準備ができたら、それを拡張アーカイブまたはWARファイルとしてデプロイできます。 どちらの場合も、DXPは起動後にプロパティ設定を読み取ります。

注

DXP のデプロイ後に portal-ext.properties を更新する必要がある場合は、インストールされている Liferay WAR の現在の場所 ROOT/WEB-INF/classes にあります。 WebLogicはインストール中にWARファイルを移動する場合があります。

WebLogicのノードマネージャーの構成

WebLogicのノードマネージャーは、管理対象サーバーを起動および停止します。

SolarisまたはLinux以外のUNIXシステムでWebLogicを実行している場合は、domains/your_domain_name/nodemanager/nodemanager.properties ファイルでこれらのノードマネージャプロパティを設定することにより、ノードマネージャのネイティブバージョンの代わりにJavaノードマネージャを使用します。

NativeVersionEnabled=false

StartScriptEnabled=true
注

デフォルトでは、ノードマネージャーはSSLを使用します。 開発中に SSL を無効にする場合は、 nodemanager.properties ファイルで SecureListener=false を設定してください。

詳細については、Oracle の Java Node Manager の構成 ドキュメントを参照してください。

WebLogicのJVMの構成

setUserOverridesLate WebLogic起動スクリプトおよび管理対象サーバーUIでJVMおよびその他のオプションを構成します。

  1. [Your Domain]/binでsetUserOverridesLate.shスクリプトを作成します。

  2. 以下の設定を追加します。

    export DERBY_FLAG="false"
export JAVA_OPTIONS="${JAVA_OPTIONS} -Dfile.encoding=UTF-8 -Djava.net.preferIPv4Stack=true -Dlog4j2.formatMsgNoLookups=true -Duser.timezone=GMT -da:org.apache.lucene... -da:org.aspectj..."
export JAVA_PROPERTIES="-Dfile.encoding=UTF-8 ${JAVA_PROPERTIES} ${CLUSTER_PROPERTIES}"
export MW_HOME="[place your WebLogic Server folder path here]"
export USER_MEM_ARGS="-Xms2560m -Xmx2560m -XX:MaxNewSize=1536m -XX:MaxMetaspaceSize=768m -XX:MetaspaceSize=768m -XX:NewSize=1536m -XX:SurvivorRatio=7"

    DERBY_FLAG 設定は、WebLogic の組み込み Derby サーバーを無効にします。—DXP はこのサーバーを必要としません。

    JAVA_OPTIONSは、DXPのUTF-8要件、Luceneの使用法、およびAspectJを介したアスペクト指向プログラミングを設定します。

    JAVA_PROPERTIESは、DXPのUTF-8要件も設定します。

    重要

    DXP では、アプリケーション サーバーの JVM が GMT タイム ゾーンと UTF-8 ファイル エンコーディングを使用することが求められます。

    MW_HOMEをWebLogicサーバーを含むフォルダに設定します。 例えば、

    export MW_HOME="/home/me/Oracle/Middleware/Oracle_Home"

    * _MEM_ARGS変数は、DXPの開始および最大ヒープメモリ容量を設定します。

  3. マネージドサーバーの起動時に、DXPのメモリ要件を設定します。 WebLogic リモート コンソールで、DXP をデプロイする管理対象サーバーに移動し、 詳細 → ノードマネージャ を選択します。 Arguments フィールドに次のパラメータを入力します。

    -Xms2560m -Xmx2560m -XX:MaxNewSize=1536m -XX:MaxMetaspaceSize=768m -XX:MetaspaceSize=768m -XX:NewSize=1536m -XX:SurvivorRatio=7

  4. ［Save（保存）］をクリックします。

メモリ要件は「引数」フィールドで設定してください。

JVMオプションの説明

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

メモリ引数の説明

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

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

依存関係のインストール

DXPは、OSGiモジュール（OSGi依存関係ZIP）とデータベースドライバーに依存しています。

  1. OSGi Dependencies ZIPファイルを[Liferay Home]/osgiフォルダーに解凍します（このフォルダーが存在しない場合は作成します）。 LiferayのOSGiランタイムは、これらのモジュールに依存しています。

  2. DXPの四半期リリース版WARファイルには、MariaDBとPostgreSQLのドライバが含まれています。 WAR に、使用しているサポート対象データベースのドライバが含まれていない場合は、データベースベンダーの JDBC JAR ファイルをダウンロードし、展開された DXP WAR の WEB-INF/shielded-container-lib フォルダに配置します。

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

注

HypersonicデータベースはDXPにバンドルされており、テスト目的に役立ちます。 本番インスタンスにはHSQLを使用しないでください。

Elasticsearchのインストール

Liferay を起動すると、デフォルトの サイドカー Elasticsearch サーバーがインストールされ、起動します。 WebLogicにインストールするときは、最初からリモートElasticsearchサーバーをセットアップする必要があります。 Elasticsearch 入門 を参照してください。

Liferay DXP が構成され (Elasticsearch コネクタには .config ファイルを使用)、Elasticsearch が既に構成され実行されている状態で起動されると、Elasticsearch への接続がアクティブ化されます。

データベースに接続

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

Liferay DXPは、DXPの組み込みデータソース（推奨）またはアプリサーバー上のJNDIデータソースを使用してデータベースに接続できます。

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

それ以外の場合は、WebLogicでデータソースを構成できます。

  1. DXP WAR (7.4 以降) またはデータベースベンダーから JDBC JAR を入手し、ドメインの lib フォルダーにコピーします。

  2. WebLogicリモートコンソールにログインしてください。

  3. サービス ツリーで、 データ ソース をクリックします。

  4. 新しいデータソースを作成するには、［ New］をクリックします。

  5. Name フィールドに Liferay Data Source を、 JNDI Name フィールドに jdbc/LiferayPool を入力します。

  6. データベースのタイプとドライバーを選択します。 例えば、PostgreSQL は PostgreSQL のドライバ (タイプ 4) バージョン:Any です。

  7. データベースの情報（名前、ホスト名、ポート番号、ユーザー名、パスワード）を入力してください。

  8. フォーム上部の 作成 をクリックします。

  9. DXPをJDBCデータソースに接続します。 portal-ext.propertiesファイル（上記を参照）に、データソースのJNDI名を入力します。 例えば、

    jdbc.default.jndi.name=jdbc/LiferayPool

メールサーバーに接続

Liferay DXP は、内蔵のメールセッションを使用してメールサーバー に接続できます。 それ以外の場合は、WebLogicのメールセッションを使用できます。

  1. WebLogicを起動し、WebLogicリモートコンソールにログインします。

  2. ツリー編集 → サービス → メールセッション を選択します。

  3. ［ 新規 をクリックして、新しいメールセッションの作成を開始します。

  4. セッションにLiferayMailという名前を付け、JNDI名mail/MailSessionを付けます。

  5. ［作成］をクリックします。

  6. メールサーバーに必要な場合は、 セッションユーザー名、 セッションパスワード、 セッションパスワードの確認、および JavaMail プロパティ フィールドを入力してください。 これらのフィールドの詳細については、 WebLogic ドキュメント を参照してください。

  7. ［保存］をクリックします。

  8. 管理対象サーバーと管理サーバーをシャットダウンします。

  9. 管理対象サーバーと管理サーバーをシャットダウンした状態で、次のプロパティをLiferayホームの portal-ext.properties ファイルに追加します。

    mail.session.jndi.name=mail/MailSession
注

DXP がデプロイされると、 portal-ext.properties ファイルはドメインの autodeploy/ROOT/WEB-INF/classes フォルダーにあります。

管理サーバーと管理サーバーを再起動すると、変更が有効になります。

DXPのデプロイ

  1. DXPをデプロイしている指定の管理対象サーバーがシャットダウンされていることを確認します。

  2. WebLogic Remote Console で、編集ツリーから デプロイメント → アプリケーションデプロイメント を選択します。

  3. 新しいデプロイメントを開始するには、 新規 をクリックしてください。

  4. 名前、タイプ Liferay。

  5. ターゲットで、Liferayをインストールするサーバーを 選択済み ボックスに移動します。

  6. 展開された WAR を使用するには、 アップロード の選択を解除し、展開された WAR への完全なパスを ソース パス に入力します。

  7. WAR ファイルを使用するには、 アップロード をオンにしたまま、マシンから DXP WAR ファイルを選択します。

  8. ［作成］をクリックします。

  9. 配置が完了したら、構成が正しい場合は、［ Save ］をクリックします。

  10. DXPをデプロイした管理対象サーバーを起動します。 DXPはすべてのJSPをプリコンパイルしてから起動します。

DXPのデプロイ後に、 PhaseOptimizerを含む以下のような過剰な警告やログメッセージが表示される場合があります。 これらは良性なので、無視しても構いません。 これらのメッセージは、アプリサーバーのログレベルまたはログフィルターを調整することでオフにできます。

May 02, 2018 9:12:27 PM com.google.javascript.jscomp.PhaseOptimizer$NamedPass process
     WARNING: Skipping pass gatherExternProperties
May 02, 2018 9:12:27 PM com.google.javascript.jscomp.PhaseOptimizer$NamedPass process
     WARNING: Skipping pass checkControlFlow
May 02, 2018 9:12:27 PM com.google.javascript.jscomp.PhaseOptimizer$NamedPass process
     INFO: pass supports: [ES3 keywords as identifiers, getters, reserved words as properties, setters, string continuation, trailing comma, array pattern rest, arrow function, binary literal, block-scoped function declaration, class, computed property, const declaration, default parameter, destructuring, extended object literal, for-of loop, generator, let declaration, member declaration, new.target, octal literal, RegExp flag 'u', RegExp flag 'y', rest parameter, spread expression, super, template literal, modules, exponent operator (**), async function, trailing comma in param list]
     current AST contains: [ES3 keywords as identifiers, getters, reserved words as properties, setters, string continuation, trailing comma, array pattern rest, arrow function, binary literal, block-scoped function declaration, class, computed property, const declaration, default parameter, destructuring, extended object literal, for-of loop, generator, let declaration, member declaration, new.target, octal literal, RegExp flag 'u', RegExp flag 'y', rest parameter, spread expression, super, template literal, exponent operator (**), async function, trailing comma in param list, object literals with spread, object pattern rest]

Liferay DXP Enterpriseサブスクリプションをお持ちの場合、DXPはアクティベーションキーを要求します。 詳細については、 Liferay DXP のアクティベーション を参照してください。

　 WebLogicでDXPを実行しています。

Capability:
DXP Self-Hosted Installation, Maintenance, and Administration
Resource Type:
Official Documentation
Feature:
DXP Configuration
Deployment Approach:
Liferay Self-Hosted