Sitecore Commerce provides end-to-end commerce system and highly integrated with Sitecore to leverage the analytics and marketing features. Sitecore has replaced the Commerce Server with a .Net core Commerce Engine. While we will go through the various features of commerce in later posts, this post talks about the installation of Sitecore commerce with all its associated services. Before we proceed I assume you have gone through the Installation of Sitecore 9 with SXA and SOLR. Now we will install commerce on top of previous vanilla Sitecore installation.

Pre Requisites

Sitecore Commerce Requires Basic Sitecore installation with following enabled. If you do not have the Sitecore Installation, please visit the previous post.

1. Sitecore 9.2 installed with SXA.
2. Sitecore Powershell Extension.
3. SOLR 7.5 with Https enabled

Required Softwares

1. Sitecore Commerce Installation. (Sitecore.Commerce.WDP.2019.07-4.0.165)
2. MsBuild nuget package. (msbuild.microsoft.visualstudio.web.targets.14.0.0.3.nupkg)
3. .NET Core SDK 2.1.7
   
4. Redis ( https://github.com/microsoftarchive/redis/releases/download/win-3.0.504/Redis-x64-3.0.504.msi)
   

Installation Steps

Before procedding to Sitecore Commerce installation, ensure 

1. prerequisites are met 
2. Install .Net Core SDK and Redis.
3. UnZip the Sitecore commerce package to "c:\deploy\commerce"
4. You will find lots of zip files. Unzip the SIF.Sitecore.Commerce.3.0.28.zip file.
5. Rename the Nuget Package to *.zip
6. Unzip the content to a folder within "c:\deploy\commerce",like c:\deploy\commerce\msbuild.microsoft.visualstudio.web.targets.14.0.0.3

Step 1: Update Setup Script

Sitecore Commerce uses PowerShell script to automate the installation process, However, we must update the script with parameters w.r.t. our local instance. Go to the unzipped folder c:\deploy\commerce\SIF.Sitecore.Commerce.3.0.28. You will find the PowerShell script Deploy-Sitecore-Commerce.ps1. Before we make changes to the script, make a copy of the file for reference. Open the file in any text editor and update the following parameters accordingly.

Review all other parameters to make sure all variables are correct. Any mistake here will create a lot of issues during installation.

Step 2: Restart Identity Server

Sitecore Commerce talks to the Identity server for authentication and authorization. So during the installation, it will update the identity server configuration to add a new client to make API calls. So, we must restart the app pool of the identity server site BUT DO NOT BROWSE THE SITE. If the site is browsed IIS will lock the files for modification and it will fail during installation. DO NOT STOP THE APPPOOL, as instal script will access the site post updating the configuration.

Step 3: Execute Script

Towards the end of Deploy-Sitecore-Commerce.ps1, you will find the install script. Open PowerShell in admin mode navigate to the folder c:\deploy\commerce\SIF.Sitecore.Commerce.3.0.28. Execute the following commands.

 Set-ExecutionPolicy Unrestricted

In the prompt provide All.

 .\Deploy-Sitecore-Commerce.ps1

 The process will execute and install Sitecore commerce. 

Once the installation completed we can browse http://sxa.storefront.com.

Troubleshooting

Install-SitecoreConfiguration: The service cannot accept control messages at this time. (Exception
from HRESULT: 0x80070425) At C:\Program Files\WindowsPowerShell\Modules\SitecoreInstallFramework
\2.1.1\Public\Install-SitecoreConfiguration.ps1:641