Deploying Liferay Commerce to an Existing Liferay Installation

This article documents how to deploy Liferay Commerce to an existing Liferay DXP instance. Because Liferay Commerce is built on Liferay DXP, it is necessary to have an existing DXP 7.1 or 7.2 instance running. Before starting, please review system requirements.

1. Download the latest Liferay Commerce LPKG.

   • Enterprise subscribers can download the latest LPKG from Help Center.

   • Subscribers also need an order number or activation key for Liferay Commerce. See Activating a Marketplace App Through a Proxy Server.

   • The latest open source LPKG may be obtained from the Liferay Commerce Community Download Page.

2. Deploy the LPKG to the ${liferay.home}/deploy folder.

   Note

   To learn more about deploying applications to Liferay DXP, see Liferay Home.

3. (Subscribers) Deploy the activation key to the ${liferay.home}/deploy folder.

4. Verify the following message appears in the application server console:

   2019-08-09 00:25:10.662 INFO  [fileinstall-/../../liferay-dxp-7.1.10.1-sp1/osgi/marketplace][LPKGArtifactInstaller:202] The portal instance needs to be restarted to complete the installation of file:/../../liferay-dxp-7.1.10.1-sp1/osgi/marketplace/Liferay%20Commerce%20-%20API.lpkg
   2019-08-09 00:25:10.664 INFO  [fileinstall-/../..//liferay-dxp-7.1.10.1-sp1/osgi/marketplace][LPKGArtifactInstaller:202] The portal instance needs to be restarted to complete the installation of file:/../../liferay-dxp-7.1.10.1-sp1/osgi/marketplace/Liferay%20Commerce%20-%20Impl.lpkg
   

5. Shut down the application server completely.

6. Start the application server.

7. Verify that the LPKG has begun installation by looking for this message:

   2019-08-09 00:32:48.850 INFO  [main][BaseDeployer:877] Deploying minium-theme.war
   

8. On the first deployment, there are a series of commands followed by this message:

   2019-08-09 00:34:51.753 INFO  [main][ThemeHotDeployListener:108] 1 theme for minium-theme is available for use
   

9. On first startup, execute a reindex to populate the Liferay Commerce default content; navigate to the Control Panel → Configuration → Search.

10. Click Reindex next to All search indexes.

Liferay Commerce has been deployed and is ready for use. Store administrators can begin building a storefront and populating their catalog. Note that if the application server is restarted, Liferay Commerce will not execute the VerifyProcess commands a second time.

Related Topics

• Liferay Commerce 3.0 Compatibility Matrix
• Using the Liferay Commerce Tomcat Bundle