Recently, I’ve had a chance to play around with the installation of a new Sitecore demo – Habitat Home. 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 (01-Aug-2018): for Sitecore XP 9.0.2 and SXA 1.7.1 demo, please navigate to this one
Setup Preresiquites
- Windows 10
- Visual Studio 2017
- Sitecore Powershell Extensions 4.7.2
- Note: must log into https://dev.sitecore.net/ before downloading
- Sitecore Experience Platform 9.0 Update 1
- Sitecore Experience Accelerator 1.6
- Data Exchange Framework 2.0.1
- Sitecore Provider for Data Exchange Framework 2.0.1
- SQL Provider for Data Exchange Framework 2.0.1
- xConnect Provider for Data Exchange Framework 2.0.1
- Microsoft Dynamics 365 for Sales Provider for Data Exchange Framework 2.0.1
- Sitecore Connect for Microsoft Dynamics 365 for Sales 2.0.1
- Url Rewrite 2.1
- Node.js
Step-by-step Guide
- install the ones below if not yet 😀
- a fresh Sitecore 9.0 Update 1 instance , let’s say habitathome.local and habitathome.xconnect.local (xConnect site)
- Url Rewrite 2.1
- Node.js
- ensure that you create an HTTPS binding with appropriate self-signed certificate
- Note 1: you can try creating the self-signed certificate and assign it to your site if not yet by executing the following PowerShell script
- launch PowerShell as an administrator
-
Add-WebFeatureSSL -HostName “habitathome.local” -RootDnsName “DO_NOT_TRUST_SitecoreDemo”
- Note 2: if you see something like New-SelfSignedCertificate : CertEnroll::CX509Enrollment::_CreateRequest: The time period is invalid. 0x80630705, you will have to use the new root certificate (Ex: DO_NOT_TRUST_NewSitecoreDemo)
- Note 3: if you see something like The term ‘Add-WebFeatureSSL’ is not recognized as the name of a cmdlet, function, script file, or operable program you will have to execute Install-Module SitecoreFundamentals
- install all required Sitecore modules below via Installation Wizard
- Sitecore Powershell Extensions 4.7.2
- Note: must log into https://dev.sitecore.net/ before downloading
- Sitecore Experience Accelerator 1.6
- Data Exchange Framework 2.0.1
- Sitecore Provider for Data Exchange Framework 2.0.1
- SQL Provider for Data Exchange Framework 2.0.1
- xConnect Provider for Data Exchange Framework 2.0.1
- Microsoft Dynamics 365 for Sales Provider for Data Exchange Framework 2.0.1
- Sitecore Connect for Microsoft Dynamics 365 for Sales 2.0.1
- Note: if you don’t follow the order above strictly, you will see something like this
- download or clone the git repo from Habitat Home (version 9.0.1.9)
- restore all Node.js modules
- run command line as Administrator
- change directory to Habitat Home directory
- execute npm install
- 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
- \src\Project\Common\code\App_Config\Include\Project\z.Common.Website.DevSettings.config
- \gulp-config.js
- open \HabitatHome.sln with Visual Studio 2017
- deploy Sitecore.HabitatHome.Content
- open Task Runner Explorer on View -> Other Window -> Task Runner Explorer
- choose Solution ‘Habitat.Home’ from list, then click refresh button
- from task list, double click on default 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)
- hopefully everything runs well and then you would see something like this
- open a browser and then navigate to https://habitathome.local, you would see the default page of Sitecore website. That’s because we don’t use the default host name habitathome.dev.local so we need to correct it inside Sitecore
- log into https://habitathome.local/sitecore
- access /sitecore/content/Habitat Sites/Habitat Home/Settings/Site Grouping/Habitat Home
- update Host Name to habitathome.local then save
- refresh https://habitathome.local, you would see something like this
Note: some known issues
- running Sync-Unicorn gulp task: The underlying connection was closed: Could not establish trust relationship for the SSL/TLS
- my suggestion: ensure that you create an HTTPS binding with appropriate self-signed certificate
- installing a required Sitecore module: The installation failed.
- my suggestion: ensure to follow the installation order strictly and then reinstall the failed one with Overwrite option
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!
Very good blog, really helped me..
LikeLiked by 1 person