Website Development Company in Singapore
⟵ Resources

How to run Sitecore Commerce by using Sitecore Docker images and Windows containers

Monitor abstract design

So I’ve had a chance to play around with the set-up of Sitecore Docker Images recently. Now I wanted to run Sitecore Commerce version 9.3 by using Sitecore Docker images and Windows containers as well.

There are some hiccups during my journey, however, the following links are helpful for me:

Prerequisites

Step-by-step Set Up

  1. please ensure performing Step 1 -> 8 in the set-up of Sitecore Docker Images  if NOT YET
  2. let’s build docker images of Sitecore XC 9.3.0 on latest LTSC (Long Term Support Channel) Windows version
    • open Windows PowerShell (run as administrator)
      • change directory to D:\ScDocker\docker-images
      • Note: at this moment, the latest Sitecore version is 9.3 and we can use –SitecoreVersion parameter to build image of other versions as well
      • Ex: .\build -SitecoreVersion “9.2.0” -Topology “xp”, “xc” -IncludeSxa -IncludeSpe
    • execute .\build -Topology “xp”, “xc” -IncludeSxa -IncludeSpe and then enter username / password of your Sitecore certified account on Sitecore Downloads
    • go to docker images directory
    • (optional) in D:\ScDocker\docker-images, create packages folder manually and then copy / paste all the following Sitecore packages are compatible with 9.3 version to “D:\ScDocker\docker-images\packages” folder
    • docker images packages folder
    • hopefully will see something like this after a loooooooooooog operation
    • builds completed
    • Note: we should remove unused images (dangling images created during build) as well to save a lot of disk space by executing docker image prune ‐‐force
  3. ensure that this file C:\license\license.xml is available, otherwise will see this error message later License file is not found. or “License not found at ‘C:\license\license.xml’”
  4. ensure that port 4200 is NOT in used (normally, we should stop IIS web server and windows services if any)
    • highlighted cannot start service bizfx
  5. install whales-names so we can configure XC’s DNS names such as cmcdidentitybizfx, etc automatically as internal container IP may be different after executing docker-compose up / down
    • whales-names installation
  6. (optional) the virtual machine isolation mode should be hyperv in D:\ScDocker\docker-images\windows\tests\9.3.x\.env rather than process
    • highlighted hyperv
    • otherwise, we may get the following error Cannot start service
    • cannot start service error
  7. let’s spin up Sitecore XC 9.3 instances with SXA Storefront
    • open Windows PowerShell (run as administrator)
    • change directory to D:\ScDocker\docker-images
    • execute .\Set-LicenseEnvironmentVariable.ps1 -Path C:\license\license.xml
    • change directory to D:\ScDocker\docker-images\windows\tests\9.3.x
      • Note: if we switch between versions, variants or topologies, we will have to clear the data folders by executing .\Clean-Data
      • clean data function
    • execute docker-compose -f docker-compose.xc.sxa.storefront.yml up -d
    • docker compose execution
  8. let’s configure DNS names automatically
    • open Windows PowerShell (run as administrator)
    • execute whales-names
    • whales-names execution
    • hopefully we would see something like the following ones in hosts file (normally, it’s in C:\Windows\System32\drivers\etc)
    • hosts file with two highlights
  9. log into Sitecore (admin / b) and then verify the following ones:
    • Note: always click Cancel button if there is a certificate dialog box
    • select cancel certificate dialog box
  10. perform the following Sitecore Commerce post-install steps using Postman
  11. ensure that Habitat catalog is present on both BizFx and CM
    • Note: always click Cancel button if there is a certificate dialog box
    • click cancel certificate dialog box
  12. log into Sitecore (admin / b) and then:
    • ensure that Sitecore Commerce templates is NOT out of sync by hitting Update Data Templates in the COMMERCE tab of Content Editor
    • update data templates under Commerce
    • set up a Storefront whose host name is cd by following Create a Commerce tenant and site
    • Storefront setup
    • perform a full publish
    • perform an index rebuild of sitecore_web_index and sitecore_sxa_web_index
    • index rebuild results
  13. let’s access the Storefront on CD https://cd and then try adding some products
    • add products on CD

Note: some known issues

  1. an error has occurred while executing docker-compose -f docker-compose.xc.sxa.storefront.yml up -d
    • Cannot start service … context deadline exceeded …
    • cannot start service and context deadline exceeded errors
    • my suggestion is to quit Docker Desktop and then run it again
  2. Unable to convert type
    • not secure directory
    • my suggestion is to ensure that Sitecore Commerce templates is NOT out of sync by hitting Update Data Templates in the COMMERCE tab of Content Editor
    • update data templates under commerce tab

Happy Sitecore Docker!

This article originally appeared on Walking on clouds (https://buoctrenmay.com/).

Sitecore Commerce 9 Update 2 and Step-by-step Install Guide on your machine

The Carbon Cost of Digital Elements: Unveiling the Environmental Impact of Your Website

How to Reduce Your Server Load for Peak Web Performance 

Portfolios

Resources

Contact Us

Website Development Company in Singapore white logo
LowCarbonSG Logo
Terms & Conditions | Privacy Policy | Accessibility Statement

Apply Now!

Upload Resume (with a 2mb maximum file size)
Accepted file types: doc, docx, pdf, xps, Max. file size: 2 MB.
This field is for validation purposes and should be left unchanged.