ASP.NET, CMS

Sitecore 9.1 Installation Guide

Sitecore 9.1 initial release is available to download from https://dev.sitecore.net/Downloads/Sitecore_Experience_Platform/91/Sitecore_Experience_Platform_91_Initial_Release.aspx

Sitecore 9.1 have great improved features like

  • Sitecore Cortex
  • Sitecore Omni
  • The Universal Tracker

 

This post is about the installation of Sitecore 9.1 on development machine.

Pre-Requisite

 

Assets Quantity/Capacity Download Link
Hardware configurations
Processor i7
HDD 256GB SSD or More
RAM 16 GB
Drive C, D
Softwares
Windows 10 PRO
.NET Framework 3.5
.NET Framework 4.6.2 Developer Pack Link
.NET Framework 4.7
.NET Framework 4.7.1 Developer Pack Link
.NET Framework 4.7.2 Developer Pack Link
.NET Core 2.1.3 Windows Hosting module Link
Microsoft PowerShell® version 5.1 or later
Web Platform Installer 5.0 Link
IIS 10.0 or later
Web Deploy 3.6 for Hosting Servers
URL Rewrite 2.1
SQL Server 2017 – Express Edition Link
SQL Server Management Studio 17.9 Link
Visual Studio 2017 Professional Link
JAVA Runtime 8.8 or Later
NSSM 2.24 Link
Node.js Link
SOLR 7.2.1 Link
Sitecore XP 9.1 Link
Sitecore License  
Notepad++
Permission for system
Local Admin rights

 

Installing Pre-requisite software and tools

 

  • Install “.NET Framework 3.5” from “Control Panel -> Programs -> Programs and Features -> Turn Windows features on or off” by selecting as shown below

  • Select the .NET Framework 4.7 Advanced Services with child items check box from “Control Panel -> Programs -> Programs and Features -> Turn Windows features on or off”, select OK, and reboot your computer if prompted as shown in above figure.

 

  • Install “Internet Information Services” with all child items from “Control Panel -> Programs -> Programs and Features -> Turn Windows features on or off” as shown below

  • Install “Web Platform Installer 5.0” by downloading from Link.

 

  • Install Web Deploy 3.6 for Hosting Servers and URL Rewrite 2.1 from IIS Actions section “Get New Web Platform Components” as

  • Install SQL server and select mixed mode while installing

  • Install SQL server Management studio for SQL Server 2017 Express edition as.

 

  • After SQL installation run below script in master database.

 

sp_configure ‘contained database authentication’, 1

GO

RECONFIGURE

GO

 

  • Install Visual Studio 2017 Professional.

 

  • Download and install .NET Core 2.1 Runtime for Sitecore Identity service from Link.

 

  • Download and install “js” from link.

  • Open command Prompt in admin mode and install “nsm” and “gulp” at global level using below command

 

Npm install

Npm install -g gulp

  • Create folder “C:\resourcefiles91” for keeping Sitecore 9.1 related installation tools and resources

 

  • Download NSSM from link and unzip at “c:\resourcefiles91\nssm-2.24”.

 

Install Solr 7.2.1 & Enable SSL for SOLR (Self Signed Certificate)

 

One major changes in the Sitecore 9.1 is Search Component. By default, Solr 7.2.1 is the search provider.

Sitecore 9.1 required Solr as Secure Service so we have to enable SSL for Solr before beginning the installation.

  • Download Solr-7.2.1 from link and unzip the archive to “C:\” (where it will create a folder called “Solr-7.2.1”)

  • To setup Solr as service open NSSM in Command Prompt as administrator and run the following command:

 

c:\resourcefiles91\nssm-2.24\win64>nssm.exe install SOLR721

 

           

Note: – I am running SOLR services on port 8985 as I already have SOLR 6.6.2 running on port 8983.

  • Open “Services” and start “SOLR721” service.

 

  • Open a command prompt as an administrator and navigate to: C:\Solr-7.2.1\server\etc

 

“C:\Program Files\Java\jre1.8.0_121\bin\keytool.exe” -genkeypair -alias solr-ssl -keyalg RSA -keysize 2048 -keypass secret -storepass secret -validity 9999 -keystore solr-ssl.keystore.jks -ext SAN=DNS:localhost,IP:127.0.0.1 -dname “CN=localhost, OU=Organizational Unit, O=Organization, L=Location, ST=State, C=Country

Check if solr-ssl.keystore.jks file is created in ‘etc’ forder

  • Run importkeystore command and use “secret” for the destination keystore password (plus confirmation prompt) and source keystore password prompts

 

