ポータルプロパティ

構成オプションは、サーバーの起動時にポータルプロパティ、プロパティファイルから読み取られた名前と値のペアのセット、およびDocker環境変数を使用して指定されます。 デフォルト値 は portal-impl.jar/portal.properties ファイルで指定されます。

一部のプロパティはユーザーインターフェイス（UI）を介して変更できますが、その他のプロパティはプロパティファイルまたはDocker環境変数でのみ変更できます。 これらには、データベースへの接続、 Liferay Home フォルダの場所の宣言、 ユーザの認証方法の変更 (電子メール アドレスではなくスクリーン ネームによる) が含まれます。

Liferayのインストールでは、プロパティファイルを使用します。 慣例により、portal-ext.propertiesは、デフォルトのプロパティ値を上書きするために、[Liferay Home]フォルダまたは[USER_HOME]フォルダに作成する必要があります。 新規または変更されたプロパティファイルを適用するには、DXPを再起動する必要があります。

警告

portal-impl.jar/portal.properties ファイルを直接変更しないでください。代わりに、変更するプロパティをオーバーライドする別のファイルを作成してください。 この目的のために、 portal-ext.properties ファイルが定義されています。

portal-ext.propertiesファイルを使用してデフォルトのプロパティをオーバーライドすると、以下の利点があります。

• ファイルを他のLiferay DXP環境およびサーバーノードにコピーできます。
• 構成をバージョン管理システムに保存して、構成管理を簡素化できます。
• 最初の起動前にファイルにプロパティを設定することは、Liferayを構成する最も簡単な方法です。

ポータルプロパティは、環境変数（Env変数）とプロパティファイルとともにLiferay Dockerコンテナに適用されます。 ポータル プロパティを使用して Docker コンテナを構成するには、 コンテナの構成 を参照してください。

内容：

• ポータルプロパティの使用
• ポータルプロパティの優先度
• システム設定と構成ファイルの使用

注

DXP 7.3以降、仮想インスタンスごとのポータルプロパティファイル機能は削除されました。 DXP は、 portal-[companyId].properties 形式のファイルのインスタンスごとのプロパティを、会社 ID に一致するインスタンスに適用しなくなりました。

ポータルプロパティの使用

［Liferay Home］ /portal-ext.propertiesを作成する場合、ベストプラクティスは、関連するセクションを portal-impl.jar/portal.properties から portal-ext.properties ファイルにコピーし、次に変更することですあなたが望むものへの価値。

注

セットアップ ウィザードを使用する場合、DXP は [Liferay ホーム]内の portal-setup-wizard.properties というファイルにこれらのプロパティを設定します。

以下は設定例です。

データベース接続の設定

データベース接続プロパティは通常、portal-ext.propertiesファイルに設定されます。 たとえば、データベース接続を変更する場合は、portal-ext.propertiesファイルを作成し、データベース接続プロパティを必要な値に設定します。

jdbc.default.driverClassName=org.mariadb.jdbc.Driver
jdbc.default.url=jdbc:mariadb://localhost/lportal?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false
jdbc.default.username=joe.bloggs
jdbc.default.password=123456

データベース構成の詳細については、 データベース構成 および データベース テンプレートを参照してください。

Liferay Homeの場所の設定

一部のアプリケーション サーバー (WebLogic など) では、DXP WAR ファイルをデプロイする前に、 Liferay ホームの場所をカスタマイズ する必要があります。 liferay.home プロパティが場所を設定します。

liferay.home=/home/jbloggs/liferay

ユーザーの認証方法の変更

ユーザの認証方法を変更するには、次の company.security.auth.type プロパティ値のいずれかを追加してください。

company.security.auth.type=emailAddress

company.security.auth.type=screenName

company.security.auth.type=userId

ポータルプロパティの優先度

ポータルプロパティは、次の3つのソースから設定されます。

• portal-impl.jarにバンドルされているportal.properties
• 拡張プロパティファイル（例： portal-ext.properties）
• 環境変数

特定のプロパティでは、最後に読み取られた値が優先されます。 プロパティ ソースは、 決定論的な順序 で読み取られます。これは、 インクルード アンド オーバーライドと呼ばれるプロパティを通じて構成可能です。

