Site Search - Liferay Learn

How to use environment variables for passwords within OSGi config files

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

Blank screen when downloading a folder as a zip file from the document library, when the title contains special characters

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 When trying to download a folder containing special characters (for example, accents) in its name from the document library, a blank...

Show Number of Requests in Redirection > 404 URLs Tab

legacy Troubleshooting

Issue When I navigate to Site Administration > Redirection > 404 URLs, all URLs show 0 requests Environment DXP 7.3 Resolution For the 404 URLs Requests counter to track the number of views, View Count must be enabled in Control Panel > System Settings > Infrastructure > View Count....

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

How apply changes to Tomcat's server.xml file in Liferay PaaS

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 I need to make some changes in Tomcat's server.xml file, but don't know how to do it in a Cloud environment. Environment Liferay PaaS...

How to resolve a Jenkins "Failed to rotate logs" error when executing the Project Build Discarder

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 our -infra service's CI logging, we are seeing frequent errors such as the following: build-10 [ci-0] WARNING ...

Ext module is not deployed with the cloud deployment process

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 modules_ext style projects in workspace will correctly deploy to /build/dist/osgi/marketplace/override. However, for dockerDeploy...

Performance issue: Liferay service getting restarted frequently

legacy Troubleshooting

Issue Liferay service gets restarted frequently [every day or so], and status logs show readiness and liveness probes failing and causing the service to restart. Environment liferay-dxp:7.2-4.0.3 Resolution There can be multiple issues, one of them can be the use of...

How to resolve a "failed to 'KillContainer' ... context deadline exceeded" error observed in a Liferay PaaS service's status logging during deployment

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 Whenever we deploy a build (even if the image versions are not changed), we notice an "error killing pod" in the status logs of a...

Unable to send message: Could not convert socket to TLS

legacy Troubleshooting

