Subscription Services provides general guidance and documentation on the installation of Liferay Digital Experience Platform, Liferay Portal EE, and Liferay Commerce ("the product") on the application servers, database servers, operating systems, JDKs, cloud services, and browsers listed on the Liferay version-specific Compatibility Matrix. If there are any reproducible and unintended issues encountered while installing Liferay software in a compatible environment, and a Liferay product defect is found, then Liferay will seek to resolve the issue via patching or configuration changes according to the product service life policy. It's the customer's responsibility to configure any settings and values specific to the customer's environment (e.g., performance tuning). Information on configuring for high availability can be found in the Clustering and High Availability and the Third-Party Configuration coverage articles.
Application Servers
Defining Coverage
- Subscription Services will provide guidance on deploying the product to the application servers listed in the Compatibility Matrix.
- Liferay seeks to resolve issues with the product when executed on a compatible application server. However, issues with the application server itself will be handled by the application server's vendor.
- If a verified security issue with the product is unique to an application server listed in the Compatibility Matrix, then Liferay will provide a hotfix, fix pack or service pack that addresses the issue.
- Assistance for application server functions are addressed on a case-by-case basis. However, the nuances of all compatible application servers aren't an expertise of Subscription Services, and our assistance will be limited.
Compatible Versions
- Liferay software is compatible with all minor/patch versions of the application server versions listed in the Compatibility Matrix.
- Liferay only assures compatibility with application servers that are supported by the third-party vendor.
- The only exception is Glassfish, which isn't currently supported by the third-party vendor.
- Liferay won't assure compatibility with any application server version in beta.
- Liferay seeks to provide resolutions to defects within the product when utilizing a specific application server. Subscription Services will be unable to resolve issues if the root cause is within the code of the third-party application server.
- Liferay only assures compatibility with application servers that are within their product lifecycle. Once an application server has reached the end of its lifecycle, assistance is provided on a case-by-case basis.
- Liferay does not test the compatibility of clustered application servers. As long as the external application maintains coherence and Liferay can interact with the application as a single unit, Liferay Software should operate without loss of functionality. If any issues pertaining to clustered application servers are reported, those issues will only be tested and verified in a single node environment.
Bundles
Liferay provides bundles of the product with some of the open source application servers available in the Compatibility Matrix. The bundles provided by Liferay are tuned for minimal impact to the local server. Subscription Services is not required to update the version of the application server bundled with the product. When using these bundles for development, testing or production, you must adjust the application server to your business requirements. Please consult your application server's documentation for instructions on this.
Specific Application Servers
Some compatible application servers have policies, features or settings that may be incompatible with the product. For more detail, please review the support coverage of each compatible application server. Application servers found on the Compatibility Matrix, but not listed below, do not have specific policies associated with them.
Databases
Defining Coverage
- Subscription Services seeks to ensure that the product can connect to and use a compatible database to store and retrieve data.
- Liferay seeks to resolve any issues with the product when connecting to each compatible database. Issues with the database application itself must be handled by that database's vendor.
- Subscription Services will provide guidance on connecting the product to a compatible database that the product can use to store Liferay data.
- Liferay isn't responsible for data loss or corruption that results from manually manipulating the database's content, or improperly implementing customizations.
Compatible Versions
- Liferay software is compatible with all minor/patch versions of the major database versions listed in the Compatibility Matrix.
- Liferay only assures compatibility with database versions that are actively supported by a third-party vendor.
- Liferay does not assure compatibility with any beta versions of a database application.
- Once a database version reaches the end of its lifecycle, support is provided on a case-by-case basis.
Compatible Features
- Liferay assures compatibility with a database's native features as long as the logical structure of the product-created tables isn't modified.
- Liferay does not test compatibility with clustered database applications. As long as the the tables' logical structures aren't modified, and the replication is a native feature of the database application, the Liferay product should function without issue. If any issues related to a clustered database are reported, those issues will only be tested and verified in a single-node database environment.
- The product requires a UTF-8 character set for all features to operate correctly.
SQL Scripts
SQL scripts are available in the Downloads section of Help Center as part of the product source files. These scripts are designed for database administrators (DBAs) to create a product database while maintaining restricted application permissions. Certain product features (like deploying a new plugin) may require extended permissions and may be unavailable if database permissions are overly restrictive. The use of these scripts in any particular environment is at the customer's discretion.
Specific Database Applications
Some of the compatible database applications have specific policies associated with them and some features or settings may be incompatible with the product. For more details, please review the support coverage of each compatible database application. Database applications found on the Compatibility Matrix, but not listed below, do not have specific policies associated with them.
Operating Systems
Defining Coverage
- Liferay ensures that the product can be deployed and instantiated on the operating systems listed in the Compatibility Matrix.
- Liferay seeks to resolve any issues with the product when utilized on each compatible operating system. Issues with the operating system must be handled by the operating system's vendor.
- Subscription Services will provide guidance on deploying and instantiating the product with each compatible operating system.
- Subscription Services isn't required to provide guidance on configuring operating systems. This includes operating system features like services, firewalls, ports, user access and file management.
Compatible Versions
- Liferay software is compatible with all minor/patch versions of the operating system versions listed in the Compatibility Matrix.
- Liferay only assures compatibility with operating systems that are supported by a third-party vendor.
- Liferay does not assure compatibility with any operating system version in beta.
- When an operating system reaches the end of its lifecycle, support is provided on a case-by-case basis.
Specific Operating Systems
Some of the compatible operating systems have specific policies associated with them and some features or settings may be incompatible with the product. For more details, please review the support coverage of each compatible operating system. Operating Systems found on the Compatibility Matrix, but not listed below, do not have specific policies associated with them.
JDKs
Defining Coverage
- Liferay ensures that the product can be deployed and instantiated with a JDK listed in the Compatibility Matrix.
- Liferay seeks to resolve any Liferay product issues that arise when connecting to a compatible JDK. Issues with the JDK must be handled by that JDK's vendor.
- Subscription Services provides guidance on using the product with compatible JDKs.
Compatible Versions
- The product is compatible with all minor/patch versions of the JDK versions listed in the Compatibility Matrix.
- Liferay only assures compatibility with JDK versions still supported by their vendor. Once a JDK reaches the end of its lifecycle, support is provided on a case-by-case basis.
- Liferay does not assure compatibility with any JDK version in beta.
- Liferay only assures compatibility with Java Technical Compatibility Kit (TCK) certified JDK binaries.
- Only JDK major releases marked for LTS will be tested for compatibility with the product.
Cloud Services
Defining Coverage
- Liferay ensures that the product can be deployed and instantiated using the cloud service and can connect to the cloud service's database. Liferay ensures that the Liferay product can access the cloud service file system listed on the Compatibility Matrix.
- Liferay seeks to resolve any Liferay product issues that arise when used with a compatible cloud service. Issues with the cloud service must be handled by that cloud service's vendor.
- Subscription Services provides guidance on deploying and instantiating the product with a compatible cloud service.
- Subscription Services provides guidance on connecting the product to a compatible cloud service's database to store Liferay data.
- Subscription Services provides guidance on configuring the product to access a compatible cloud service's file system.
- The product is only compatible on a cloud service if each element in that cloud service's virtualized environment is also compatible with the product .
- Subscription Services isn't required to provide guidance on configuring cloud service specific features such as services, firewalls, ports, user access, and file management.
Liferay Provisioning and Cloud Services
The provisioning of the product is connected to the IP address or hostname of a Liferay product instance. In a cloud environment, the IP address or hostname of such an instance can change more frequently than in a physical machine. To ensure correct licensing of the product functions, please use Liferay Connected Services (LCS). Alternatively, configure your cloud service to have a static public IP address or static public hostname. The customer is responsible for configuring and maintaining these elements properly.
Specific Cloud Services
Some of the compatible cloud services have specific policies associated with them and some features or settings may be incompatible with the product. For more details, please review the support coverage of each compatible cloud service.
Browsers
Defining Coverage
- Liferay ensures that the product can be viewed with the browsers listed in the Compatibility Matrix.
- Liferay seeks to resolve any Liferay product issues that arise from connecting to a compatible browser. Browser issues must be handled by the browser's vendor.
- Subscription Services provides guidance on viewing the product with compatible browsers.
Compatible Versions
- The product is compatible with all minor/patch versions of the browser versions listed in the Compatibility Matrix.
- Liferay only assures compatibility with browser versions that are supported by the browser's vendor. Once a browser version reaches the end of its support lifecycle, as defined by its vendor, Liferay may provide support on a case-by-case basis.
- Liferay does not assure compatibility with any browser in beta.
- Liferay product issues reported for browsers marked as Limited in the Compatibility Matrix will be resolved on a case-by-case basis, as Liferay engineers determine such issues relate to core product functionality.
- Browser compatibility or quirks modes are not tested as compatible with any Liferay Products.
Specific Browsers
Some of the compatible browsers have specific policies associated with them and some features or settings may be incompatible with the product. For more details, please review the support coverage of each compatible browser. Browsers found on the Compatibility Matrix but not listed below do not have specific policies associated with them.