installation

Sitecore XP 9.0.2 and SXA 1.7.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.7 Update 1 (aka SXA 1.7.1) on Sitecore Experience Platform 9 Update 2 (aka Sitecore XP 9.0.2) 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. ensure that you create an HTTPS binding with appropriate self-signed certificate
    • Note: 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”

    • This slideshow requires JavaScript.

  3. install all required Sitecore modules below via Installation Wizard
  4. download or clone the git repo from Habitat Home version 9.0.2.2
  5. restore all Node.js modules
    • run command line as Administrator
    • change directory to Habitat Home directory
    • execute npm install
    • ghh_6
  6. 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
      • ghh_3
    • \publishsettings.targets
      • ghh_4
    • \src\Project\Common\code\App_Config\Include\Project\z.Common.Website.DevSettings.config
      • ghh_5
  7. open \HabitatHome.sln with Visual Studio 2017
  8. deploy Sitecore.HabitatHome.Content
    • open Task Runner Explorer on View -> Other Window -> Task Runner Explorer
    • ghh_7
    • choose Solution ‘Habitat.Home’ from list, then click refresh button
    • from task list, double click on default task to run it
    • ghh_8
    • Note: for Visual Studio 2017 on your own machine, you might have to run gulp tasks via Command Prompt (run as Administrator)
  9. hopefully everything runs well and then you would see something like this
    • ghh_10
    • Note: you should run Sync-Unicorn gulp task one more time if you see something like this
    • hh902_2.png
  10. 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
    • 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
  11. refresh https://habitathome.local, you would see something like this
    • hh902_1

 

Note: some known issues

  1. running Sync-Unicorn gulp task: The underlying connection was closed: Could not establish trust relationship for the SSL/TLS
    • hh_9
    • my suggestion: ensure that you create an HTTPS binding with appropriate self-signed certificate
  2. installing a required Sitecore module: The installation failed.
    • blr_5
    • 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!

 

 

4 thoughts on “Sitecore XP 9.0.2 and SXA 1.7.1 Demo – Habitat Home – Step by step Setup Guide

Leave a Reply

Fill in your details below or click an icon to log in:

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.