Site Search - Liferay Learn

Embedding the Language Selector Widget in a Fragment

Issue Need to embed the Language selector widget in a fragment via tags similar to what is referenced here: https://help.liferay.com/hc/en-us/articles/360020757071-Embedding-Widgets-in-Page-Fragments Environment DXP 7.2 Resolution Please put below code in your header section of your...

Why is the category/tag selection not working at article creation?

legacy Troubleshooting

Issue While the user is creating a new article, he cannot select the categories or tags of the specific site. Environment Liferay Portal 6.2 Liferay 7.0+ Resolution In order to be able to select the categories the property json.web.service.enabled needs to have a true value. Please...

The Backup Service's restore functionality will not accept TGZ files in the file uploader

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue I am encountering the inability to upload a database or volume TGZ file using the Backup Service's restore functionality in the...

How can a Liferay admin set the article-Id manually?

legacy How To

Issue How can a Liferay admin set the article-Id manually? Environment Liferay 7.0 Liferay 7.1 Liferay 7.2 Liferay 7.3 Resolution Start a vanilla Liferay bundle. Navigate to Control Panel --> Configuration --> System Settings --> Web Content --> Administration. Uncheck the option...

Why was my custom domain rejected by Liferay PaaS?

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue Why was my custom domain rejected by Liferay PaaS? Environment Liferay PaaS Resolution If you have configured your domain but Liferay...

Using Zapier to Sync Object Data with Google Sheets

How To

Introduction You can use Liferay Objects with data integration tools to create automated tasks for syncing Object data with external services. These tasks are triggered using webhooks and can connect to Google applications, Microsoft Office, and more. This recipe guides you through the...

Designing and Displaying Reusable Navigation Menus

How To

Navigation menus for a site are typically tied strictly to a site's page hierarchy and structure. The Navigation Menus feature in Liferay is powerful because it enables you to create navigation menus that are decoupled from a site's page hierarchy. Liferay navigation menus can be driven...

Integrate Okta with Liferay DXP using OpenID Connect

How To

Introduction This recipe guides you through the steps to integrate Okta, your Identity Provider (IdP), with your Liferay environment using OpenID Connect. Prerequisites Okta Dev account Liferay DXP environment Administrative access to Okta Admin Console Administrative access to Liferay's...

Building Multi-Step Business Forms

How To

Introduction This recipe guides you through the basic steps to build a multi-step form. Prerequisites Liferay DXP environment An object definition with fields A user who has access and control to create and manage objects, display pages, and the ability to edit pages Steps Open the...

How to prevent a full day event from displaying on two days in the calendar's month view

How To

Issue When creating an all-day event that spans from 12:00 AM on one day to 12:00 AM on the next day, the event appears on both days in the calendar month view. How can I ensure the event is only visible on the first day? Environment Liferay DXP 7.4+ Resolution In the example, the event...

The "Menu Display" text appears in the Navigation Menu widget

Troubleshooting

Issue After a failed login attempt, the navigation menu's display text appears above the menu itself. Steps to reproduce: Create a site. Create a login page and deploy the sign-in widget. Create a navigation menu. Create a master page template and deploy the navigation menu on the master...

How to deploy a custom JAR to the shielded-container-lib directory in my PaaS Environment

How To

Issue I would like to know how to deploy a custom JAR to the shielded-container-lib directory of Tomcat in my PaaS environment. Environment Liferay PaaS Resolution Follow these steps: In your Liferay Workspace, create the following directory structure:...

"Could not resolve value from secret references" error deploying build in PaaS

Troubleshooting

Issue When deploying a build in my Liferay Cloud PaaS environment, the build process fails and returns the following error message: Some error has happened during the build. Try again. [{"message":"Could not resolve value from secret references","name":"Error"}]. Environment Liferay PaaS...

How can I disable the Commerce Wish List creation

How To

Issue I have an issue with the commerce wish list table in the database. The table has lots of entries and it is growing more, even though we do not use the wish list feature. I would like to remove these entries and disable the creation of the wish lists. Environment Liferay DXP 7.1+...

Limit the languages displayed in the translation selector for object fields

Issue We want to limit the languages displayed in the translation selector for object fields to only those defined in the site, similar to how it works for Journal Articles. Currently, the selector shows all languages available in the environment. Environment DXP 7.4 Resolution Limit the...

Sorting Structures by Name in Liferay DXP

Troubleshooting How To

Issue The order of Structures when creating Web Content seems to be random. The structures are not sorted alphabetically or by modification date. Environment Liferay DXP 2024.Q2 Resolution Web Content Display widget Go to Control Panel > Instance Settings > Content and Data > Web Content...

Restricting the Guest Role's Access to the Home Page

Troubleshooting

