Follow these steps to register your Liferay DXP server with LCS:
Ensure that you’ve completed the LCS preconfiguration steps.
Log in to lcs.liferay.com. This takes you to your company’s LCS project. If your company has multiple projects, from the menu to the right of the Dashboard tab select the project that’s getting a new server.
Select or create the environment in which to register this server. If you’re using LCS for activation, upon connection to LCS your server consumes an activation key from the subscription type assigned to the environment. Note that a subscription type can only be assigned to an environment when creating the environment. If you have sufficient permissions in your company’s project, you can create a new environment by selecting Add Environment.
Select the environment’s Registration tab. This is where you manage and download the environment’s token file, that registers servers in the environment.
In the Registration tab’s Services section, change the LCS service selections, if needed. Note that if you change the LCS service selections and there are servers already registered in the environment, you must regenerate the token file and use it to reconnect those servers to LCS. You’ll regenerate and/or download the token in the next step.
The selected services are enabled for all servers that connect to this environment. If Portal Property Analysis is selected, you can prevent LCS from analyzing specific properties. Enter them into the box that appears when you select Show Blacklisted Properties. Note that LCS doesn’t access security sensitive properties.
What you do now depends on what you did in the previous step:
- Changes to LCS service selections: Regenerate and download the token. Regenerating a token causes all servers using the old token to disconnect from LCS. You must reconnect them using the new token.
- No changes to LCS service selections: Download the token.
Place the token file in your server’s
[Liferay Home]/datafolder. Note that Liferay Home is usually the parent folder of the application server’s folder. If your server is running, it should connect to LCS in about one minute. If your server isn’t running, it connects to LCS on startup.
Celebrate! Your Liferay DXP server is registered in LCS. If for some reason it isn’t, see the LCS troubleshooting article.
Determining Your Server’s LCS Connection Status
In Liferay DXP, you can view your LCS connection status in the LCS client app. Access the client by clicking Control Panel → Configuration → Liferay Connected Services.
Here’s a full description of what a connected LCS client app displays:
Connection Uptime: The duration of the client’s connection with LCS.
Last Message Received: The time the LCS client received the latest connection message from LCS. These messages occur only upon connection/reconnection and are unrelated to server metrics. It’s therefore common for a long period of time to pass before the client receives another such message for a reconnection event.
Services: The LCS services enabled for this server. Note that all servers in an environment use the same set of LCS services. LCS services can’t be controlled on a server-by-server basis.
Project Home: A link to this server’s LCS project.
Environment: A link to this server’s LCS environment.
Server Dashboard: A link to the server on LCS.