Sitecore XP 10.1 Update 2 – Installation – Docker Way

This blog post is a summary of my own experience for Sitecore Experience Platform 10.1 Update 2 (e.g Sitecore 10.1.2) installation on my machine with the following install guide:

• Installation Guide for Developer Workstation with Containers (Thanks Sitecore team!)

Prerequisites

• Windows 10 version 1809 or higher
• >= 16 Gb of memory
• Sitecore 10 license file
• the latest Docker Desktop

Step-by-step Guide

1. ensure to set up your docker environment by following https://containers.doc.sitecore.com/docs/environment-setup
2. try to bypass some common network issues by setting DNS servers in the Docker engine configuration:
   • open Docker Desktop and then select Settings => Docker Engine
   • ensure the value of the “dns” key is set to [“8.8.8.8”] if any
   • click Apply & Restart button
   • 
3. to avoid any conflicts, we should ensure the following ports are not being used by another process: 443, 8079, 8984, and14330 (Page 6 in Installation Guide for Developer Workstation with Containers)
   • 
   • stop IIS
     • 
   • stop windows services if any
   • quit Skype for sure
4. create a new folder D:sc1012_install
5. download and unzip Container Deployment Package
6. correct the Sitecore version 1.2-ltsc2019in D:sc1012_installSitecoreContainerDeployment.10.1.2.006578.651composeltsc2019xp0.evn
   • 
7. create all certificates and initialize the environment file of Windows Server Core version ltsc2019 and XP Single topology (xp0)
   • download ps1 and then put it into D:sc1012_installSitecoreContainerDeployment.10.1.2.006578.651composeltsc2019xp0
     • Note: the original file is of Sitecore Docker Examples
   • edit “HostName” parameter and be able to change other default values as well
   • 
   • ensure that this file C:licenselicense.xml is available, otherwise will see this error message later License file is not found. or “License not found at ‘C:licenselicense.xml’”
   • open Windows PowerShell (run as administrator)
   • change directory to D:sc1012_installSitecoreContainerDeployment.10.1.2.006578.651composeltsc2019xp0
   • execute .init.ps1 -LicenseXmlPath C:licenselicense.xml
   • 
8. pull Sitecore docker images
   • open Windows PowerShell (run as administrator)
   • change directory to D:sc1012_installSitecoreContainerDeployment.10.1.2.006578.651composeltsc2019xp0
   • execute docker-compose pull
   • 
   • 
9. spin up the container-based Sitecore instances
   • open Windows PowerShell (run as administrator)
   • change directory to D:sc1012_installSitecoreContainerDeployment.10.1.2.006578.651composeltsc2019xp0
   • execute docker-compose up –d
   • 
10. open a browser, navigate to https://cm.sc1012localhost/, we would see the default Sitecore page and a valid SSL certificate
    • 
11. open a browser, navigate to https://cm.sc1012.localhost/sitecore, we should be able to login with the admin user and b password by default
    • 
12. DON’T FORGET to perform the following thing as well (Page 12 in Installation Guide for Developer Workstation with Containers)
    • 

Notes

1. for stopping the Sitecore instances without losing the changes
   • open Windows PowerShell (run as administrator)
   • change directory to D:sc1012_installSitecoreContainerDeployment.10.1.2.006578.651composeltsc2019xp0

   • execute  docker-compose stop

   • 

   • start the Sitecore instances again by executing  docker-compose start

   • 
2. for data cleanup
   • download ps1 and then put it into D:sc1012_installSitecoreContainerDeployment.10.1.2.006578.651composeltsc2019xp0
     • Note: the original file is of Sitecore Docker Examples
   • open Windows PowerShell (run as administrator)
   • change directory to D:sc1012_installSitecoreContainerDeployment.10.1.2.006578.651composeltsc2019xp0

   • execute  docker-compose down

   • execute  .clean

   • 

Happy Sitecore XP 10.1 Update 2 Installation!

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