Issue When trying to change the view permission of a page it's not possible to do it for the Guest role in the first page: it shows as non-interactive. Environment QR 2024.Q3, 2024.Q4, 2025.Q1 Resolution This is the expected behavior for the guest site in a given instance. For the guest...

How to Compare Between Versions When Using Workflow

Issue Is it possible for a reviewer to compare both the Old and New versions when a user makes changes and resubmits for workflow approval in Web Content, Document & Media, and Commerce Products? Environment Liferay DXP 7.4+ Quarterly Release Resolution Web Content: Web Content allows...

How to allow unauthenticated (guest user) requests for GraphQL

Troubleshooting

Issue I implemented ReactJS Widget that relies on GraphQL requests for custom object values, with a widget exposing object entries to the public. However, unauthenticated GrapQL requests are disabled by default and guest users cannot see the widget content. Is there way to enable GraphQL...

Add New Custom Domains and Avoid Downtime while Let's Encrypt certificate Is Generated

legacy Troubleshooting

Issue When new custom domains are appended to to the existing list under "customDomains" in the "certs" part of the webserver LCP.json file, a new Let's Encrypt certificate is issued to include them. In the mean time the old domains will appear as having no current certificate. Is it...

How to clear the data folder of Glowroot in Liferay PaaS

legacy How To

Issue How to clear the data folder of Glowroot in Liferay PaaS. Environment Liferay DXP 7.4 Liferay PaaS Resolution To clear the data folder through the Glowroot UI. Follow the below steps: 1. Visit the site and log in. 2. Append /o/glowroot to the end of the site’s URL. For example, if...

Impersonated user is unable to add items to the cart

legacy Troubleshooting

Issue When impersonating a user with permissions to add items to a cart, a message is seen in the UI, which says: “Danger: [object Object]” and the items do not get added to the cart. This behavior can be seen by following these steps: Create two users, one as User One...

Google Drive authentication randomly fails in a multi-node cloud environment

legacy Troubleshooting

Issue Google Drive authentication usually works correctly, but sometimes it randomly fails with java.lang.IllegalStateException: Authorization oAuth2State not initialized errors in the logs. Google Drive was linked to the environment correctly following the official documentation. My...

How to Customize Webserver Log Format

legacy How To

Issue How can I customize the log format of the webserver service? Environment Liferay PaaS Resolution To tailor the log format of your webserver service to your specific needs, you can adjust the following environment variable: LCP_WEBSERVER_LOG_FORMAT Additional Information Web Server...

Keep-alive setting for VPN

legacy

Issue What is the default keep-alive setting for the Liferay Cloud VPN client? Environment Liferay PaaS/SaaS VPN client-to-site VPN. Resolution PaaS/SaaS VPN Client: Uses standard Strongswan keep-alive configuration, typically 20 seconds. VPN Server: Will define its own custom keep-alive...

How to generate a valid Liferay SaaS/PaaS Custom SSL Certificate

legacy

Issue What are the specific requirements for a custom SSL certificate to be successfully deployed on Liferay SaaS/PaaS? Environment Liferay SaaS / PaaS Resolution Private key and certificate should be in the proper PEM format which must include encapsulation boundaries. Private key...

How to have multiple Jenkins account in Liferay PaaS

legacy

Issue Is there any possibility of having multiple Jenkins accounts for the build process and deployment in the environment so that would be able to track who initiated the Jenkins build or who started the build? Environment Liferay PaaS Resolution It is possible by creating the number of...

Accessing HTTPS services through VPN Connection

legacy Troubleshooting

Issue Multiple security/certificate/host errors can occur when trying to access an internal HTTPS service through a SaaS/PaaS VPN connection. Environment Liferay PaaS/SaaS client-to-site VPN connection. Set up port forwarding to a HTTPS service. (e.g. vpn:1000 → 10.10.10.10:443)....

When accessing Web Content after a restoring to a backup, the following message is seen: "Result Found With Filters Type: Versions"

legacy Troubleshooting

Issue After restoring to a backup, when looking Content and Data > Web Content it displays the following message: 1 Result Found With Filters Type: Versions Environment DXP 7.4 Resolution When a Web Content Article is created and a restore to a backup where the article did not yet...

How to resolve multiple Iframe authentication requests in a clustered environment

How To

Issue After including an iframe link in a third-party application for our clustered Liferay environment (and already setting the appropriate X-Frame-Options), users are experiencing repeated authentication prompts even though they are already logged into Liferay. In the browser console,...

How to increase Google cloud CDN caching time

legacy

Issue How to increase the Google Cloud CDN cache timing max-age= 3600(1 hr) to 1 day. Environment Liferay PaaS Resolution The default CDN caching involves the caching timing limited to 1hr(CLIENT_TTL and DEFAULT_TTL) The Google Cloud platform uses CLIENT_TTL to control CDN behavior. As...

