Sitecore 9.1 – Local Installation

This guide will help you to install Sitecore 9.1 for local environments. 

Requirements

Solr Setup

Sitecore 9.1 XP requires Solr with SSL enabled. You can use this guide in order to create a self-signed certificate. 

Check this quick guide on how to enable SSL on Solr.

Sitecore Installation Framework (SIF)

SIF is a module required to install Sitecore. If you want to know more about it, visit the Sitecore Developer site

First, we need to confirm which version of PowerShell is installed in our machine. Use the command $PSVersionTable to check the current version

2018-11-30 12_44_34-Window

Here we can see that our current version is 5.1.* which is a prerequisite to install Sitecore 9.1.

Then, we need to execute the following scripts to install SIF successfully. Remember to open PowerShell in administrator mode.

# Register the Sitecore Repository
Register-PSRepository -Name SitecoreGallery -SourceLocation https://sitecore.myget.org/F/sc-powershell/api/v2
# Install the Sitecore Install Framwork module
Install-Module SitecoreInstallFramework

If you already have the SIF module installed and just want to update it. Use the following script:

# Update the Sitecore Install Framwork module
Update-Module SitecoreInstallFramework

You can also install Sitecore Fundamentals which is a PowerShell module that is used to configure security certificates and transport level security for Sitecore websites. Sitecore Fundamentals is automatically installed when you install SIF.

# Install the Sitecore Fundamentals module
Install-Module SitecoreFundamentals

In order to validate the installation, we can use the following command

# Validate the installation
Get-Module SitecoreInstallFramework –ListAvailable

2018-11-30 12_53_23-Window

Here you can see the installed versions in the current machine. 

Sitecore 9.1

Download Sitecore 9.1.0 rev. 001564 (WDP XP0 packages) from the Developer Site – select the Packages for XP Single (XP0) Instance configuration. This is the correct resource if you want to install it locally. 

Create a folder under the root path (c:\). Extract the file and you will see four packages.

2018-11-30 14_36_12-Window

Extract, in the same folder, the file XP0 Configuration files 9.1.0 rev. 001564.zip which has the main configuration files. 

2018-11-30 14_38_20-Window

Do not forget to paste your Sitecore license.xml file in the same folder.

First, we will need to install the prerequisites – this is one of the things new that differs from older Sitecore installations. Open PowerShell in administrator mode and navigate where your files were unzipped and execute the following command. 

Install-SitecoreConfiguration -Path .\Prerequisites.json

Once it{s completed, a reboot might be needed.

Next, you need to edit the script XP0-SingleDeveloper.ps1. Update each
line with the settings that are applicable to your environment.

2018-11-30 14_47_34-Window

One of the settings you should consider changing is SitecoreAdminPassword. By default, it has “SIF-Default” which means that the admin password will be auto-generated. The admin password is not “b” anymore unless you specify it as its value

$SitecoreAdminPassword = “b”

Once you have confirmed all the values and saved the script, we will need to run that script.

2018-11-30 15_06_29-window

It will take some time to complete the process but in the end, you will see the generated password. 

2018-11-30 14_52_43-Window

You can also check the logs (XP0-SingleDeveloper.log) 

[---------------------------- SitecoreXP0_UpdateSolrSchema : SitecoreUrl ---------------------------------------------]
[SitecoreXP0_UpdateSolrSchema]:[Authenticating] http://sc910.sc/sitecore/admin/PopulateManagedSchema.aspx?indexes=all
[SitecoreXP0_UpdateSolrSchema]:[Requesting] http://sc910.sc/sitecore/admin/PopulateManagedSchema.aspx?indexes=all
[SitecoreXP0_UpdateSolrSchema]:[Success] Completed Request

[----------------------------- SitecoreXP0_DisplayPassword : WriteInformation ----------------------------------------]
Sitecore Admin Password: JEw2fYRIbLU7ENMP1weQ
[TIME] 00:15:13

Finally, browse to your site, which is $SitecoreSiteName = “$prefix.sc” (i.e. http://sc910.sc/sitecore) and verify that Sitecore login page shows up.  

Go to the control panel and do these three important things:

1. Rebuild your indexes

2018-11-30 15_36_28-Control Panel

2. Rebuild link databases

2018-11-30 15_35_49-Control Panel

3. Deploy Marketing definitions

2018-11-30 15_35_04-Control Panel

….and now you have Sitecore 9.1 up and running

Happy Sitecoring 😉

Leave a comment