Site Search - Liferay Learn

An Object is missing from the Application or Control Panel menu after restarting

Issue A custom Object configured to display in the Application or Control Panel menu is missing after restarting the application. The custom Object was previously present with Update 49 installed, but has now disappeared. Go to Control Panel > Objects Create an object definition Add a...

Wrong Apache Commons Lang3 library version added to module manifest

legacy Troubleshooting

Issue We have a service builder module that uses Apache Commons Lang3. Our Liferay version uses Apache Commons Lang3 version 3.11. In our module, we have defined the dependency as follows inside the build.gradle: compileOnly group: "com.liferay.portal", name: "release.dxp.api"...

Error 500:INTERNAL_SERVER_ERROR, undefined is displayed

legacy Troubleshooting

Issue When using the fields Author, Modified Date, or Created Date as Default Sort in a View, an error message is displayed on the Object list view. Steps to Reproduce: 1) Navigate to Menu > Control Panel > Object > Objects 2) Create a new Object and add a text field 3) Navigate to the...

Service Builder module not registered when using spring as dependency-injector

legacy Troubleshooting

Issue When dependency-injector="spring" is set in service.xml, the services are not getting registered in Liferay DXP 7.4. The Liferay-Spring-Context: META-INF/spring line is missing from the generated service jar's MANIFEST.MF file and this causes the issue, therefore the services can...

Changes to portlet-model-hints.xml are lost if running mvn generate-resources from the root of a maven workspace

legacy Troubleshooting

Issue I made some changes (e.g. a hint) to the portlet-model-hints.xml file under my project's service builder folder and I am now running the mvn clean generate-resources command. If I run this command from within the service folder, the modification is kept, but if I run it from the...

Required alert is displayed on Name and Label fields

legacy Troubleshooting

Issue Required alert is displayed on Name and Label fields when only the Label field is blank for Object and Object Field Steps to Reproduce: 1) Navigate to Objects 2) Click to create an Object 3) Leave only the Label blank 4) Try to save 5) Do the same for Object Field Expected...

How to exclude precompiled JSP files from the original module when extending modules?

legacy Troubleshooting

Issue After implementing and deploying an extended module, changes in JSP files are not shown. When extending modules, how can I prevent precompiled original JSPs from being included in the resulting JAR? Environment Liferay DXP 7.0+ Resolution Note: Customization with Ext projects is...

'View' option is displayed when the user can edit it

legacy Troubleshooting

Issue View option is always displayed Steps to Reproduce: 1) Navigate to Object Admin 2) Create an object 3) Click on the kebab menu Expected Behavior: 'Edit' is displayed instead of 'View' 'View' is displayed only when the user cannot edit it Observed Behavior: 'View' is always...

Blocks in object layout cannot be deleted by the user

legacy Troubleshooting

Issue The user cannot delete a block in the object layout Steps to Reproduce: 1) Navigate to Menu > Control Panel > Objects 2) Create a new object (with fields) 3) Define the layout of the object 4) Add a tab and a block 5) Add a field to a block and save 6) Navigate to Layout 7)...

Liferay Developer Tools .zip File Not Available

legacy Troubleshooting

Issue I need a zip version of Liferay Developer Tools that does not require local admin rights. Resolution Liferay does not provide .zip files for Liferay Developer Tools. This is because such a method could be used to circumvent restrictions organizations often intentionally put in...

Error: compound selectors may no longer be extended is encountered when building the themes

legacy Troubleshooting

Issue When creating the bare-bone theme without any customization, the build is encountered with the below error: [14:26:26] 'build:compile-css' errored after 4.9 s [14:26:26] Error in plugin "sass" Message: build/_css/compat/components/_dropdowns.scss Error: compound selectors may no...

Ext module based on patched original module is named as null.ext.jar after having been regenerated

legacy Troubleshooting

Issue We are developing an ext module to extend a liferay module, com.liferay.asset.browser.web, in this case, and we have configured the build.gradle of this ext module to use this package as the originalModule. We have installed a hotfix that includes a patched version of...

