Common Causes for the Properties in the '' Not Taking Effect

This article documents the circumstances for when properties in the are not working correctly. This article also discusses common causes for the properties in the not taking effect and provides instruction on the proper ways to configure the file, as well as where to place it, to ensure that the properties set in are implemented correctly.


1. Saving Your Settings 

Any settings saved while in the Control Panel user interface will be saved to the database, and therefore, take precedence over any configurations.

2. Not Putting the Correct Properties or Values 

For a reference of all properties within the Liferay platform, take a look at the file. This file is located inside the portal-impl.jar. In addition to what properties are available, most properties will have an explanation of what they do and what values you are able to set. You may also find the on our Javadocs pages: 

3. Not Putting the in the Correct Location 

The can be configured perfectly, but if it is not located in a place that the portal can detect then it will not take effect. There are two places to put the

  • $LIFERAY_HOME (where the Liferay platform creates the /data, /logs, and /deploy folders)
  • WEB-INF/classes

As the Liferay platform is starting up, the property files being loaded will be displayed right before the database connection. It should look like this: 

Loading jar:file:/root/liferay/tomcat-8.0.32/webapps/ROOT/WEB-INF/lib/portal-impl.jar!/
Loading jar:file:/root/liferay/tomcat-8.0.32/webapps/ROOT/WEB-INF/lib/portal-impl.jar!/
Loading jar:file:/root/liferay/tomcat-8.0.32/webapps/ROOT/WEB-INF/lib/portal-impl.jar!/
Loading file:/root/liferay/

NOTE: if the default LIFERAY_HOME was changed, please be sure to specify the value of 


to the directory that will form the base path of the module framework.

4. Having Multiple of the Same Properties or Conflicting Properties 

Having multiple copies of the same property will cause the Liferay platform to use all of those values and this will very likely cause issues. For example, this property will control if the host name of the Liferay Portal server will show: 


The valid values are either true or false. 

If there are multiple copies of web.server.display.node=, even if both are set to be true, then Liferay Portal will read this as true, true in the database. Since this is not a valid value, this property will not take effect. 

Keep in mind that it is also possible to include other property files other than the using the include-and-override property. Examples can be seen here:

It is important to note that the include-and-override properties are loaded in the order that they are listed. For example, if properties in are set at one value and the same property set to another value in, the will override the because is loaded after

If there are additional property files, make sure that there aren't any conflicting or duplicate properties. 

5. Misspelling the Filename and File Extension 

If you misspell, then the Liferay platform will not read the file and its contents will be ignored. Another common mistake on Windows that can happen is if the file extensions are hidden from the filename. So if you create a new text file as, it will actually be and also will not be read by the Liferay platform. 

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 0