Documentation

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. Prior to following this guide, please review System Requirements.

To begin using Liferay Commerce:

  1. Download the latest Liferay Commerce LPKG.

  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
    

Liferay Commerce has been deployed and is ready for use. Store administrators can begin building a storefront and populating their catalog.

Additional Information

Note that if the application server is restarted, Liferay Commerce will not execute the VerifyProcess commands a second time.