The following article outlines a short checklist of questions to ask and steps to take before opening a LAR/Staging ticket in Help Center. By taking a moment to go through this checklist before opening a Help Center request, you ensure the fastest possible resolution for your particular issue.
Resolution
For each ticket, please attach your portal-ext.properties file as well as the output of the patching-tool info command specific to the environment. For LAR/Staging tickets specifically, please work through the following checklist and include the resulting information when you create a ticket:
Note: If this is the first time staging, understand that the entire site needs to be staged first, which, depending on the size of the site, can take a long time. Please see: Staging Publishing Takes a Long Time
- How large is the LAR? There may be issues when it is over 2GB
- If you are staging, are you able to export/import LARs?
- Have you enabled the logs for LARs? (Give the different logs that can be enabled)
- Search Lar in Control Panel > Server Administration > Log Levels and set to DEBUG
- If you are receiving an "Out of Memory" exception, please provide us with:
- Details on the JVM and OS environment
- Heap dump (please see Taking Heap Dumps From a JVM)
- Are you receiving a Null Pointer Exception?
- In the portal-ext.properties please make sure that
com.liferay.portal.upload.UploadServletRequestImpl.max.size=is included and set to a large size (the property is in bytes).
- In the portal-ext.properties please make sure that
- Are you staging to a blank site?
- If using a date range of ALL and the Documents and Media or Web Content is selected, it will load the entire site and not the site page.
- Which Portal version are you staging on?
- Because of how data is serialized, LARs are tied to the originating portal version. For example, users attemping to import verson 6.1.30 LARs into a 6.2 EE portal will recieve an error message stating that the build numbers do not match.
- If you want to migrate data between portal versions, please reference Upgrading to Liferay Portal 6.2 EE.
- Attachments
- Screen shots of the staging settings or Export settings.
- Screen shots of any messages displayed.
- Attachment of the LAR if you are able to export.
- Complete logs with full exceptions from start to finish.
Additional Information
We have published additional documentation that will help you prevent Staging issues and complete your project in an efficient and timely manner. These are listed under the Related Articles heading at the top-right of this page. Feel free to use these resources as a guideline to assist you in getting the most out of Staging, whether Local Live or Remote Live.