Recently, I’ve had a chance to play around with the installation of a new Sitecore demo – Habitat Home Commerce. Personally, it’s an interesting experience for me so I want to write it down for myself and for the Sitecore community. I do hope that it’s helpful for your own play.

Thanks Jean-François Larente for his prompt support so that I was able to overcome the problems quickly if any during the installation.

Update (07-Aug-2018): for Sitecore XC 9.0.2 demo, please navigate to this one

Setup Preresiquites

• Windows 10
• Visual Studio 2017
• Sitecore Experience Commerce 9.0 Update 1
• Habitat Home Content

Step-by-step Guide

1. install a fresh Sitecore Commerce 9.0 Update 1
   • Note: Sitecore instance name should be habitathome.local and certificate for the Sitecore Commerce Engine should be issued to habitathome.local in this installation guide
2. deploy Habitat Home (version 9.0.1.9) to Sitecore instance habitathome.local
   • Note 1: we don’t need to install the following Sitecore modules in this installation guide because they’re installed in Step 1
     • Sitecore Powershell Extensions 4.7.2
     • Sitecore Experience Accelerator 1.6
   • Note 2: should run quick-deploy gulp task rather than default one
     • 
3. download or clone the git repo from Habitat Home Commerce (version 9.0.1.9)
4. restore all Node.js modules
   • run command line as Administrator
   • change directory to Habitat Home Commerce directory
   • execute npm install
   • 
5. Note: I don’t want to use the default settings so I need to adjust the appropriate values in the following files:
   • \gulp-config.js
     • 
   • \publishsettings.targets
     • 
   • \deploy-commerce-engine.ps1
     • 
   • \src\Project\HabitatHome\engine\wwwroot\bootstrap\Global.json
     • 
   • \src\Project\HabitatHome\engine\wwwroot\data\Environments\Plugin.SQL.PolicySet-1.0.0.json
     • 
6. open \HabitatHome.Commerce.sln with Visual Studio 2017
7. deploy the solution
   • open Task Runner Explorer on View -> Other Window -> Task Runner Explorer
   • 
   • choose Solution ‘HabitatHome.Commerce’ from list, then click refresh button
   • from task list, double click on initial task to run it
   • 
   • Note: for Visual Studio 2017 on your own machine, you might have to run gulp tasks via Command Prompt (run as Administrator)
8. hopefully everything runs well and then you would see something like this
   • 
9. deploy the engine
   • launch PowerShell as an administrator
   • change directory to Habitat Home Commerce directory
   • execute .\deploy-commerce-engine.ps1 -Boostrap -Initialize
   • 
   • hopefully everything runs well and then you would see something like this
   • 
10. open a browser and then navigate to https://habitathome.local, you would see something like this after adding some products to cart successfully
    • 

Note: some known issues

1. Visual Studio’s Task Runner: SyntaxError: Unexpected token
   • 
   • my suggestion: have a look at https://stackoverflow.com/questions/45580456/visual-studio-task-runner-error-with-es6 in order to overcome the issue
2. Invoke-RestMethod: The remote server returned an error: (500) Internal Server Error
   • 
   • open the log file you would see something like this

   • ERROR Connection id “”0HLE4OSSCC354″”, Request id “”0HLE4OSSCC354:00000001″”: An unhandled exception was thrown by the application.Microsoft.AspNetCore.Antiforgery.AntiforgeryValidationException: The required antiforgery cookie “.AspNetCore.Antiforgery.cf4m-F-R1lY” is not present.

   • my suggestion: ensure the engine suffix correct in deploy-commerce-engine.ps1 and then perform Step 9 again
3. Cleaning Environments:  HTTP Error 502.5
   • 
   • open Windows Event Viewer, you should see something like this
   • 
   • my suggestions: probably ASP.NET Core module was not installed correctly on your machine, you should try to install the latest version of .NET Core 2.0 (Runtime) and then perform Step 9 again
4. Empty strings are not allowed. Parameter name: value
   • 
   • my suggestion:
     • log into https://habitathome.local/sitecore
     • hit Refresh Commerce Cache in the COMMERCE tab of Content Editor
     • 
     • access /sitecore/Commerce/Commerce Control Panel/Storefront Settings/Storefronts/HabitatHome/Catalog Configuration
     • update Catalog to Habitat Master then save
     • 
5. Guid should contain 32 digits with 4 dashes
   • 
   • my suggestion:
     • log into https://habitathome.local/sitecore
     • make sure that Solr is running properly by rebuilding the search indexes in the Sitecore client (Control Panel => Indexing Manager) if not yet
       • select the checkbox sitecore_master_index and then click Rebuild button
     • hit Refresh Commerce Cache in the COMMERCE tab of Content Editor
     • 

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 Demo Installation!