Liferay PaaS - Builds are triggered from multiple branches when pushing one branch

legacy Troubleshooting

Issue In Jenkins, we are seeing how builds are triggered from multiple branches when there is a single push to one branch. This seems related to branch indexing and Jenkins multibranch pipeline. What can we do to tackle this? Environment Liferay PaaS Resolution In some cases, this kind...

(Cloud) Spring Boot Client Extension fails with [invalid_token_response] An error occurred while attempting to retrieve the OAuth 2.0

legacy Troubleshooting

Issue We have a Spring Boot extension client that interacts with the Liferay APIs and that makes the OAuth2 challenge via OAuth2AccessToken oAuth2AccessToken = liferayOAuth2AccessTokenManager.getOAuth2AccessToken(clientRegistrationId); When we launch the Spring Boot application via...

Public access of database

legacy

Issue How users can enable public access to the database of their PaaS environment Environment Liferay self-managed (LXC-SM) Resolution Enabling even read permissions to the database is a huge security risk. However, if the goal is to monitor the queries for possible performance issues,...

Block the traffic based on the regions

legacy How To

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue Is it possible to block the request on the site based on the regions? Environment Liferay PaaS Resolution NOTE: The following...

How to redirect users accessing www.mydomain.com to mydomain.com in my PaaS environment?

legacy How To

Issue We need to implement a rewrite rule that change the URL in a client request from www.mydomain.com to mydomain.com. How should we proceed to configure this in our PaaS environment? Environment Liferay PaaS Resolution WARNING! The below solution represents only a hint. Portal...

Blocked:origin errors are seen when deploying Spritemap CX

legacy

Issue Blocked:origin errors are seen in the browser console when deploying Spritemap CX. Theme SVG Spritemap is showing blocked:origin errors in a SaaS environment. Environment Liferay PaaS, SaaS Resolution Observing browser console (blocked:origin) errors is expected behavior. As long...

Liferay Cloud Alert Emails

legacy

Issue I want to know all the type of email alerts sent by Liferay Cloud. What are the different kinds of real-time alerts I can receive from DXP Cloud? Environment DXP Cloud: Liferay PaaS, Liferay SaaS Resolution Possible email alerts sent by Liferay Cloud services are as below: Scaling...

Build Failure Due to Duplicate Client Extension ID

legacy Troubleshooting

Issue When attempting to build the Liferay project, the build fails with the following error message: > Task :client-extensions:liferay-sample-custom-element-1:validateClientExtensionIds FAILED FAILURE: Build failed with an exception.* What went wrong: Execution failed for task...

Configuring an external Web Application Firewall (Akamai) in PaaS

legacy

Issue How to configure an external Web Application Firewall (Akamai) in PaaS? Environment Liferay DXP 7.4 Resolution Configuration of the external Web Application Firewall (Akamai) with Liferay Cloud comes under a third-party application and Liferay Support is limited in assisting with...

Storage details are not available in plans and usage page

legacy Troubleshooting

Issue When we try to check storage usage for the Cloud project under Plans and Usage, we do not receive any information in the storage section. Environment PaaS, SaaS Resolution Storage use details are not currently available on the Plans and Usage page. Please open a Help Center ticket...

Dump of a Single Table from Liferay Database in PaaS

legacy

Issue How we can take the dump from the Liferay database of a particular table? Environment Liferay DXP 7.4 Resolution The Liferay DXP Cloud product doesn't offer such a possibility to take the dump of a single database table. You can only backup (and restore) a full database dump,...

Additional user who can read the log file for the build in Jenkins (PaaS)

legacy

Issue An additional user in Jenkins is required (other than the default one with user ID 'customer') who can read the log file for the build. Environment Liferay DXP 7.4 Resolution The CI service (Jenkins) is currently built to meet all of the existing needs and use cases. However, there...

Builds fail due to org.jenkinsci.plugins.github_branch_source.ApiRateLimitChecker$RateLimitCheckerAdapter checkRateLimit

legacy Troubleshooting

Issue Jenkins is failing while creating the DXP cloud build and the following errors are observed: ERROR: org.jenkinsci.plugins.github_branch_source.ApiRateLimitChecker$RateLimitCheckerAdapter checkRateLimit ERROR: LocalChecker for rate limit was not set for this thread. Configured using...

SSL errors when configuring a private repository in Liferay PaaS

legacy Troubleshooting

Issue You are using a private repository and while trying to configure it for the CI service you notice the webhook is not automatically created Also the following logs are shown in the INFRA environment Aug 13 16:11:14.665 build-6 ci[ci-0] [DXP Cloud] The value set for...