“C:\Program Files\Java\jre1.8.0_121\bin\keytool.exe” -importkeystore -srckeystore solr-ssl.keystore.jks -destkeystore solr-ssl.keystore.p12 -srcstoretype jks -deststoretype pkcs12

 

  • Import(double click) generated certificate file solr-ssl.keystore.p12 that was created in the C:\Solr7.2.1\server\etc directory. Match the values below when prompted:

 

Store Location: Local Machine
Password: “secret” (no quotes)
Certificate store: Trusted Root Certificate Authorities

 

  • Update the C:\solr-7.2.1\bin\solr.in.cmd file by pasting the following code block at the end of the file.

set SOLR_SSL_KEY_STORE=etc/solr-ssl.keystore.jks

set SOLR_SSL_KEY_STORE_PASSWORD=secret

set SOLR_SSL_KEY_STORE_TYPE=JKS

set SOLR_SSL_TRUST_STORE=etc/solr-ssl.keystore.jks

set SOLR_SSL_TRUST_STORE_PASSWORD=secret

set SOLR_SSL_TRUST_STORE_TYPE=JKS

set SOLR_SSL_NEED_CLIENT_AUTH=false

set SOLR_SSL_WANT_CLIENT_AUTH=false

 

 

  • Add following Lines to C:\solr-7.2.1\bin\solr.in.sh

SOLR_SSL_KEY_STORE=etc/solr-ssl.keystore.jks

SOLR_SSL_KEY_STORE_PASSWORD=secret

SOLR_SSL_KEY_STORE_TYPE=JKS

SOLR_SSL_TRUST_STORE=etc/solr-ssl.keystore.jks

SOLR_SSL_TRUST_STORE_PASSWORD=secret

SOLR_SSL_TRUST_STORE_TYPE=JKS

SOLR_SSL_NEED_CLIENT_AUTH=false

SOLR_SSL_WANT_CLIENT_AUTH=false

 

 

Install Sitecore

 

  • Download Sitecore 9.1 “Packages for XP Single” under section “Download options for On Premises deployment” from Link .

  • Unzip “Sitecore 9.1.0 rev. 001564 (WDP XP0 packages).zip” in “C:\resourcefiles91”.

Also unzip “XP0 Configuration files 9.1.0 rev. 001564.zip” into “C:\resourcefiles91”.

Copy your Sitecore license into the same folder “C:\resourcefiles91”.

Finally, you must have files like

  • Open “XP0-SingleDeveloper.ps1” and update values for SQL and SOLR as

  • Open Powershell in admin mode. Change directory to “C:\resourcefiles91”
  • Install SitecoreGallery as

 

Register-PSRepository -Name SitecoreGallery -SourceLocation https://sitecore.myget.org/F/sc-powershell/api/v2 -InstallationPolicy Trusted

 

  • If your machine machine already have SitecoreInstallFramework 1.2.1 but for Sitecore 9.1 we have to install SitecoreInstallFramework 2.0.0 as

Install-Module -Name SitecoreInstallFramework -RequiredVersion 2.0.0

 

  • You can get list of all available SitecoreInstallFramework module as

Get-Module SitecoreInstallFramework –ListAvailable

  • Close and open PowerShell in admin mode again to load the newly installed modules.
  • Close skype before running install script.
  • Change directory to “C:\resourcefiles91”. Run “XP0-SingleDeveloper.ps1”

 

After few minutes you should get below success message as

  • Open Sitecore by browsing URL http://sc910.sc/sitecore/login
  • Login via admin/b credentials.
  • Check License details for Sitecore Version 9.1.0 and .NET framework 4.7.1

 

 

Few observations

 

Identity Management

If you try to browse your Sitecore 9.1 website with http://sc910.sc/sitecore/login then it will redirect you to https://sc910.identityserver/account/login.

Sitecore is using identity management as a default single sign-on mechanism for XM, XP, and XC.

 

Pushing HELIX Guidelines

Sitecore is pushing HELIX principles for all Sitecore development projects. That’s why you will notice already created Foundation, Feature and Project items under layout, rendering and template in content tree as below

Websites in IIS

Sitecore is creating 3 websites in IIS for each installation.

  • Identity Server – This is for Sitecore identity management as a default single sign-on mechanism for XM, XP, and XC.
  • Sc – Actual website
  • xConnect – For analytics

 

SSL Certificates

Each installation creates 3 certificates for xConnect, Identity server and website as

SOLR Index

Check indexes in SOLR 7.2.1 instance for this installation as

 

About The Author