この記事では、 のportal-ext.properties のプロパティが正しく動作しない場合の状況を説明します。 この記事では、 portal-ext.properties のプロパティが有効にならない一般的な原因についても説明し、 portal-ext.properties で設定されたプロパティが正しく実装されるように、ファイルを設定する適切な方法と、それをどこに配置するかについての指示を提供しています。
決議
1. 設定の保存
コントロールパネルのユーザーインターフェイスで保存された設定はすべてデータベースに保存されるため、 portal-ext.properties の構成よりも優先されます。
2. 正しいプロパティや値を設定していない
Liferayプラットフォーム内のすべてのプロパティを参照するには、 portal.properties ファイルを参照してください。 このファイルは portal-impl.jarの中にあります。 どのようなプロパティが利用できるのかに加えて、ほとんどのプロパティには、そのプロパティが何をするのか、どのような値を設定できるのかについての説明があります。 また、Javadocsのページにある portal.properties にも記載されています。
3. portal-ext.properties を正しい場所に置かない
portal-ext.properties は完璧に設定できますが、ポータルが検知できる場所に配置されていないと効果がありません。 portal-ext.propertiesを置く場所は2箇所あります。
-
$LIFERAY_HOME(ここで、Liferayプラットフォームは /data、 /logs、および /deploy フォルダを作成します) WEB-INF/classes
Liferayプラットフォームが起動すると、読み込まれているプロパティファイルがデータベース接続の直前に表示されます。 こんな感じになるはずです。
Loading jar:file:/root/liferay/tomcat-8.0.32/webapps/ROOT/WEB-INF/lib/portal-impl.jar!/system.properties Loading jar:file:/root/liferay/tomcat-8.0.32/webapps/ROOT/WEB-INF/lib/portal-impl.jar!/system.properties Loading jar:file:/root/liferay/tomcat-8.0.32/webapps/ROOT/WEB-INF/lib/portal-impl.jar!/portal.properties Loading file:/root/liferay/portal-ext.properties
NOTE: デフォルトの LIFERAY_HOME が変更された場合は、必ず
module.framework.base.dir=
をモジュールフレームワークのベースパスを形成するディレクトリに移動します。
4. 複数の同じプロパティを持つ、または相反するプロパティを持つ
同じプロパティのコピーを複数持つと、Liferayプラットフォームがそれらの値をすべて使用することになり、問題が発生する可能性が高くなります。 たとえば、このプロパティは、Liferay Portal サーバのホスト名を表示するかどうかを制御します。
web.server.display.node=
有効な値は真または偽のいずれかです。
web.server.display.node=の複数のコピーがある場合、両方が真に設定されていても、Liferay Portal はこれを 真、真 としてデータベースに読み込んでしまいます。 これは有効な値ではないので、このプロパティは有効になりません。
portal-ext.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 プロパティがリストされている順にロードされることに注意してください。 例えば、portal-ext.propertiesのプロパティがある値に設定され、portal-setup-wizard.propertiesに同じプロパティが別の値に設定されている場合、portal-setup-wizard.propertiesはportal-ext.propertiesの後にロードされるため、portal-setup-wizard.propertiesはportal-ext.propertiesを上書きしてしまいます。
追加のプロパティファイルがある場合は、競合するプロパティや重複するプロパティがないことを確認してください。
5. ファイル名と拡張子のスペルミス
portal-ext.propertiesのスペルを間違えた場合、Liferayプラットフォームはファイルを読まず、その内容は無視されます。 Windowsでよく起こるもう一つのミスは、ファイルの拡張子がファイル名から隠されている場合です。 そのため、新しいテキストファイルを portal-ext.propertiesとして作成すると、実際には portal-ext.properties.txt となり、Liferay プラットフォームでは読まれません。