Sitecore Commerce 9.3 Initial Release – Step by step Install Guide on your machine

This one is a summary of my own experience for Sitecore Experience Commerce 9.3 Initial Release (aka Sitecore XC 9.3.0) installation on my machine. I’ve had much experience in the following ones:

so I decided to go only with:

I do hope that this blog post is helpful for your own journey as well.

Note: personally, I wanted to use my own install directory rather than the default one

Setup Prerequisites

Please refer to the Sitecore Experience Commerce 9 Compatibility Table for the software and version prerequisites:

Step-by-step guide

  1. install the ones below if not yet 😀
  2. rebuild the Link databases for the master and core databases if not yet:
    • on the Sitecore Launchpad, click Control Panel, and in the Database section, click Rebuild Link Databases
    •  select the master and core databases and then click Rebuild
    • sc9com_1
  3. rebuild the search indexes if not yet:
    • on the Sitecore Launchpad, click Control Panel, and in the Indexing section, click Indexing manager
    •  in the Indexing Manager dialog box, click Select all, and then click Rebuild
    • sxc902_7
  4. ensure that Experience Analytics is working properly
    • This slideshow requires JavaScript.

    • Note: if there is any error
      • option 1: you will have to solve it before installing XC by opening the Sitecore log and then having a look at the error messages (normally, they’re certificate issues)
      • option 2: you may want to disable xDB and then fix the error later after installing XC successfully
  5. create a new folder D:\sc930_com_install
  6. download MSBuild Microsoft Visual Studio Web targets (available from Nuget) then extract the Web targets package, copy the \tools\VSToolsPath\Web\Microsoft.Web.XmlTransform.dll file into D:\sc930_com_install
  7. Sitecore PowerShell Extension for Sitecore 9.3 (Note: must log into before downloading) and put it into D:\sc930_com_install
  8. Sitecore Experience Accelerator for 9.3 (Note: must log into before downloading)
  9. and put it into D:\sc930_com_install
  10. download and unzip Packages for On Premise WDP 2020.01-5.0.145 (Note: must log into before downloading) then put it into D:\sc930_com_install
  11. unzip D:\sc930_com_install\ and then rename D:\sc930_com_install\ to D:\sc930_com_install\SIF for a better practice
  12. override the following files in order to inject the custom install directory of Commerce’s sites
    • open raw and then copy / paste Master_SingleServer.json into D:\sc930_com_install\SIF\Configuration\Commerce
    • xc930_8
    • open raw and then copy / paste CommerceEngine.json into D:\sc930_com_install\SIF\Configuration\Commerce\CommerceEngine
    • xc930_9
    • open raw and then copy / paste CommerceEngine.Instance.Deploy.json into D:\sc930_com_install\SIF\Configuration\Commerce\CommerceEngine
    • xc930_10
    • (optional) download + unzip and then copy / paste all to D:\sc930_com_install\SIF
  13. download sc930_com_install.ps1 and put it into D:\sc930_com_install\SIF then open it to correct the following parameters if necessary
    • $ScInstallDirectory
    • $SiteNamePrefix
    • $SiteHostHeaderName
    • $SitecoreDbServer
      • ensure using double back slash if any
      • xc930_25
    • $SqlUser
    • $SqlPass
    • $SolrUrl
    • $SolrRoot
    • $SolrService
    • $CommerceEngineConnectClientSecret: refer to Step 14 below
      • deployment fails if you don’t provide a qualified value for this parameter
      • xc930_13
  14. (optional) create a secret client certificate
    • refer to 2.3. Create a secret client certificate (Page 12) in Installation Guide – WDP for On Premise
    • xc930_11
    • Note: you can download the PowerShell script above here and then
      • open Windows PowerShell
      • xc930_12
      • note the generated client script and then replace the value of $CommerceEngineConnectClientSecret
      • xc930_14
  15. (optional) correct the SitecoreUserName and SitecoreUserPassword of your Sitecore XP 9.3.0 instance if you’re using others rather than the default ones
      • xc930_15
  16. (optional) you can specify any local account (note: it will be created automatically if non-existent) to be set up for the various application pools that are created as part of the deployment
    • xc930_16
  17. let’s install it
    • Note: ensure that there is NO custom AllowedCorsOriginsGroup in D:\sc930_com_install\SIF\IdentityServer\Sitecore.Commerce.IdentityServer.Host.xml (they’re added automatically in prior installations)
    • xc930_19
    • launch PowerShell as an administrator
    • change directory to D:\sc930_com_install\SIF
    • execute .\sc930_com_install
    • xc930_20
    • hopefully there is nothing can stop the installation process now
  18. open a browser then navigate to https://storefront930.local/, you would see the default page of Sitecore website. That’s because we don’t use the default host name so we need to correct it via Sitecore
    • log into https://storefront930.local/sitecore/
    • access /sitecore/content/Sitecore/Storefront/Settings/Site Grouping/Storefront
    • update Host Name to storefront930.local and Database to master
    • xc930_17
    • (optional) not check the checkbox Cache Html and select Yes for Disable Browser Caching for a better practice
    • sc910com_17
    • refresh https://storefront930.local/ and then add some products, you would see something like this
    • xc930_18
  19. DO NOT forget to perform Post-Installation Steps

The recommendation

We can remove the modules completed from D:\sc930_com_install\SIF\Configuration\Commerce\Master_SingleServer.json and re-do Step 17 if there is something wrong (especially for Note: some known issues below) so that we are able to save a lot of time 😀

Likewise the following one in the installation guide:


How to uninstall it?

  • open D:\sc930_com_install\SIF\sc930_com_install.ps1 and uncomment the line 296 + comment out the line 293 then save it
  • xc930_21
  • Note 1: ensure using only “single back slash” in $SitecoreDbServer
  • xc930_22
  • Note 2: DO NOT FORGET to restore D:\sc930_com_install\SIF\Configuration\Commerce\Master_SingleServer.json if you already edited it for removing the modules completed via the install operations
  • open Windows PowerShell (run as administrator)
  • change directory to D:\sc930_com_install\SIF
  • execute .\sc930_com_install
  • xc930_23
  • hopefully, it runs well and cleans everything up

Note: some known issues

  1. The remote server returned an error : (400) Bad Request
    • xc930_24
    • my suggestion: try doing IIS Reset and then perform the current install step again
  2. The MERGE statement attempted to UPDATE or DELETE the same row more than once
    • xc920_21.png
    • my suggestion is to remove all prior modules completed + Module-HabitatImages task itself (in this case) from D:\sc930_com_install\SIF\Configuration\Commerce\Master_SingleServer.json and re-do Step 17
  3. The remote server returned an error: (500) internal server error
    • xc930_26
    • my suggestion: ensure correcting the parameters are mentioned in Step 13

Got issues?

Please send your issues (with screenshots if possible) to so that I have a chance to understand your problem and be able to suggest the solution.

Happy Sitecore Commerce Installation!

3 thoughts on “Sitecore Commerce 9.3 Initial Release – Step by step Install Guide on your machine

Leave a Reply to Viet Hoang Cancel reply

Please log in using one of these methods to post your comment: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.