Where to place pre-startup scripts in Liferay Workspace

legacy Troubleshooting

Issue We are building Docker images so we run the task "gradle buildDockerImage" to build our image. We would like to know the following: Where do we have to place in our workspace "pre-startup" scripts? We have tried to create the folder in common or specific environment folder but then...

Adding a valid liferay runtime in Dev Studio

legacy Troubleshooting

Issue When attempting to create a Liferay Module Project Fragment, I'm encountering the following error: "Please set a valid liferay portal runtime, you can initBundle or modify 'liferay.workspace.home.dir' to make it point to an existing runtime." Environment Liferay Developer Studio...

SSLHandshakeException handshake_failure after updating Liferay Workspace

legacy Troubleshooting

Issue SSLHandshakeException handshake_failure is thrown after updating the Liferay Workspace version, as shown below: javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure at java.base/sun.security.ssl.Alert.createSSLException(Alert.java:128) at...

Custom module created from form-field template not working as expected

legacy Troubleshooting

Issue I created a custom form field using the form-field template in Developer Studio, but when I deploy the module, the form field is not working as expected. The form field does not render and the form never successfully saves. Environment Liferay DXP 7.2 GA1 to Fix Pack 3 Resolution...

'Failed to run platform init' error when installing Developer Studio

legacy Troubleshooting

Issue When running the Dev Studio Installer, I encountered an error that looks like the following: Problem running post-install step. Installation may not complete correctly Error running C:/Program Files/Java/jdk1.8.0_51/bin/java.exe-jar "C:/Program Files (x86)\LDS Test...

Liferay Gradle plugin is not compatible with gradle 6.0+

legacy Troubleshooting

Issue When building a service using Service Builder, I encounter the following error: A problem occurred configuring project ':modules:test:test-api'. > Failed to apply plugin class 'com.liferay.gradle.plugins.node.NodePlugin'. > Could not create plugin of type 'NodePlugin'. > Could not...

Errors Updating Liferay Workspace

legacy Troubleshooting

Issue I'm running into errors when attempting to update my Liferay Workspace to a higher version. Environment Liferay Developer Studio Liferay Workspace with Gradle Build Resolution If your project does not build or you're encountering errors when running any Gradle command, it likely...

Cannot read property 'help' of undefined error when trying to upgrade a theme to Liferay DXP 7.2

legacy Troubleshooting

Issue While following this tutorial: https://help.liferay.com/hc/en-us/articles/360029005512-Upgrading-Your-Theme-from-Liferay-Portal-7-0-to-7-2, users may encounter the below error: $ gulp upgrade test-theme/node_modules/gulp-help/index.js:81 task = gulp.tasks[name]; ^ TypeError: Cannot...

Can I use Java 11 in Jenkins to build 7.2 projects?

legacy

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue Liferay DXP 7.2 is compatible with JDK11, how can I have the same version on Jenkins within my Liferay PaaS project? Environment...

Can't find npm jQuery portlet template for DXP 7.2 in Dev Studio

legacy

Issue I want to create a Liferay Module project for DXP 7.2 using the npm jQuery portlet template, but I am unable to find the template in the drop down: Environment Liferay Developer Studio DXP 7.2 Resolution The npm jQuery portlet template was intentionally removed from the available...

Dev Studio 3.9.0 does not start up with macOS Big Sur

legacy Troubleshooting

Issue Due to an issue with the bundled version of Eclipse, Dev Studio 3.9.0 on macOS Big Sur fails to start up, showing an error message "Alert: Failed to create the Java Virtual Machine." Environment Dev Studio 3.9.0 Resolution A future Dev Studio release will have the updated Eclipse...

Liferay DXP 7.0 Theme Generator installation fails with Missing required argument #1 | EMISSINGARG

legacy Troubleshooting

Issue While following the Liferay documentation about 7.0 DXP theme building with the Theme Generator, the following error will be thrown on Terminal when running npm install -g yo gulp: npm ERR! Windows_NT 10.0.17134 npm ERR! argv "C:\\Program Files\\nodejs\\node.exe" "C:\\Program...