Issue In Fix Pack 92 we add the mail.session.mail.smtp.starttls.enable property to the portal.properties file to successfully configure the outlook mail server. After installing this Fix Pack or a higher one you might receive the following error: 2021-01-18 20:39:05.590 ERROR [default...

How to resolve Jenkins builds no longer completing after GitHub user contact adjustments

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 After a user left our company (who had previously created a GitHub Personal Access Token (PAT), which we use to connect to our...

How do I implement a JNDI database connection on Liferay PaaS

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 Portal Administrators may require a connection to the database through a Java Naming and Directory Interface (following: JNDI)...

How to decide which Liferay DXP image from Docker Hub to use with 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 Now that the Liferay DXP image for a Liferay PaaS environment is set through the liferay/gradle.properties file in a 4.x+ workspace...

How to resolve Jenkins failing to build a service in Liferay PaaS with a non-zero exit value of 137

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 When attempting to build a Liferay PaaS service, our Jenkins builds are failing with errors like the following: * What went wrong:...

Liferay PaaS - DB user doesn't have super privileges for the database service

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 Liferay PaaS backup service will throw: ERROR 1227 (42000) at line XX: Access denied; you need (at least one of) the SUPER...

Is it possible to change how much memory Gradle uses during a Liferay PaaS build in Jenkins?

legacy How To

Issue Since our Jenkins builds are using Gradle Daemons, we would like to increase the memory available to control how much memory Gradle uses, so that it is increased from this default: org.gradle.jvmargs=-Xmx512m Environment Liferay PaaS Resolution This property can be adjusted by...

How-To Generate a HAR file for Liferay Support

HTTP Archive (HAR) files are a format used to track information between a user's browser and site. It can be used to identify performance issues such as slow load times, page renders, or other bottlenecks. This is due in part, because the file tracks the load of resources and how long...

Not able to download the logs of more than 10000 lines

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 to download more logs as the default "Download Logs" option is downloading only 10000 lines of logs? Environment Liferay PaaS...

How to generate the crt and key of a certificate on base64 for a custom domain on Liferay PaaS?

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 As stated on this documentation you'll need to add both the crt and the key on base 64 on the LCP.json file. { "id": "webserver",...

Taking Thread Dumps From a JVM

Liferay Support does not recommend or endorse specific third-party products over others. Liferay is not responsible for any instructions herein or referenced regarding these products. Any implementation of these principles is the responsibility of the subscriber. A thread dump is a...

Taking Heap Dumps From a JVM

legacy How To

Liferay Support does not recommend or endorse specific third-party products over others. Liferay is not responsible for any instructions herein or referenced regarding these products. Any implementation of these principles is the responsibility of the subscriber. When a system runs into...

High Priority Issue Checklist

legacy Troubleshooting

This article provides a brief checklist of items to run through when your server is frozen, or goes down entirely. Collecting this information before opening a support ticket is a significant step towards helping us to provide you with a quick resolution. Resolution To help our Support...

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

Avoiding Empty File Uploads in Documents and Media

Issue When uploading a file in Documents and Media, a form refresh (e.g., by changing the Document Type or triggering a metadata validation error) causes the selected file to be cleared from the input field. Despite the file no longer being attached, the form can be submitted. This...

Getting Bad Request When Using API Filter Parameter on User Object Field

Issue When extending a system object, such as the User object, with a custom object field (e.g., customID), attempting to filter user accounts by this custom field using the headless API results in an error. The API call looks like this:...

Production Backups Not Visible in Disaster Recovery Environment After Configuration

Issue After following the documentation to set up Cross-Region Disaster Recovery in Liferay PaaS, the backups from the primary (production) environment are not visible in the secondary (disaster recovery) environment. The UI in the DR environment's Backup service does not show the tab or...

How To Upgrade JRXML Liferay Commerce Order Templates

Issue Liferay Commerce upgraded its internal reporting engine to JasperReports 7, utilizing a new XML schema with a Jackson-based parser that renders older Jasper 6 JRXML files incompatible. How can I upgrade custom Commerce order templates to the JasperReports 7 standard to make my...

製品 API - 複数の SKU を持つ製品の作成

Official Documentation

Product API - Creating a Product with Multiple SKUs You can create products with multiple active SKUs using the product API or from the Products application. To create such a product, you must...

商品配信APIの基礎

Official Documentation

Product Delivery API Basics Product API Basics covers the admin API used for creating and managing products. To display product data in your storefront, you must use the Product Delivery API. Call...

ナレッジベースAPIの基本

Official Documentation

Knowledge Base API Basics You can Create Knowledge Base Articles and Manage the Knowledge Base with Liferay's Knowledge Base app, but you can also use Liferay's REST APIs. Call these services to...

WebコンテンツAPIの基本

Official Documentation

Web Content API Basics Using Liferay DXP REST services, you can create and manage structured content on your site. Structured content refers to web content articles that use a web content structure...

カテゴリーとボキャブラリAPIの基本

Official Documentation

Categories and Vocabulary API Basics Liferay's REST APIs provide services for Liferay's categories and vocabularies functionality. You can create and edit vocabularies with the API. You can also...

ブログAPIの基本

Official Documentation

Blog API Basics Liferay's REST APIs provide services for adding, modifying, and deleting blog posts and images. Liferay DXP 2024.Q4+/Portal GA129+ The Blogs API now uses External Reference Codes...

タグAPIの基本

Official Documentation

Tags API Basics Liferay's REST APIs provide services for managing tags (referred to as keywords in Liferay's codebase). You can create, edit, and delete tags using the API. Start with an example of...

製品APIの基本

Official Documentation

Product API Basics You can manage products from the Applications menu, but you can also use Liferay’s REST APIs. Call these services to create and manage products. Adding a Product Then follow...

サイトコンテンツでの適用された画像の使用

Official Documentation

Using Adapted Images in Site Content Adaptive Media operates in the background to create multiple resolutions for images uploaded to Liferay DXP. When used in blogs, web content, or content pages,...

注文APIの基本

Official Documentation

Order API Basics You can manage orders from the Applications menu or with REST APIs. Call the headless-admin-commerce-order services to create and manage orders. Adding an Order Once Liferay is...

Search Results