commerce

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

Update (03-May-2020): we can run Sitecore Commerce 9.3.0 on Docker environment as well

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 https://dev.sitecore.net/ before downloading) and put it into D:\sc930_com_install
  8. Sitecore Experience Accelerator for 9.3 (Note: must log into https://dev.sitecore.net/ 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 https://dev.sitecore.net/ before downloading) then put it into D:\sc930_com_install
  11. unzip D:\sc930_com_install\SIF.Sitecore.Commerce.4.0.31.zip and then rename D:\sc930_com_install\SIF.Sitecore.Commerce.4.0.31.zip 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  Configuration.zip 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 sxa.storefront.com 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:

xc930_27

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 (Note: please check The Recommendation section in this post to know how to remove the completed install steps)
  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 viet.hoang.sitecore@gmail.com so that I have a chance to understand your problem and be able to suggest the solution.

Happy Sitecore Commerce Installation!

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

  1. I followed all the installation steps and there was no error in the script running in PS. But, when I go to Sitecore I don’t see any SXA modules created.

    For complete info, I have sent you the output of running the script and screenshot of the Sitecore on your gmail with subject “Prashant facing commerce installation issue”

    Like

    1. Hi Prashant. by default its running Uninstall script , you have to edit the powershell script to run the installation
      sc930_com_install.ps1 and comment the line 296 + Uncomment out the line 293 then save and run the Ps Script

      Like

Leave a Reply to balaji (@balajisitecore) Cancel reply

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

WordPress.com Logo

You are commenting using your WordPress.com 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.