Can I use the Target Platform BOM to include the correct biz.aQute.bndlib version?

legacy Troubleshooting

Issue When using the Target Platform functionality in a Liferay Workspace (to use the dependencies from the target version's BOM) to try to include the biz.aQute.bndlib in a 7.2 dxp-5 custom module, it fails to compile. This used to build without issue in earlier versions of Liferay. The...

nodejs download fails due to invalid link

legacy Troubleshooting

Issue Customers may encounter failures using Gradle v.4 + Workspace. Here is the relevant stacktrace exception: > Task :downloadNode FAILED Trying to download http://mirrors.lax.liferay.com/nodejs.org/dist/v10.15.1/node-v10.15.1-linux-x64.tar.gz to...

SOAP service list API is exposed to non-authorized guest users

legacy Troubleshooting

Issue SOAP service list API found at http://[host]:[port]/api/axis is exposed to external guest users even with it configured to display locally only. The following property is set in portal-ext.properties: axis.servlet.hosts.allowed=127.0.0.1 Environment DXP 7.2, DXP 7.1 Resolution To...

Headless API returns 20 entries on certain GET methods

legacy Troubleshooting

Issue Headless API only displays 20 entries on certain GET methods Environment Liferay DXP 7.4 Resolution The resulting 20 records is because of the default pageSize value. If you would like to adjust the number of records that are returned, please adjust the pageSize to a higher value...

Unable to define the searchable option with new objects fields

legacy Troubleshooting

Issue Unable to configure the searchable options of new fields added to an object after it has been published. Steps to reproduce: Create an object: 'Pets' Add a new field: 'petName' (Text, indexed as text) Publish the Pets object definition Try to add a new field: description Observed...

Unable to Publish Object Definition Relationships after Importing

legacy Troubleshooting

Issue The user is not able to publish Object Definition relationships after importing them Steps to reproduce: 1) Navigate to the Applications Menu -> Control Panel -> Objects 2) Import one Object Definition with a relationship 3) Public first Object Definition 4) Public the second one...

Not possible to add Custom Entry on page

legacy Troubleshooting

Issue Mapping with Custom Objects is not working on Pages Steps to Reproduce: 1) Menu > Control Panel > Objects 2) Create a Custom Object 3) Navigate to Custom Object and click on the Fields tab 4) Add a Custom Field (text) 5) On details, publish 6) Go home 7) Navigate to Site Builder >...

Gradle build without internet connection

legacy