構成処理

デフォルトでは、プロパティは次の順序で読み取られます。

portal-impl.jar/portal.properties
include-and-override=portal-bundle.properties
include-and-override=${liferay.home}/portal-bundle.properties
include-and-override=portal-ext.properties
include-and-override=${liferay.home}/portal-ext.properties
include-and-override=portal-setup-wizard.properties
include-and-override=${liferay.home}/portal-setup-wizard.properties
include-and-override=${external-properties}
include-and-override=${liferay.home}/${external-properties}
[Added `include-and-override` files]
[Liferay Docker Env variables]

portal-impl.jar/portal.propertiesファイルは上記のinclude-and-override定義を指定します。 他の有効なプロパティソースが追加または競合するinclude-and-overrideプロパティ値を定義している場合、これらはデフォルトをオーバーライドするために使用されます。

${external-properties} 定義は、DXPのJavaプロパティ 外部プロパティ （たとえば、 -Dexternal-properties = some.properties）に割り当てられたプロパティファイルを表します。

Liferay Dockerコンテナは、Liferay環境変数を、リストに追加されたポータルプロパティソースに集約します。

重要

複数のファイルでプロパティをオーバーライドする場合、 最後に 定義されたプロパティ ソースが優先されます。 他のすべては無視されます。

ポータルプロパティの優先度の例

次の例は、プロパティソースと特定のプロパティがDXPを構成する方法を示しています。

例1： portal-ext.properties を使用してプロパティをオーバーライドする

アプリケーションサーバーにメールセッションを設定し、デフォルトのportal-impl.jar/portalとは異なる名前の場合。 roperties(mail.session.jndi.name=mail/MailSession)、portal-ext.propertiesファイルでメールセッション名を指定します。

portal-ext.propertiesの新しい値：

mail.session.jndi.name=mail/SomeMailSession

結果のプロパティソースの順序：

1. portal-impl.jar/portal.properties
2. [Liferay Home]/portal-ext.properties

mail.session.jndi.nameに定義された最後の値は、［Liferay Home］/portal-ext.propertiesにあります。

結果の構成：

mail.session.jndi.name=mail/SomeMailSession

例2：プロパティファイルの追加

開発環境など、特定の環境のプロパティファイルを追加できます。 その後、共通のプロパティには単一の portal-ext.properties を、他には環境固有の設定を使用することができます。

1. 環境に応じて任意の拡張ファイル（例： portal-developer.properties）を作成し、環境固有のプロパティを追加します。

   mail.session.jndi.name=mail/DevMailSession
   

2. include-and-override プロパティを portal-ext.properties ファイルの先頭に追加して、新しい拡張ファイルをプロパティソースとして含みます。

   include-and-override=portal-developer.properties
   

結果のプロパティソースの順序：

1. portal-impl.jar/portal.properties
2. [Liferay Home]/portal-ext.properties
3. [Liferay Home]/portal-developer.properties

mail.session.jndi.nameに定義された最後の値は、［Liferay Home］/portal-developer.propertiesにあります。

結果の構成：

mail.session.jndi.name=mail/DevMailSession

ヒント

必要な数のプロパティファイルを使用することで、DXPの設定管理を簡素化することができます。

システム設定と構成ファイルの使用

一部のプロパティは、 システム設定 と 構成ファイルを使用して設定できます。 たとえば、SAML認証プロパティは、システム設定で使用できるプロパティです。

DXPデータベースに格納されているプロパティは、ポータルプロパティファイルで設定されているプロパティよりも優先されます。

システム設定を見つけるには、 コントロール パネル の 構成 → システム設定 に移動します。 システム設定は.configファイルとしてエクスポートし、ソースコントロールに保存し、分散DXPインストールで使用できます。 システム設定を介して設定されたポータルプロパティと構成ファイルは、データベースに保存されます。 すぐに適用されるプロパティもあれば、サーバーの再起動が必要なプロパティもあります。

関連トピック

• ポータルプロパティリファレンス
• ポータル開発者プロパティ
• コンテナの設定
• システム設定
• 構成ファイルについて
• AWSでLiferayを設定する