- What are the different types of activation keys?
- How do I obtain an .xml activation key for my Liferay DXP instance?
- What information do I need to provide to request an activation key?
- What is my Instance Sizing value?
- When do I need to request a new activation key?
- Are there any differences between Liferay DXP and Liferay Commerce activation keys?
- How do I deploy my activation key?
- I have my activation key but it's not working. What Should I do?
Q: What are the different types of activation keys?
Developer
Developer keys are intended for local developer workstations only and are limited to five (5) concurrent user connections. This means the Liferay DXP or Liferay Commerce instance can only serve minimal requests and cannot handle traffic beyond this limit.
Developer keys are complementary with the purchase of a Liferay Enterprise Subscription. There is no limit to the number of Developer key copies.
Server
Server keys are intended for a server environment that requires an unlimited number of concurrent user connections.
Server type activation keys are issued on an instance basis. Each installation of Liferay DXP or Liferay Commerce software (and, for clarity, each cluster node) will require one (1) activation key and is equivalent to 1 Liferay DXP or Liferay Commerce Instance.
Based on the environment, there are 2 types of server activation keys:
Physical or Virtual Server
- For instances when servers have static identifiers, such as a static IP address
Virtual Cluster
- For highly virtualized environments where server identifiers cannot be predetermined
Virtual cluster activation keys are used for activating both a cluster of multiple Liferay DXP instances, and also for activating a single instance. In this second scenario it can be referred to as virtual activation key.
Based on the server's designated purpose, there are 3 types of server activation keys:
-
Production
- Serves live user requests
-
Backup
- Does not serve live user requests
- Can be used in a Production setting for a limited period of time, while the Production system is not functioning
-
Non-Production
- Does not serve live user requests
- It serves testing or integration purposes
Q: How do I obtain an .xml activation key for my Liferay DXP or my Liferay Commerce instance?
You can manage your projects and activate your products through Liferay's Customer Portal. Please refer to the following video tutorials for the exact steps:
Check out more video tutorials and documentation to explore other Customer Portal features.
Q: What information do I need to provide to request an activation key?
Developer | Physical or Virtual Server | Virtual Cluster | |
Liferay Project |
X |
X |
X |
Liferay DXP Version |
X |
X |
X |
The Instance Sizing (*) associated with your subscription |
not applicable |
X | X |
For each Liferay DXP or Liferay Commerce instance, at least one of the following server identifiers:
|
not applicable |
X | not applicable |
The number of Liferay DXP or Liferay Commerce instances |
not applicable |
not applicable | X |
Q: What is my Instance Sizing value?
Instance Sizing is selected when purchasing Liferay DXP subscriptions, based on the project architecture and resource needs. It determines the allowed number of processor cores, CPUs or vCPUs accessible to the Liferay instance.
The number of Cores or vCPUs accessible by each Instance is as listed below:
Instance Sizing | Number of Cores or vCPUs that will be accessible by each Instance |
1 | Up to 8 |
2 | Up to 12 |
3 | Up to 16 |
4 | 17 or more |
Q: When do I need to request a new activation key?
New activation keys are free of charge, provided they are within the number and type of subscriptions purchased for your Liferay project.
You will need to request one or several new activation keys if you want to accomplish one of these tasks:
- Upgrade to a major version of Liferay DXP
- Add a new node to a Liferay DXP or Liferay Commerce cluster
- Extend a temporary activation key that is about to expire
-
In case of an activation key for physical or virtual servers:
-
Install a Liferay DXP or Liferay Commerce instance on a new server
- Applies to cases when the Production system is no longer available and there is no Backup instance already activated
- Migrate servers to a new environment
-
Install a Liferay DXP or Liferay Commerce instance on a new server
It is not necessary to request a new activation key if you need to:
- Upgrade to a new fix pack or service pack
- Upgrade to a major version of Liferay Commerce
- Temporarily replace the Production system with the Backup system
- Use a developer activation key to install a new instance or start up an existing one
- Previously generated Liferay DXP or Liferay Commerce developer keys can be used on any number of local environments
-
In case of virtual cluster activation keys:
-
Install a Liferay DXP or Liferay Commerce instance on a new server
- Applies to cases when the Production system is no longer available and there is no Backup instance already activated
- Decommission existing servers to migrate them to a new environment
-
Install a Liferay DXP or Liferay Commerce instance on a new server
Q: Are there any differences between Liferay DXP and Liferay Commerce activation keys?
For Liferay DXP 7.4 GA1+, all Commerce modules are enabled by default and ready for use. For DXP 7.3 FP3/SP2+, Commerce is activated using a portal property, while earlier versions use a Commerce activation key file. More details, please refer to Activating Liferay Commerce Enterprise.
For Liferay DXP 7.3 and below, activation keys for Liferay DXP and Liferay Commerce are very similar. The only difference is that Liferay Commerce activation keys are not version specific. The same activation key can be used on all Liferay Commerce versions.
On with Liferay DXP 7.3 and Liferay Commerce 3.0 (up until FP3/SP2), activation key on the same instance are required to be of the same type. For example, on the same instance you can use a Liferay DXP developer key and a Liferay Commerce developer key. However you cannot use a Liferay DXP production key and a Liferay Commerce developer key.
Q: How do I deploy my activation key?
You can deploy your activation key by following the instructions in this Knowledge Base article.
Q: I have my activation key but it's not working. What should I do?
As the next step, please review our Troubleshooting Activation Key Issues article or submit a ticket in Help Center for assistance from our Liferay Support team.