By now you probably know installing Sitecore 9 is a bit different to previous versions and instead of using an installer the process involves using The Sitecore Install Framework (or SIF) to install Sitecore.
When Sitecore 9 first came out I made numerous attempts to install it on my Windows 8.1 machine and couldn’t get it to work due to an issue with SSL certs for xConnect. Apparently it’s possible to get working but I couldn’t get past the issue so decided I’d upgrade to Windows 10 instead.
Sitecore 9 Update-1 came out earlier this week and after upgrading to Windows 10 over the Christmas break I decided it was time to have another go.
I’ve kept a close eye on the Community tools and blog posts for helping with installing Sitecore 9 over the past two months and think the approach I have outlined below is pretty quick and fairly simple.
First up you need to make sure you have the following in place to follow this guide:
- Windows 10
- Sql Server 2014 or 2016 SP1 (for xdb)
- IIS 8.5 > 10 (IIS 8 is not supported by SIF)
- Java Runtime Environment (JRE) version 1.8 or higher: (required for Solr 6.6.2 ) http://www.oracle.com/technetwork/java/javase/downloads/jre9-downloads-3848532.html
- Powershell v5.1 (you can check your version by running: $PSVersionTable.PSVersion)
- Web Deploy 3.6 for Hosted Servers (using Web Platform Installer in IIS)
- A Sitecore Licence
Step 1 – Install Solr
Other than the above prerequisites Solr is a core requirement for Sitecore 9+. Solr must be installed running SSL and for Sitecore 9 Update 1 Solr 6.6.2 is a requirement (not 6.6.1)
By far the easiest way I’ve found to do this is to use the awesome Power Shell script that Jeremy Davis wrote. It downloads Solr 6.6.2 and installs it with NSSM with SSL enabled. Just copy the gist below to your machine and save it as Install-Solr.ps1.
You should be able to leave everything as it is other than:
- The $JREVersion variable – this should be the same as your Java version
- The $JREPath – this should be the path to your Java version
more info here: https://jermdavis.wordpress.com/2017/10/30/low-effort-solr-installs/.
Once the script completes you should see Solr open in a browser and look like this:
Step 2 – Prepare Your Install Folder
The next step is to save the files you need to install Sitecore 9 Update 1 to the correct location for the install.
- Create an install folder on your machine, I decided on ‘C:\Sitecore9-Install\resources’.
- Download the ‘Sitecore 9.0.1 rev. 171219 (WDP XP0 packages).zip’ install file from here: https://dev.sitecore.net/~/media/8551EF0996794A7FA9FF64943B391855.ashx
- Unblock and Unzip the folder
- Copy ‘Sitecore 9.0.1 rev. 171219 (OnPrem)_single.scwdp.zip’ and ‘Sitecore 9.0.1 rev. 171219 (OnPrem)_xp0xconnect.scwdp.zip’ from the unzipped folder to ‘C:\Sitecore9-Install\resources’
- Unzip ‘XP0 Configuration files 9.0.1 rev. 171219.zip’ and also copy the contents into: ‘C:\Sitecore9-Install\resources’
- Lastly copy your Sitecore licence file into ‘C:\Sitecore9-Install\resources’ also.
Your install folder should look like so:
Step 3 – Install SIF
The next step is to install SIF so that you can use it to Install Sitecore. Save the following powershell script to your machine as Install-Sif.ps1 and run it with the correct admin permissions:
Step 4 – Install Sitecore 9 Update 1
Finally you can Install Sitecore. Save the following Powershell Script to your machine as Install-Sitecore9.ps1. It is from the official Sitecore 9 Update 1 install guide.
Edit the following paramaters:
- $prefix – I set this to ‘sc91′ but you can call your instance what you want
- $PSScriptRoot – set this to your install folder location, e.g: ‘C:\Sitecore9-Install\resources’
- $SolrUrl – Set this to the path of your Solr instance you installed at Step 1. e.g: ‘https://solr-sc9:8983/solr’
- $SqlServer – Set this to the name of your local SQL Instance, mine is ‘./’ (you may need to use this format for a named instance: “.\SQL2016″)
- $SqlAdminUser – Set this to a user that has permissions to create databases, I used the ‘sa’ account
- $SqlAdminPassword – Set the password for the user above
Finally run the script with the correct admin permissions.
Wait for the script to run, It will take a few minutes to install everything.
It’s worth noting an alternative way to do this is to use Sif-less which uses SIF under the hood to install Sitecore but with a nice UI (a bit like SIM). However I decided to go with the standard Powershell install instead this time round.
Hello Sitecore 9…
All being well you should have an new Shiny Sitecore 9 Update 1 instance installed. You can now run the post install steps for xConnect (see the guide below).
You can find more info and the official install guide here: https://dev.sitecore.net/Downloads/Sitecore_Experience_Platform/90/Sitecore_Experience_Platform_90_Update1.aspx
Lastly thanks to the Community for these Blog posts (and others) that have helped with putting this together: