installation

Sitecore XP 9.1.0 and SXA 1.8.0 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 Initial Release (aka SXA 1.8.0) on Sitecore Experience Platform 9.1 Initial Release (aka Sitecore XP 9.1.0) 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 version 9.1.0.3
  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
    • hh91_6
  7. deploy Sitecore.HabitatHome.Platform
    • launch PowerShell as an administrator
    • change directory to \Sitecore.HabitatHome.Platform
    • execute .\build
    • hh91_3.png
  8. hopefully everything runs well and then you would see something like this
    • hh91_4
  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!

 

 

7 thoughts on “Sitecore XP 9.1.0 and SXA 1.8.0 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.