Site Search - Liferay Learn

Configuring an external Web Application Firewall (Akamai) in PaaS

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...

Failed Loading the Jackson 2 API Plugin on Jenkins Build

legacy Troubleshooting

Issue After upgrading Liferay Cloud Services from v4 to v5, we encountered the following error relating to loading the necessary plugins with the Jenkins build. SEVERE: Failed Loading plugin Jackson 2 API Plugin v2.13.3-285.vc03c0256d517 (jackson2-api) Update required: JAXB plugin (jaxb...

How to properly scale up Search nodes?

legacy How To

Issue How to properly scale up Search nodes instead of deleting the Search service and deploying it again? Environment Liferay PaaS Liferay DXP 7.4+ Resolution Following the Liferay Cloud Upgrading to a High Availability Subscription documentation, which also describes the procedures to...

The search service exceed 80% of its allocated memory

legacy

Issue We sometimes see the following warning in the Cloud console: The search service exceeded 80% of its allocated memory. Environment Liferay PaaS Resolution The search service often presents high memory consumption, sometimes even using the entire container’s allotted memory, and is...

Mitigation Plan for Node Scale-Down Outages Affecting Non-HA Customers

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 In a non-High Availability (HA) environment, unplanned site outage occurs due to Kubernetes Scale Down event: Month Day 00:00:00.00...

No external access to database

legacy How To

Issue We need to make some modifications to the database, and therefore we have opened port 3306 of the database to be able to access it from outside, just as we have done many other times. However, this time we were unable to connect to the database with the correct credentials (copied...

Issue with the latest Dynatrace view

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 Unable to get the latest Dynatrace view with the new tenant ID. Snapshot of Dynatrace with new tenant ID Snapshot of Dynatrace with...

Deploying to an Existing Build via CLI Tool

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 The user wants to know if it is possible to deploy to an existing build using the Liferay Cloud CLI tool. The idea would be to use a...

Permissions missing after switching from SaaS to 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 The project has been switched over from a SaaS to a PaaS environment. My previous permissions in the cloud console are restored, but...

Blocking requests before reaching the WebServer on Liferay PaaS (Public Cluster)

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 We have encountered requests from unauthenticated sources on the webserver. Can these requests be blocked before reaching the...

Enable Masking on Personal Information Data in Liferay PaaS

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 We have a requirement to mask the PI (Personal Information) data in our database. Is it possible to install the mask-related plugin...

How do you access Dynatrace in UAT?

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 How can you access the Dynatrace Dashboard when the Advanced tab is missing from the Monitoring page in a UAT environment?...

What MySQL version is supported in Liferay Cloud?

legacy

Issue User wishes to know which MySQL version is supported in Liferay Cloud. Environment Liferay Cloud Resolution Currently MySQL 5.7 is supported in Liferay Cloud. Additional Information MySQL , content:...

Migrating Your Database to PostgreSQL

How To

Introduction Liferay adopted PostgreSQL as the default database for PaaS and SaaS projects in October 2024. Since then, all new Liferay PaaS and SaaS deployments use PostgreSQL. To maintain compatibility and ensure optimal performance, consider migrating your existing databases. This...

Liferay DXP Agent Fails to Start on Jakarta (Tomcat 10) Images with javax.annotation Error

Troubleshooting

Issue When using a Liferay DXP instance deployed on a Jakarta-based image (e.g., Tomcat 10), the liferay-dxp-agent bundle may fail to start. The logs will show an org.osgi.framework.BundleException error related to an unresolved package import. A key part of the error message will look...

How to use environment variables for passwords within OSGi config files

How To

Issue For security reasons, we would like to store passwords using environment variables within OSGi .config files. For example, to store the Elasticsearch server's password. Environment 7.3+ Resolution In Liferay versions containing LPS-123057, it is possible to use environment...

Deploys failing due to "requested flag is either misspelled or unsupported by this database type"

legacy Troubleshooting

Issue New deploys fails due to the database service and backup restores too Checking the database service logs you identify the following: INFO May 15 14:54:39.664 1904 database 75b864bd48-zzc6n [INFO] Instance status: available INFO May 15 14:54:44.856 1904 database 75b864bd48-zzc6n...

Deploying an EXT module on PaaS

legacy How To

Issue Deploying an EXT extension results in the extension being lost after the environment restarts. Environment Quarterly Releases 2023.Q3.3+. PaaS Resolution The use of EXT modules is discouraged. Please explore alternative extensions before proceeding, if possible. Starting from...

Path error for mariadb.jar

legacy

Issue Booting Liferay DXP 2025.Q1 we see in log file following error: May 22 11:37:49.551 build-3994 liferay[liferay-7c588c8bd4-mg686] [dxp] ERROR [main][StartupAction:68] Files [/opt/liferay/tomcat/lib/ext/mariadb.jar] in /opt/liferay/tomcat/lib/ext are no longer read. Move them to...

Permissions error when restoring backup

legacy Troubleshooting

Issue We are trying to restore a PRO environment backup into DEV environment. And we see in the log several errors related to Document Library when decompressing: May 05 16:13:15.812 build-3964 backup[backup-844b699f58-226cc] INIT CONTAINER SETUP-BACKUP-VOLUMES: Changing owner and...

Advanced Tab in the Monitoring section on the Cloud Console is not showing up

legacy Troubleshooting

Issue The Advanced Tab does not appear in the Monitoring section on the Cloud Console Environment Liferay Cloud - PaaS Resolution LCP_PROJECT_MONITOR_DYNATRACE_TENANT and LCP_PROJECT_MONITOR_DYNATRACE_TOKEN variables are related to the Advanced Tab in the Monitoring section If these...

JS file caching

legacy

Issue How to enable the cache for the JS file? On each page refresh, all default JS is getting called, impacting site performance. Environment Liferay Paas Liferay Quarterly Release Resolution While refreshing the page, all default JS is getting called due to the Private - no...

nginx (HAProxy) からliferayへのリクエスト振り分けアルゴリズムについて

legacy

問題 Liferay PaaSにおいて、クライアントからのリクエストは Nginx -> HAproxy -> Liferayの流れで処理されるという認識です。 nginx (HAProxy) -> liferayの振り分け部分で採用されているアルゴリズムは何でしょうか。また、こちらのアルゴリズムを変更することは可能でしょうか。環境 Liferay PaaS, SaaS 解決ラウンドロビンを使用しております。 HAProxy からラウンドロビン形式でLiferayサービスへの通信のロードバランスを行う様、設定されております。補足：...

Liferay PaaS services stuck in "Deployment in progress" status

legacy Troubleshooting

ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。注：Liferay は、Liferay Experience Could オファリングの名称を次のように変更しました。 Liferay SaaS(旧 LXC) と Liferay PaaS(旧 LXC-SM)となりました。問題...

Permissions are requested for user Customer in Jenkins when Bitbucket is configured

legacy Troubleshooting

ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。注：Liferay は、Liferay Experience Could オファリングの名称を次のように変更しました。 Liferay SaaS(旧 LXC) と Liferay PaaS(旧 LXC-SM)となりました。問題...

Large files (20MB+) on Git repository become corrupted when deploying to Cloud

legacy Troubleshooting

ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。問題 [IMPORTANT] .gitattributes を削除すると、さらに問題が発生する可能性があることをご承知おきください。この記事は、このソリューションが以前に少なくとも一人の顧客と仕事をしたことがあることを考慮し、代わりに内部用に変更されました。...

Integrate Jenkins (CI Service) with Azure DevOps

legacy

ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。問題 LXCのContinuous IntegrationをAzure DevOpsに統合する方法 Environment LXC-SM（旧名称：DXPクラウド）解決策当社のLXC-SM（DXPクラウド）サービスでは、以下のOOTBインテグレーションに対応しています： GitHub...

shallow.lock': File exists errors

legacy Troubleshooting

ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。 NOTE: この記事は INTERNAL の記事であり、現在お客様にはご覧いただけません。この記事へのリンクは社内のコメントでのみ行ってください。問題一部のユーザーから、Jenkinsビルドのトリガー中に以下のエラーが発生したとの報告がある。 stderr: fatal: Unable...

Building and Deploying using the Liferay Cloud CLI

legacy How To

ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。この記事は内部限定の記事です問題 DXPクラウドCLIを使用したビルドとデプロイ環境への配慮 DXP クラウドスタック v3 決議 CIサービス(Jenkins)もコマンドラインから lcp deploy が起動されたときにトリガーされます。...

Changing the name of an existing environment

legacy

ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。問題環境管理者としては、既存の環境の名前をもっと便利な方法で変更したい - ゼロから作り直す必要はありません。環境への配慮 DXPクラウド決議新しい環境を作成する場合、基本的にはどのような名前でも設定できます - 環境管理者の要求に基づいて。...

To be able to access Liferay PaaS portal Database through DB client

legacy

ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。問題ローカルクライアントを介して Liferay Experience Cloud Self-Managed (SM) データベースに接続する方法 Environment ライフレイエクスペリエンスクラウド SM 解決策ここに回避策があります。...

Troubleshooting Missing OpenID Connect Login Option and OIDC "not requested or was removed" Errors

Issue The OpenID Connect option doesn’t appear in the Sign In (login) portlet; or, starting OIDC returns an “OpenID Connect was not requested or was removed” error. Environment Liferay DXP Quarterly Release: 2024.Q1+ Resolution If the Open ID connect button is not displayed in the login...

How can I add hyperlinks to an email template?

Issue I would like to replace a link, like [$PASSWORD_RESET_URL$], in an email template with hyperlink text, like ‘Click Here’. Environment Quarterly Releases Resolution You can configure a hyperlink through the HTML editing option. Navigate to Instance Settings > Email > Email Template...

Troubleshooting Unresponsiveness Caused by Batch Import Deadlocks

Issue After a period of activity, such as heavy content and object creation, the Liferay DXP instance becomes unresponsive. Symptoms include: Inability to accessible Liferay via browser or cURL requests, which eventually time out. Unresponsiveness after 2-3 hours of uptime, even if the...

How to View Previous Publication Dates for Web Content

Issue When editing a web content article that has a publication date set in the past, the Schedule Publication dialog appears with an empty date field. This behavior occurs for both newly created content scheduled for the past and for content that was created and published in a previous...

How to Access Nested Freemarker FieldSets in DXP 7.4+

Issue After upgrading to Liferay DXP 7.4+, FreeMarker templates appear to access fields within existing web content structures using different syntax than newly created web content structures. For example, older structures allow direct access to nested fields, while new structures...

How to delete site-scoped object entries on 2025.Q1.20 or 2025.Q1.21

Issue After creating site-scoped object entries, they cannot be deleted. Though company-scoped entries are unaffected, site-scoped entries are remaining even after: A success message being displayed in the Object Overview UI. A 204 response in the control panel. How can I delete these...

How to Resolve Jenkins Build "Content is not allowed in prolog" Errors

Issue When creating Liferay PaaS Jenkins builds, you may experience CI/CD pipeline build failures with errors relating to unresolved Gradle dependencies. For example: > Task :modules:your-module-name:compileJava FAILED [Fatal Error] dependency.pom:1:44: Content is not allowed in prolog....

How to add a certificate in Cacerts file in PaaS

How To

Issue What is the best way to add a new certificate for the Cacerts file to trust the response of a consumed API in Liferay Cloud (PaaS)? Environment Liferay DXP 7.4+ Resolution To ensure your security settings survive a reboot, the best approach is to move the certificates out of...

Troubleshooting 'Portlet is temporarily unavailable' Errors Caused by JSESSIONID in URLs

Issue When navigating our site, a ;jsessionid parameter is intermittently appended to the page URL. When this happens, portlets on the page fail to render, displaying a Portlet is temporarily unavailable error. This issue occurs when the session handling mechanism falls back to URL-based...

Search Results