ポータルプロパティ¶
構成オプションは、 ポータルプロパティ を使用して指定されます*名前と値のペアのセットは、サーバーの起動時にプロパティファイルと環境変数から読み取られます。 デフォルト値 は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
と呼ばれるプロパティを介して構成可能な 決定論的な順序 で読み取られます。
プロパティソースは3つあります。
portal-impl.jar/portal.properties
ファイル拡張プロパティファイル
Liferay Docker Env変数
共有プロパティ(複数回定義されたプロパティ)に定義された最後の値が優先されます。
プロパティソースは 決定論的順序 で読み込まれます。
構成処理¶
デフォルトでは、プロパティは次の順序で読み取られます。
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]
${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
結果のプロパティソースの順序:
portal-impl.jar/portal.properties
[Liferay Home]/portal-ext.properties
mail.session.jndi.name
に定義された最後の値は、[Liferay Home]/portal-ext.properties
にあります。
結果の構成:
mail.session.jndi.name=mail/SomeMailSession
例2:プロパティファイルの追加¶
開発環境など、特定の環境のプロパティファイルを追加できます。 その後、共通のプロパティには単一の portal-ext.properties
を、他には環境固有の設定を使用することができます。
任意の拡張子ファイルを作成します(例:
portal-developer.properties
)。環境に環境特有のプロパティを追加します。mail.session.jndi.name=mail/DevMailSession
この
include-and-override
プロパティをportal-ext.properties
ファイルの先頭に追加することで、新しい拡張子ファイルをプロパティソースとして含めます:include-and-override=portal-developer.properties
結果のプロパティソースの順序:
portal-impl.jar/portal.properties
[Liferay Home]/portal-ext.properties
[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インストールで使用できます。 システム設定を介して設定されたポータルプロパティと構成ファイルは、データベースに保存されます。 すぐに適用されるプロパティもあれば、サーバーの再起動が必要なプロパティもあります。