Sitecore 10 on docker – common issues

Hi there

This year there were a lot of good videos showing how to install Sitecore Docker, and with a lot of content and detailed explanation of the concepts, however, sometimes the installation process does not go smoothly and you can face multiple issues on your machine.

In this quick tutorial, we are gonna try to review some installations steps and also cover issues that you may face, and how to fix those issues

First , let’s review the basic Installation Process

You will need

Step1 :

Install Docker for windows

Step 2

Right click on the Docker Icon in the system tray, and

click “Switch to Windows Containers”

Step 3

Create a folder C:\SitecoreXPDocker

Step 4

Copy license.xml to C:\SitecoreXPDocker

Step5

Unpack the SitecoreContainerDeploy.10.xxxxx and navigate to the folder “compose\ltsc2019\xp0”

Copy all the content to C:\SitecoreXPDocker

Step 6

Move the Init1.ps1 to C:\SitecoreXPDocker

Final Result

Step 7

Open Powershell script and run

./Init1.ps

Provide the location where the license file is located, ex: c:\SitecoreXpDocker\license.xml

Step 8

run command

docker-compose up --detach

Step 9

check the health of your containers, their status should be “healthy”

docker ps

Step 10

Open Sitecore Content Management (cm): https://xp0cm.localhost

Step 11

Explore all the machines and their resources

Sitecore Content Management (cm): https://xp0cm.localhost
Sitecore Identity Server (id): https://xp0id.localhost
Sitecore xConnect Server (xconnect): http://localhost:8081
Apache Solr (solr): http://localhost:8984
Microsoft SQL Server (mssql): localhost,14330
Traefik: http://localhost:8079

Step 12

Explore the containers with Visual Studio 2019/Visual Studio Code

Visual Studio 2019 – Views -> Containers

See The files on the containers, and additional info

navigating into the folders

When THINGS START TO FAIL

#0 Powershell Issue

cannot be
loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at
https:/go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:1

SOLUTION : set-executionpolicy remotesigned

result

#1 Hyper V Issue on DOCKER

When loading Docker after the installation, the user may face the follow issue

ERROR MESSAGE: Hyper-V service vmms is not available


SOLUTION

Go to “Control Panel->Windows Features” and make sure your Hyper-V is enabled(checked) like the image below

Reboot the machine

#2 Hyper V Issue on DOCKER

The application may also show you the follow error message

ERROR MESSAGE : Required Windows feature(s) not enabled: Hyper-V

SOLUTION

Open Windows powershell and execute the command below

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

Reboot the machine

#3 WSL 2 Installation is incomplete

go to the following URL and download the latest package

https://docs.microsoft.com/en-us/windows/wsl/install-win10#step-4—download-the-linux-kernel-update-package

https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

#4 Container “XXXXXXX” is unhealthy

This seems very common , even after a perfect installation, the “unhealthy” issue may pop-up and prevent you from accessing your Sitecore Container

This may happen on Step 8 “docker-compose up –detach”

ERROR MESSAGE : ERROR: for id Container “3c8489854151” is unhealthy.

ERROR MESSAGE : ERROR: for traefik Container “XXXX” is unhealthy.

There are a few reasons that can trigger that, that means that your Container had issues for loading

SOLUTION

Stop IIS : on power shell type

iisreset /stop

Double check that IIS is not running anymore

Shutdown the containers

docker-compose down

Close VPNs( like Cisco VPN)

Try to restart Docker

Stop Solar to free port 8983

start the containers once again

docker-compose up --detach

This time, everything seems ok

open the browser and try again

https://xp0cm.localhost/sitecore/login

#5 daemon: pull access denied

docker-compose pull

ERROR MESSAGE

Error response from daemon: pull access denied for docker-examples-xp0-xconnect, repository does not exist or may require ‘docker login’: denied: requested access to the resource is denied

SOLUTION

Go to the Docker, and disabled “Use Docker Compose V2 release candidate”

Now try again

#6 cannot create service for cd:create

This issue may happen when trying to set up the example “MVP-Site” it’s been reported here, but without a solution

https://github.com/Sitecore/MVP-Site/issues/17

ERROR MESSAGE :

ERROR: for mvp-site-master_cd_1 Cannot create container for service cd: create .: volume name is too short, names should be at least two alphanumeric characters

SOLUTION

Don’t forget to pass all the parameters

.\init.ps1 -InitEnv -LicenseXmlPath C:\license\license.xml -AdminPassword b

#7 File dotnet-tools.json came from another computer and might be blocked to help protect this computer.

ERROR MESSAGE:

File dotnet-tools.json came from another computer and might be blocked to help protect this computer

SOLUTION:

Right click on the file and click “Unblock”

#8 Error response from daemon: Unrecognised volume spec: file ‘\.\pipe\docker_engine’ cannot be mapped. Only directories can be mapped on this platform

solution

docker-compose disable-v2

Additional Resources

https://doc.sitecore.com/en/developers/100/developer-tools/troubleshooting-docker.html

https://doc.sitecore.com/en/developers/100/developer-tools/run-your-first-sitecore-instance.html

Docker Examples

https://github.com/konabos/konabos-docker-examples

https://github.com/Sitecore/docker-examples