Documentation

ポータルプロパティ

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

一部のプロパティはユーザー インターフェイス (UI) を介して変更できますが、他のプロパティはプロパティ ファイルでのみ変更できます。 これらには、 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コンテナを構成するには、 Configuring Containers を参照してください。

コンテンツ:

注釈

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

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

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

注釈

セットアップウィザードを使用する場合、DXPはこれらのプロパティを[Liferay Home]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

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

Liferayホームの場所の設定

一部のアプリケーションサーバー(WebLogicなど)では、DXP WARファイルをデプロイする前に Liferay Homeの場所をカスタマイズする必要があります。 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

  • 環境変数

特定のプロパティでは、最後に読み取られた値が優先されます。 プロパティソースは、include-and-overrideと呼ばれるプロパティを介して構成可能な 決定論的な順序 で読み取られます。

  1. プロパティソースは3つあります。

    • portal-impl.jar/portal.propertiesファイル

    • 拡張プロパティファイル

    • Liferay Docker Env変数

  2. 共有プロパティ(複数回定義されたプロパティ)に定義された最後の値が優先されます。

  3. プロパティソースは 決定論的順序 で読み込まれます。

構成処理

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

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]

DXPサーバーが使用しているインクルード拡張ファイルのリストは、コントロールパネルの[構成]セクションの [サーバー管理]ページにあります。

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

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

重要

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

DXPサーバーのすべてのポータルプロパティは、コントロールパネルの[構成]セクションの [サーバー管理]ページに表示できます。

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

次の例は、プロパティソースと特定のプロパティが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インストールで使用できます。 システム設定を介して設定されたポータルプロパティと構成ファイルは、データベースに保存されます。 すぐに適用されるプロパティもあれば、サーバーの再起動が必要なプロパティもあります。