Sitecore 9.1: Installation

Sitecore has kicked their current version up to 9.1 and it offers a lot of new features. In this post, I'll walk you through installing a local Standalone instance for development.

Sitecore 9.1 is offically released, and the world rejoiced! Or at least, certain people of a small sub-community of the world rejoiced.

Sitecore 9.0 offered a lot of new cool features, but also a lot of new things to learn, of which installing it was not the least... The complexity of installing a Sitecore instance changed drastically between Sitecore 8 and Sitecore 9, and I know I'm not the only one who feels like every time I install a Sitecore 9 instance, I run into some new error. But here we are with a brand new version which promises to solve a lot of the old headaches with installation, along with a host of other cool features. This post will focus on installation, but be sure to ask old google about what's new in Sitecore 9.1 and you'll get tons of info.

Prerequisites

SIF (Sitecore Installation Framework)

If you've installed 9.0, you'll be familiar with SIF. If you haven't used it before, I'll give you the shortest of rundowns: It's an official Powershell module provided by Sitecore that helps you install Sitecore through JSON-configuration templates. It was released alongside Sitecore 9.0. They have however pushed the version from 1.x to 2.0 for SC 9.1, so be sure to install SIF 2.0. You can do this easily with below commands (You might be prompted to accept the myget source).

install_sif

Solr

One of the changes in Sitecore 9 was the move from Lucene as default search provider to Solr (which is based on Lucene), and then 6.6.2 was the specified version. For Sitecore 9.1, we kick the Solr version up to 7.2.1. So if you are already running a 6.6.2 server for existing SC9 installations, I recommend you to not try and reuse this for 9.1 as well, instead install a parallell 7.2.1 server (that runs on a different port than the existing one). And with a little help from Jeremy Davis, this is incredibly easy. You simply run a powershell-script that takes care of everything for you; downloading, installing, self-signed certificate and so on. You can find a prepped version of it on my github here.

The only thing you might need to do (besides potentially changing the port) is change the java-version parameter to the version you have installed. Your JRE is usually installed at this location: C:\Program Files\Java. If you are unsure of your version, take a peek there.

solr_installation_params
 

Aaand the rest...

For 9.0, Sitecore provided us with topology specific resources alongside their official installation guide. The guide contained an example powershell-script that you'd copy and then modify the parameters, and while we all love to copy code spanning multiple pages from a PDF, this time around Sitecore has seen fit to provide us with this installation script alongside the other resources, which is much better. But first you'll need to download the installation resources from the Sitecore 9.1 downloads page. Just choose your desired toplogy. In our case we are installing a developer instance, so we'll use the XP-Single topology. Unpack the contents to your desired location, so that the JSON configuratios and wdp-packages are alongside each other in the same directory. Also, put your license.xml in the same directory.

For reference, here's what my resource directory looked like:

resources directory

 

One of the things that made 9.0 such a hassle to install was all the prerequisites, some of which were properly documented, and some (*cough* a lot) which were not. Sitecore 9.1 gives us a prerequisites JSON template! So all you need to do is install SIF 2.0 and run the following: (And pray to prefered deity that your prerequistes don't have their own missing prerequisites...)

install_prereqs
 

And you should be good to go as far as prerequisites are concerned. If you still run into any trouble during this step, be sure to check out the official installation guides on the Sitecore 9.1 downloads page. 

Installation

Once you've gone through above steps, all you need to do is modify the parameters of your XP0-SingleDeveloper.ps1 before you run it. I've included mine below for reference. Be sure to read the comments, as they indicate what you need to modify for your personal installation.

powershell_installation_params
 

And now you should be good to go. Fire up your powershell prompt (or ISE if you prefer) as administrator and run the XP0-SingleDeveloper.ps1 script. My experience says you have about 15-20 minutes of script execution on your hands. Given that all above steps have been applied properly, it'll run without prompting for input or crashing on any errors. I'd keep an eye on the output just in case, and if you do run into any errors, I'd again recommend you to refer to the official installation guides to see if you are missing any prerequisites that the prerequisites.json did not cover.

 

 

04 Dec 2018, by Bonny Nilsson | 

Sitecore 9.1, Installation, SIF, Powershell