guide

Playing with Sitecore.HabitatHome.Utilities on your machine

Generally speaking, I’m a very lazy developer so that I’m always welcome the better way to do a thing. As you may know, there are many manual steps to install Sitecore demo(s) such as Habitat Home and Habitat Home Commerce. In this case, Sitecore.HabitatHome.Utilities should be useful for me.

For your information: https://www.jflh.ca/2018-09-07-installing-a-sitecore-instance-and-experience-commerce-for-habitat-home-the-quick-way

Note: you may want to have all of the prerequisites installed by doing the following steps (especially if you have NOT installed Habitat Home and Habitat Home Commerce yet on your machine):

  • launch PowerShell as an administrator
  • change directory to \Sitecore.HabitatHome.Utilities\Prerequisites
  • execute .\install
  • hhu_10.png
  • change directory to \Sitecore.HabitatHome.Utilities\XP\install\Solr
  • execute .\install-solr
  • hhc_21

Step-by-step guide for installing Habitat Home (Sitecore XP 9.0.2 and SXA 1.7.1)

  1. download or clone the git repo Sitecore.HabitatHome.Utilities version 9.0.2.3
  2. (optional) if you don’t want to wait for a looooooong operation and have a good chance to get connection issues, you will need to:
  3. by default, only the SAT + SPE + SXA modules get installed automatically so we need to do that for the group of modules of Data Exchange Framework as well
    • open \Sitecore.HabitatHome.Utilities\XP\install\assets.json and then set download to true and install to true
    • hhu_9.png
  4. set the SQL instance name and sa password in \Sitecore.HabitatHome.Utilities\XP\install\set-installation-defaults
  5. create the configuration-xp0.json file and populate it with the default values
    • launch PowerShell as an administrator
    • change directory to \Sitecore.HabitatHome.Utilities\XP\install
    • execute .\set-installation-defaults
    • hhu_1
  6. (optional) if you don’t want to use the default settings, you will need to adjust the appropriate values in the configuration-xp0.json file
    • launch PowerShell as an administrator
    • change directory to \Sitecore.HabitatHome.Utilities\XP\install
    • remove example extension out of \XP\install\set-installation-overrides.ps1.example manually or by executing copy set-installation-overrides.ps1.example set-installation-overrides.ps1
    • hhu_3.png
    • open set-installation-overrides.ps1 and then correct the settings
    • hhu_4
    • execute .\set-installation-overrides
    • hhu_2
  7. copy your Sitecore license file license.xml to \Sitecore.HabitatHome.Utilities\XP\install\assets
  8. download and install 7-zip if NOT YET
    • Note: if the install directory is NOT “C:\Program Files\7-Zip\7z.exe”, you will need to update \Sitecore.HabitatHome.Utilities\XP\install\install-xp0.ps1
      • hhu_7
  9. let’s install Experience Platform
    • launch PowerShell as an administrator
    • change directory to \Sitecore.HabitatHome.Utilities\XP\install
    • execute .\install-xp0
    • hhu_5
    • you will be prompted for your https://dev.sitecore.net/ credentials – the required assets will be downloaded automatically if any, otherwise click Cancel button
    • hhu_6
    • hopefully you can see something like this
    • hhu_8
  10. let’s install modules
    • launch PowerShell as an administrator
    • change directory to \Sitecore.HabitatHome.Utilities\XP\install
    • execute .\install-modules
    • hhu_11.png
    • you will be prompted for your https://dev.sitecore.net/ credentials – the required assets will be downloaded automatically if any, otherwise click Cancel button
    • hhu_6
    • hopefully you can see something like this
    • hhu_14.png
  11. download or clone the git repo from Habitat Home
  12. Note: I don’t want to use the default settings so I need to adjust the appropriate values in cake-config.json: (thanks Kim Cu for his contribution to migrate build and deploy from Gulp to Cake)
    • hhu_13.png
  13. deploy Sitecore.HabitatHome.Content
    • launch PowerShell as an administrator
    • change directory to \Sitecore.HabitatHome.Content
    • execute .\build
    • hhu_15.png
    • Note: you may see the following issue with Sync-Unicorn step, just execute .\build one more time
    • hhu_16
    • hhu_17.png
  14. 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 OKbutton to save
    • hh902_4.png
  15. refresh https://habitathome.local, you would see something like this
    • hh902_1

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 “Playing with Sitecore.HabitatHome.Utilities on your machine

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.