Legacy Knowledge Base
Published Jul. 2, 2025

License fails to deploy due to permissioning

Written By

Liferay Support

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.
One error that can occur in deploying licenses doesn't have anything to do with the app server but rather arises due to the permission settings on the operating system. Some symptoms of this are:
  • The XML file sits in the "${liferay.home}/deploy" folder
  • A .li file is not generated into the ${liferay.home}data/license" folder
  • The following error log is generated during deployment:
ERROR [AutoDeployDir:143] Unable to write license-portalproduction-production-
6.1ga1-abc123.xml ERROR [AutoDeployDir:143] Unable to write license-
portalproduction-production-6.1ga1-abc123.xml
 

Resolution

To resolve this issue, read/write permissions must be configured.
 

Linux

1. Navigate to the data folder and use the "ls -l" command to see what permissions files have.
2. To change permissions, enter command "chmod -R 777 file/folder" or "chmod -R a+rwx file/folder".
These commands open up all relevant permissions for the
 
If a license error message is still received, please proceed with opening a Help Center ticket and provide the following information:
  • screenshot of the error on the license manager page
  • logs generated during the deployment process

Windows

If you’re deploying on Windows OS, please not that even though your user may have read/write permissions on the directory and file, they may have the Windows “read only” flag set in place. This setting will cause Java to think that the file cannot be written to.
 
If this is the case, simply clear the inaccurate Windows flag by right clicking the data folder, selecting "Properties" and de-selecting the "read-only" checkbox in the "General" tab or by re-configuring permissions in the "Security" tab.
 

Re-deploying

Once the permissioning changes have been made, re-deploy the license by following these steps:
  1. Stop the server
  2. Delete the $LIFERAY.HOME/data/ee directory
  3. Copy the xml file to the deploy directory
  4. Restart the application server
  5. Portal should startup automatically
Did this article resolve your issue ?

Legacy Knowledge Base