Issue How to build the Gradle workspace without an internet connection? Steps to run the gradlew command using offline mode Environment Liferay DXP Resolution We have improved the offline support in the most recent release of the DevStudio, however, all of our build tools (Gradle or...

Troubleshooting java.lang.NoClassDefFoundError and java.lang.ClassNotFoundException Optional Dependency Errors

Troubleshooting

Issue When starting up Liferay, the following errors are observed: java.lang.NoClassDefFoundError or java.lang.ClassNotFoundException. Environment Liferay DXP with deployed custom modules including optional dependencies. Resolution Review the deployed MANIFEST.MF inside the module or the...

Traces from custom module stop printing after redeploy

legacy Troubleshooting

Issue A custom module prints traces the first time it's deployed but not if redeployed. After restarting Liferay it works again. Environment Quarterly Release 2023.Q3, 2023.Q4, 2024.Q1 Liferay DXP 7.4 Resolution This can happen if the configuration file module-log4j.xml uses an element...

Blank Objects page after enabling Object Model Builder

Troubleshooting

Issue We enabled Object Model Builder in the Beta Feature Flags, and when we open the Object menu, we get a blank page We also get an error in the browser console: TypeError: Cannot read properties of undefined (reading 'externalReferenceCode') If we disable it, the menu opens correctly...

Liferay IDE / Developer Studio support for Quarterly Releases

legacy Troubleshooting

Issue When importing a Quarterly Release workspace into Liferay Developer Studio 3.9.8: Latest blade templates or Liferay versions will not be available for selection. Contextual menus could be broken and this kind of errors could be raised: java.lang.IllegalArgumentException: invalid...

Form is not showed to guest (unauthenticated) users

legacy Troubleshooting

Issue We have a form, based on a custom object, in a page. This form is not showed when user is not logged in. Whereas the form is showed when user is logged in. Environment 2024.Q1 Resolution Check if the 'guest' user has 'Add Object Entry' and 'View' permissions assigned on the form's...

NoSuchFileException: null/override error when starting Liferay or executing the Upgrade Tool

legacy Troubleshooting

Issue Right after starting Liferay or executing the Upgrade Tool, there a NoSuchFileException: null/override error in the log. 2024-04-01 15:44:08.392 ERROR [main][DBUpgrader:110] null java.lang.RuntimeException: java.nio.file.NoSuchFileException: null/override at...

Adding new entity to an already deployed service builder module fails

legacy How To

Issue The issue occurs while updating/adding a new column to the existing database custom table i.e. using Service Builder to add another entity in an existing module. Environment Liferay Developer Studio Liferay DXP 7.4 Resolution To add new columns to existing tables using the...

API Response for commerce products with relationships does not contain manufacturerProducts nested fields

legacy Troubleshooting

Issue Steps to reproduce: 1. Create a Minium site (so that you have products generated). 2. Create a new object "manufacturer" (I set it to company scope, and to appear in Applications/Content - "Panel Link"). 3. I added a field "name" to it. 4. I created a one-to-many relationship with...

Can I sort Liferay object entries in alphanumeric order?

legacy

Issue After sorting by the field name in ascending alphanumeric order, the results are currently sorted lexicographically. Environment Liferay DXP 7.4 Liferay Quarterly Release Resolution This is the expected behavior. By default, Liferay sorts text fields lexicographically. To achieve...

BaseUpgradeServiceModuleRelease not available in 7.4 anymore, is there a replacement class?

legacy

Issue The class BaseUpgradeServiceModuleRelease was previously available in 7.3 and below and is used as a start/stop method to override and be used as a service tracker. Environment DXP 7.4+ Resolution This class is no longer available in 7.4. The...

Accessing Glowroot through the Liferay url returns a 404 error after updating from 2023.Q4 to 2024.Q1

legacy Troubleshooting

Issue Error 404 occurs when accessing Glowroot through Liferay at /o/glowroot/ after migrating from version 2023.Q4 to 2024.Q1 Error in logs: 2024-04-11 12:51:40.306 WARN [http-nio-8080-exec-46][code_jsp:161] {code="404", msg="/glowroot/", uri=/o/glowroot/} Environment 2024.Q1...

EXT module override is not being applied in 2023.Q3.3+ from ${liferay.home}/osgi/marketplace/override

legacy How To

Issue Adding an EXT module override in ${liferay.home}/osgi/marketplace/override no longer functions. Environment Liferay DXP Quarterly Release 2023.Q3.3 and later releases Resolution To workaround this behavior for the time being please use the following steps: Rename the module that...

liferay-module-config-generator as a dependency

legacy

Issue As a developer, should I add liferay-module-config-generator in the block dependencies or in the block devDependencies? Environment Liferay DXP 7.1 Resolution This module is thought to be used in the block devDependencies in order to be executed at build time. Additional...

Unable to build the module: Could not find com.liferay.portal:release.dxp.api errors

legacy Troubleshooting

Issue Sometimes users face the following error while building their modules: Task modules: test-search-results-limit:compileJava FAILED FAILURE: Build failed with an exception. what went wrong: Execution failed for task ':modules:test-search-results-limit:compileJava'. > Could not...

Unable to add custom object using collection display

legacy Troubleshooting

Issue Steps to reproduce: 1. Go to Control Panel > Object 2. Create a new Object O1 3. Click on Object > Account98 4. Go to tab relationship 5. Create a relationship "O1 rel" type "One to many" with custom object O1 6. Go to O1 object definition and check true "Show Widget" 7. Create a...

View Display Page for Objects is not working for guest users

legacy Troubleshooting

Issue When creating a Display Page Template to display entries of an object, even when setting the viewing permission to "guest," attempting to access the page template results in a 404 page. Environment Liferay DXP 7.4 Resolution To resolve this behavior, open a help center ticket to...

Could not install Gradle distribution

legacy Troubleshooting

Issue While importing workspace from one system to another through a remote desktop connection, the below error has been encountered: Could not install Gradle distribution from 'https://services.gradle.org/distributions/gradle-6.6.1-bin.zip'. sun.security.validator.ValidatorException:...

'ConfigurationProviderUtil cannot be resolved' after upgrading

legacy Troubleshooting

Issue We've begun updating to the dxp:2023.q4.4 version and encountered the following error while building the code on the 2023.Q4.4 baseline:...

Object Entries do not appear in Search Results

legacy Troubleshooting

Issue Object entries are not visible in Search results Environment Liferay DXP 7.4 Resolution When you create an Object Definition, you get to choose whether its scope is Company or Site (you cannot change it once you publish the Object Definition). By default, when you create a search...

ObjectFieldNameException$MustNotBeDuplicate when updating Object Definition

legacy Troubleshooting

Issue When trying to update an object definition from one environment (eg. dev) to the other (eg. uat), the process fails with the following error: com.liferay.object.exception.ObjectFieldNameException$MustNotBeDuplicate: Duplicate name objectFieldName at...

Liferay Artifact missing from Maven Repository

legacy Troubleshooting

Liferay Support does not recommend or endorse specific third-party products over others. The information provided about products not created by Liferay is for reference purposes only, and any implementation of these principles will be at your team's discretion. Issue Liferay Artifact...

Service Builder Tool 1.0.478 gives "Unable to parse package path from..." Error in Windows

legacy Troubleshooting

Issue After cloning https://github.com/liferay/liferay-blade-samples.git, Windows OS users may run into the following error: Task :apps:service-builder:basic:basic-service:buildService FAILED Building Foo Unable to parse package path from...

How to filter Objects entry with picklist's name in filter

legacy

Issue I have created 2 picklists, e.g. picklist1 and picklist2. And I created 1 object where I create 2 fields of type picklist and I mapped this to above picklists. Now I have added an object entry. Picklist values are stored as {"key": "demo", "name": "Demo"}. Now when I try to apply...

Missing Parameters Format in JSONT File when using Data Migration Center

legacy Troubleshooting

Issue Facing an issue with the missing parameters in the JSONT format file when using the "Data Migration Center" portlet. Batch Client Extension only supports the "JSONT" file format. After generating the "JSONT" file for Object Entry, the generated JSONT file doesn't have the few...

Unable to PATCH a DateTime field in an Object back to Null

legacy Troubleshooting

Issue The PATCH API request to change a DateTime field value in an Object back to Null does not work as expected. The value of the DateTime field is not changed, it remains the same. Environment Liferay DXP 7.4 Resolution The observed behavior is a known issue addressed by LPD-17928....

How to Generate SAML Tracer export for Liferay Support

legacy How To

SAML Tracer can be a useful debugging tool for viewing SAML messages sent through the browser during single sign-on and single logout and helps with analyzing both SP- and IdP-initiated SAML flows, including viewing and exporting SAML requests and responses in various browsers. It is a...

Unknown publisher issue when installing Liferay developer studio

legacy

Issue When installing the Liferay Developer Studio on a Windows machine, it shows the unknown publisher. It is not showing the authorized publisher. Environment Liferay DXP 7.4 Liferay Developer Studio Resolution Liferay Developer Studio observed the behavior, which is considered a...

Possibility to change Friendly URL automatically generated in Objects

legacy

Issue The official Liferay documentation comments that when creating an object, displayed through a Display Page Template, an automatic URL is generated with the following syntax: "{domain}/l/objectEntryId" I would like to know if it is possible to change the information in this friendly...