Licence File Deployment
When you purchase a licence from the Online Business Applications Centre, you will receive a licence file via email.
This file contains UTF-8 encoded XML which specifies the licence type, which server the licence is for and when the licence was issued.
Note: It is strongly recommended that your server administrator perform the installation.
Licence File Location
The licence file needs to be placed somewhere on your server's file system e.g. C:\liferay\config\.
It does not matter where this file is placed, just as long as the user account under which your servlet container runs has the necessary permissions to be able to read the file.
Note: If this is not the first licence you have purchased from Online Business Applications Centre, you will need to merge the contents of your existing licence file with that of your new licence. Open both files in your favourite text editor and simply copy and paste all <section> elements from your new licence file into your existing licence file, being careful not to overwrite any existing section elements.
Servlet Container Configuration
The portal - in this case, Liferay - needs to be told where and how to find the licence file. This is done via setting two Java system properties, which must be done through the command line.
- config.location
- config.filename
For users of the Apache Tomcat servlet container, the recommended approach to doing this is by amending the "setenv" file and adding one of the following lines (suitably substituting <licence-file-path> for the full file path of the licence).
Windows Platforms (setenv.bat)
set "JAVA_OPTS=%JAVA_OPTS% -Dconfig.filename=<licence-file-path> -Dconfig.location=file"
Linux/BSD Platforms (setenv.sh)
JAVA_OPTS="$JAVA_OPTS -Dconfig.filename=<licence-file-path> -Dconfig.location=file"
For servlet containers other than Apache Tomcat, please consult your server's documentation for guidance on the recommended approach to setting the Java system properties.
Once you have accomplished these changes, simply restart your servlet container for the changes to take effect.
Viewing the Licence
You can click the licence icon in the licensed portlet's preferences to see the licence's expiry date and server details.
For products without a user interface component, for example hooks, these licence details are accessible via http://<hostname>/<product-name>/license.