installation

Sitecore XP 9.1.1 and SXA 1.8.1 Demo – Habitat Home – Step by step Setup Guide

You’re a Sitecore developer and want to know how to implement the website(s) using Sitecore Experience Accelerator 1.8 Update 1 (aka SXA 1.8.1) on Sitecore Experience Platform 9.1 Update 1 (aka Sitecore XP 9.1.1) and following Helix principles.

If that is the case, you should set up Sitecore demo – Habitat Home – on your machine so that you’re able to play around with the Sitecore solution example and then learn something.

Setup Preresiquites

Step-by-step Guide

  1. install the ones below if not yet 😀
  2. install all required Sitecore modules below via Installation Wizard
  3. publish your Sitecore Instance
    • This slideshow requires JavaScript.

  4. download or clone the git repo from Habitat Home Platform 9.1.1
  5. 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)
    • This slideshow requires JavaScript.

    • 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
    • otherwise, you’re gonna see the following issue later when performing “Sync-Unicorn” task
    • hh91_7
  6. Note: I don’t want to use the default settings so I need to adjust the appropriate values in cake-config.json
    • hh911_4
  7. deploy Sitecore.HabitatHome.Platform
    • launch PowerShell as an administrator
    • change directory to \Sitecore.HabitatHome.Platform
    • execute .\build
    • hh91_3.png
    • Note: you may get the following error while build task “Sync-Unicorn” is publishing items in queue to web , just execute .\build -Target “Post-Deploy” to resolve it
    • hh911_1
  8. hopefully everything runs well and then you would see something like this
    • hh911_2
  9. open a browser and then navigate to https://habitathome.local, you would see something like this
    • hh91_5
    • Note: you may see the default page of Sitecore website. That’s because you don’t use the host name habitathome.local so you need to correct it in Sitecore
      • log into https://habitathome.local/sitecore (Note: you may get Known Issue #1 below)
      • open Desktop -> PowerShell Toolbox -> SXA Site Manager dialog
      • hh902_3
      • select HabitatHome row and then click Open button on the top-right of SXA Site Manager dialog
      • update Host Name field to habitathome.local and Database field to master then click OK button to save
      • hh902_4.png
      • refresh https://habitathome.local

 

Note: some known issues

  1. Sorry, there was an error : unauthorized_client
    • hh91_8
    • my suggestion: ensure that there is https://habitathome.local in AllowCorsOrigins setting of your Sitecore Identity Server site
    • open \habitathome.identityserver.local\Config\production\Sitecore.IdentityServer.Host.xml and then correct it
    • hh91_10
    • (optional) add a new AllowCorsOriginsGroup to that file like this
    • hh91_9
    • DON’T FORGET to do IIS reset
  2. Search function does NOT work as expected: No results

 

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!

 

 

3 thoughts on “Sitecore XP 9.1.1 and SXA 1.8.1 Demo – Habitat Home – Step by step Setup Guide

Leave a Reply

Please log in using one of these methods to post your comment:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.