Sitecore 9.1 - Quick Installation

The format of this blog post is pretty simple - as the Sitecore 9.1 Quick Installation Guide is pretty comprehensive (and it’s “official”), I suggest you follow their guide to install a developer instance of Sitecore. But I’ve added a few “annotations” in this post which might be helpful, which you can read alongside Sitecore’s guide - the numbering system I’ve used matches the Quick Installation Guide (at the time of December 2018). I’m assuming you are reading Sitecore’s guide from top to bottom and following the instructions as you go. If I’ve not mentioned a point from the official guide below, then in my opinion it’s fairly obvious what you need to do...

 

 Sitecore logo

 

Quick Installation Guide annotations 

Read the official Sitecore 9.1 Quick Installation Guide whilst referring back to these points ...

1.1 “.NET Core 2.1.3 Windows Hosting module” - don’t worry about installing this now, as “Prerequisites.json” covers this later on

1.3 “.NET Framework 4.7.1” - don’t worry about installing this now, as “Prerequisites.json” covers this later on

1.3 “.NET Core Runtime 2.1.3” - don’t worry about installing this now, as “Prerequisites.json” covers this later on

1.4. “Microsoft Visual C++ 2015 redistributable requirements” - don’t worry about installing this now, as “Prerequisites.json” covers this later on

1.5 Visual Studio - Obviously you’ll need Visual Studio to write custom code that integrates with Sitecore, but it’s not needed to run the vanilla Sitecore instance

1.6 Database Requirements - here I installed SQL Server 2017 Developer Edition, choosing the “Basic” installation type. I then set SQL to run in mixed mode (see screenshot below), enabled the “sa” user account and restarted the “SQL Server” Windows service.

Setting SQL 2017 to mixed mode

1.6.1 “Microsoft ODBC Driver 13 for SQL Server” - it looks like this already got installed as part of SQL Server 2017 (it also appears to be present in “Prerequisites.json” too)

1.6.1 “Microsoft Command Line Utilities 13 for SQL Server” - don’t worry about installing this now, as “Prerequisites.json” covers this later on

1.7 Search Indexing Requirements - here I used Viet Hoang’s PowerShell scripts to install Solr, which is detailed on his blog - the scripts can be found here and here (copy both to the same directory and run install-solr.ps1 in an elevated powershell session.)

1.8 Antivirus software considerations - if you’re going to make these changes, it’s probably easier to do this at the end of the installation process, when all the relevant folders and app pool users have been created. I’ve put a note at the end to remind us to come back to this

1.11 Enable Contained Database Authentication - you should have done this earlier on, but if not, no matter, here’s your second chance! Sitecore’s guide is not always clear about whether it’s saying “do this” or “here’s how to do this”...

1.12 Install Solr and 1.12.1 Install the Solr Certificate - if you’ve used the PowerShell script from 1.7 earlier on, nothing more needs to be done here and you can skip to section 2.

3.2 / 3.3 - these are the changes I made to the SIF configuration files:

  • IdentityServer.json
    • Changed the value of the "Site.PhysicalPath" variable to be “D:\\Websites\\Sitecore 9.1.0 rev. 001564\\Identity” (this sets the location where the Identity website files will be put - you don’t need to create this directory yourself)
  • Xconnect-xp0.json
    • Changed the value of the "Site.PhysicalPath" variable to be “D:\\Websites\\Sitecore 9.1.0 rev. 001564\\XConnect” (this sets the location where the XConnect website files will be put - you don’t need to create this directory yourself)
  • sitecore-XP0.json
    • Changed the value of the "Site.PhysicalPath" variable to be “D:\\Websites\\Sitecore 9.1.0 rev. 001564\\Sitecore” (this sets the location where the Sitecore website files will be put - you don’t need to create this directory yourself)
  • XP0-SingleDeveloper.ps1 - I changed the value of the following variables:
    • $Prefix - I set this to “sitecore910” (Solr cores and SQL database names will be prefixed by this value)
    • $SCInstallRoot - I set this to “D:\Sitecore 9.1.0 rev. 001564 (WDP XP0 packages)" (Note that before running  “.\XP0-SingleDeveloper.ps1” I made sure that all the relevant JSON files, the Sitecore license file and the WDP packages were sat in the same folder as the XP0-SingleDeveloper.ps1 file - this is the path of that folder)
    • $XConnectSiteName - I set this to "sc910xconnect.local" (The hostname to be used for the XConnect website, plus it's used as part of the names for the Marketing Automation Engine, Processing Engine and XConnect Search Indexer Windows services. It’s also used to name the site in IIS, and to name the IIS app pool used for the site, and therefore the app pool identity)
    • $SitecoreSiteName - I set this to "sc910sitecore.local" (The hostname to be used for the Sitecore website. It’s also used to name the site in IIS, and to name the IIS app pool used for the site, and therefore the app pool identity)
    • $IdentityServerSiteName - I set this to "sc910identity.local" (The hostname to be used for the Identity website. It’s also used to name the site in IIS, and to name the IIS app pool used for the site, and therefore the app pool identity)
    • $SolrUrl - I set this to "https://localhost:8984/solr" (The hostname and port should match the Solr instance we installed earlier on)
    • $SolrRoot - I set this to "D:\Solr\solr-7.2.1" (Should match the location of the Solr instance we installed earlier on)
    • $SolrService - I set this to "solr-7.2.1" (Should match the name of the Windows service for the Solr instance we installed earlier on)
    • $SqlServer - I didn’t need to change this, but you may have to - for example, if your relevant SQL instance is not the default instance
    • $SqlAdminPassword - I set this to “password" (Should match the password of the “sa” SQL account)

After running the installation, everything looked good apart from the Identity site, which looked like this:

HTTP Error 502.5

Restarting my computer sorted this however :)

If you want to follow the suggestions in “1.8 (Antivirus software considerations)” then now is probably the best time to make them.

 

That's it?

Yes that's all, you should now have a fully working Sitecore instance based on the XP0 topology. SIF makes it pretty straightforward, this was the simplest Sitecore install of recent years :)