この記事では、 の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 プラットフォームでは読まれません。