ElasticsearchStatusException: Action/metadata line [1] contains an unknown parameter [_type]

legacy Troubleshooting

Issue When upgrading our Cloud Stack, we have found a problem with the Search Service. The following error is shown in the logs: Caused by: java.lang.RuntimeException: ElasticsearchStatusException[Elasticsearch exception [type=illegal_argument_exception, reason=Action/metadata line [1]...

HTTP Security Headers Missing on 404 pages

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue While adding the below security headers in nginx.conf file of the web server: add_header Referrer-Policy "no-referrer"; add_header...

Remove the Site Name and Portal Name from the Browser Title

legacy Troubleshooting

Issue While hovering the mouse on a browser tab of any page, it displays the "Page Name - Site Name - Portal Name". How to remove the Portal Name part from it? Environment Liferay DXP 7.4 Resolution Create the...

'Backup "undefined" not found' when trying to restore a db dump in another environment

legacy Troubleshooting

Issue I have performed a backup in one env (for example, DEV), and I want to restore it in another env (for example, PRD). When I try to do that, the result is not successful. In the logs, this error is shown: [ERROR] Error: Backup "undefined" not found at lookupBackup...

When logging into Dynatrace I cannot see my hosts

legacy Troubleshooting

Issue I log in to my Dynatrace Dashboard I see the message "You have no monitored hosts" Environment Liferay PaaS Resolution Make sure that the tenant is correctly configured. The tenant or environmentid (highlighted with yellow in the above picture) should be the same as...

The portal is not reindexing because Elastic Search has reached the maximum number of shards.

legacy Troubleshooting

Issue When attempting to reindex the portal, the process fails, and the following messages are displayed in the logs: Validation Failed: 1: this action would add [1] shards, but this cluster currently has [1367]/[1000] maximum normal shards open;]", Environment Liferay PaaS Resolution...

Creating and Editing a Web Content Structure in Partitioned DB Results in Error

legacy Troubleshooting

Issue Creating and Editing a Web Content Structure in a Virtual Instance in PaaS or a database partitioned environment results in an error like below ERROR [http-nio-8080-exec-1][BundleSiteInitializer:635] null com.liferay.portal.kernel.exception.SystemException:...

Why is Jenkins build failing with SynchronousResumeNotSupportedException?

legacy Troubleshooting

Issue We are facing an issue where the builds are failing and we are getting the below error: org.jenkinsci.plugins.workflow.steps.SynchronousResumeNotSupportedException: Resume after a restart not supported for non-blocking synchronous steps at...

How to redirect from HTTP to HTTPS domain

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 When user hits the 'http://example.com' it should be redirected to the 'https://example.com' URL. Environment Liferay PaaS Resolution...

Cloud Console email verification gives an invalid email error

legacy Troubleshooting

Issue When I click on the Accept Invite link in the email to verify my email address to access the DXP Cloud Console, I receive the following error: Invalid email. How can I log in? Environment Liferay SaaS Liferay PaaS Resolution This is likely due to some characters that are in your...

Can Liferay be affected by the CrowdStrike Falcon Agent Issue?

legacy

Issue There has been an issue impacting Azure Virtual Machines running Windows Client and Windows Server with the CrowdStrike Falcon agent recently The issue begain around 19:00 UTC on July 18, 2024 and cauess affected VMs to encounter a bug check (BSOD)and become stuck in a restarting...

Liferay PaaS - How many custom SSL Certificates can we use?

legacy

Issue We want to upload our own custom SSL Certificates. How many custom certificates can we add? Environment Liferay PaaS Resolution As documented in Network Configuration for PaaS, you can upload maximum 14 of your own certificates. This is a hard limit imposed by the service...

Backup doesn't have permissions to open the Document Library

legacy Troubleshooting

Issue Backups fail with these log messages: rsync: [generator] opendir "/mnt/prepare-restore/document_library" failed: Permission denied (13) cannot delete non-empty directory: document_library rsync error: some files/attrs were not transferred (see previous errors) (code 23) at...

Unable to configure Liferay to use Okta groups for authorization due to missing Feature Flag

legacy Troubleshooting

Issue While trying to configure Liferay to use Okta groups for authorization when following the instructions here, Importing User Groups’ Memberships from an External IDP through SAML, there’s a mention of a Feature Flag, however it is not possible to know which one it is. Environment...

How much time does it take for a new SSL Certificate to be updated in Liferay PaaS?

legacy Troubleshooting

Issue User has updated their system with a new SSL certificate properly and the update is not performed immediately. Environment Liferay PaaS Resolution It takes around 30 minutes for a new SSL certificate to be ready. Additional Information If a certificate is being updated, please...

Search Results