Step-by-step install Sitecore Commerce (XC) 10

Looking to install XC10 on your dev machine, here are 20 steps to do it. We referred to the installation Guide provided by Sitecore.

Download Installation Guide

Before installing Sitecore Commerce install Sitecore XP 10. See this blog to install Sitecore XP 10 using SIA. We name XP site name as sc10.sc.dev.local

Please make sure that you meet the following hosting requirements and downloaded and installed the requisite software.

1. Operating system– Windows Server 2019/2016 or Windows 10 Pro(64-bit)
2. Redis (Windows): 3.0.504
3. .Net Framework – ASP.Net Core runtime 3.1.6 (Recommend to install v3.1.7 it has a security patch)
4. Database – Microsoft SQL Server 2017 Express Edition(This should be already installed as a part of XP 10)
5. Microsoft Web Deploy 3.6
6. Install URL Rewrite using Web Platform Installer
7. SOLR 8.4.0 (This should have already installed as a part of XP 10 install)
8. PowerShell 6.0 or later
9. Web Platform Transformer (Download NuGet package)

Download following Sitecore Software before XC installation–

• Sitecore Experience Platform 10.0
• Sitecore Experience Accelerator (SXA) 10.0
• Sitecore PowerShell Extensions 6.0 for Sitecore 10.0

Before you begin the installation

• Ensure XP 10 instance is working and indexed. If not indexed rebuild all search indexes

• Check if the SOLR is working and accessible via https

Step-by-step installation process –

1. Create a installation folder for XC – xcinstall e.g. : – c:\scinstall
2. Extract and copy Sitecore.Commerce.WDP.2020.08-6.0.238.zip files to the “c:\scinstall folder”
3. Sitecore Experience Accelerator – Copy Sitecore Experience Accelerator 10.0.0.3138.zip to “c:\scinstall folder”
4. Sitecore PowerShell Extensions – Copy Sitecore.PowerShell.Extensions-6.1.1.zip file to “c:\scinstall” folder
5. Microsoft.Web.XmlTransform – Extract Web Platform Transform NuGet package and copy Microsoft.Web.XmlTransform.dll to “c:\scinstall” folder
6. Extract SIF.Sitecore.Commerce.5.0.49 to “c:\scinstall” folder
7. The folder structure should look like this
8. Update Deploy-Sitecore-Commerce.ps1 file
   1. $SiteNamePrefix
   2. $SiteName
   3. $IdentityServerSiteName
   4. $SiteHostHeaderName
   5. $XConnectInstallDir
9. Update DB related configuration
   • $SitecoreDbServer – In case of named instance ensure you set double slash between the server and instance name “SQLServerName\\SQLInstanceName”
10. Update other DB related settings$SqlUser
    1. $SqlPass
    2. $CommerceServicesDbServer
11. [Optional] Update Sitecore domain or keep it default-$SitecoreDomain
    1. $SitecoreUsername
    2. $SitecoreUserPassword
12. Update SOLR details-$SolrUrl
    1. $SolrRoot
    2. $SolrService
13. [Optional] Update local account details$UserDomain
    1. $UserName
    2. $UserPassword
14. Create Commerce Engine Connect Client Secret for the Sitecore Identity Server
    1. Copy below script to file to scinstall/SIF.Sitecore.Commerce.5.0.49 folder example XC10SecretClientCertificate.ps1
    2. Execute the script and copy the secret key

$bytes = New-Object Byte[] 32
$rand = [System.Security.Cryptography.RandomNumberGenerator]::Create()
$rand.GetBytes($bytes)
$rand.Dispose()
$newClientSecret = [System.Convert]::ToBase64String($bytes)

Write-Host $newClientSecret

16. Copy the secret key to update $CommerceEngineConnectClientSecret variable in Deploy-Sitecore-Commerce.ps1

17. Execute Deploy-Sitecore-Commerce.ps1 script to install commerce

18. Once installed successfully log in to Sitecore, you shall find the Business tool in Dashboard

19. Goto content editor and navigate to item- /sitecore/content/Sitecore/Storefront/Settings/Site Grouping/Storefront to change Host Name

20. Visit the site to check if the default storefront site is loading

If you need support with setting up your environments, why not look at our Assure.Ops service.