Prerequisites

  • .Net Framework 4.6.2 or later
  • Visual Studio 2017
  • IIS
  • SQL Server & SQL Server Management Studio (SSMS)
  • JDK
  • Solr 6.6.2 running as a service with SSL
  • Sitecore Installation Framework (SIF) & Sitecore Fundamentals
  • Microsoft Web Deploy
  • SIFLess

 

.Net Framework

You can check the installed version using Programs and Features.

Go to https://www.microsoft.com/en-us/download/details.aspx?id=56116 and download then run.

Install Visual Studio

Go to https://www.visualstudio.com/vs/community/ download and follow the prompts.

Enable IIS

IIS is disabled by default on a clean install of Windows 10.  To enable it go to Programs and Features. Click “Turn Windows features on or off’ in the pop-up select Internet Information Services, use the default configuration.

Use a browser to request http://localhost/ to make sure it is working.

Install SQL Server Express 17

SQL Server can be downloaded here: https://www.microsoft.com/en-au/sql-server/sql-server-editions-express

Because I am just creating a sandbox I accepted the Basic install option.  Amongst other things this means that my instance is called ‘localhost\SQLEXPRESS’

When the basic install has completed there is a button to install SSMS, use this to launch the process once installation has completed restart.

One minor problem with the basic install is that it uses Windows authentication, to enable SQL Server Authentication follow the process here: https://docs.microsoft.com/en-us/sql/database-engine/configure-windows/change-server-authentication-mode

Enable Contained Database Authentication by running a New Query

sp_configure ‘contained database authentication’, 1;

GO

RECONFIGURE;

GO

JDK

Download the JDK executable here: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html run accepting the defaults.  Set JAVA_HOME to point to the folder containing your JDK (C:\Program Files (x86)\Java\jdk1.8.0_152 for example); if you are using JRE then the variable is JRE_HOME. 

Solr 6.6.2

Install

Download Solr from http://archive.apache.org/dist/lucene/solr/6.6.2/ select Solr-6.6.2.zip from the list and save.  Once the download has completed extract the archive to your preferred location, I used the root of C:.

Start as a service

I used NSSM to create the Solr service. Download here: https://nssm.cc/download, note the new version for Windows Creators Update if that is the version of Windows you are using.

Extract and move NSSM.exe from the win64 folder to somewhere easily accessible.  Open a PowerShell window running as Administrator.  Move to the same folder as NSSM.exe.  Issue the command .\nssm install Solr_6.6.2.

In the pop-up select the path to solr.cmd; in my case C:\solr-6.6.2\bin\solr.cmd.  The Startup directory field will populate automatically. Enter ‘start -f -p 8983’ click Install Service.  The -f makes the service run in the foreground -p specifies the port. nssm

Go to http://localhost:8983/solr/#/ to verify everything is working.

Setup SSL & HTTPS

In a PowerShell (running as Admin) enter ‘Set-ExecutionPolicy -Scope CurrentUser Unrestricted’

Download solrssl.ps1 from https://gitlab.com/viet.hoang/workshop/blob/master/Scripts%20for%20Sitecore%209/solrssl.ps1 Thanks to Viet Hoang. 

Run the script and move the resulting files to the $SolrHome\server\etc.  They will be located in the same folder as solrssl.ps1.

SSLFiles 

Edit $SolrHome\bin\solr.in.cmd to add or uncomment the following lines:

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

set SOLR_SSL_KEY_STORE_PASSWORD=secret

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

set SOLR_SSL_TRUST_STORE_PASSWORD=secret

Restart the Solr service and in a browser go to https://localhost:8983/solr/

Install SIF & Sitecore Fundamentals

Login to https://dev.sitecore.net and download: Packages for XP Single (use this for developer installations)

Extract into your working directory.  Them in Sitecore 9.0.0 rev. 171002 (WDP XP0 packages) extract XP0 Configuration files rev.171002

Use PowerShell (running as Admin) to install SIF.  First run Register-PSRepository -Name SitecoreGallery -SourceLocation https://sitecore.myget.org/F/sc-powershell/api/v2 to register the Sitecore Gallery.  If prompted to install NuGet provider accept.

Add SitecoreGallery as a trusted repository by running Set-PSRepository.

Then run Install-Module SitecoreInstallFramework.

Install Web Deploy

Go to https://www.microsoft.com/en-us/download/details.aspx?id=43717 to download Microsoft Web Deploy and run the msi to install Web Deploy.

Use SIFLess to install Sitecore

Download SIFLess from:  http://www.rockpapersitecore.com/2017/10/introducing-sif-less-for-easy-sitecore-9-installation/  many thanks to Rob Ahnemann for a (relatively) pain free way to install Sitecore9!  Follow the instructions.

In EZ Mode my settings looked like

 SIFLess

Once you can pass the Test on all topics hit the Generate or Generate Files and Install button.

Go put the kettle on.

Thanks to:

·         https://buoctrenmay.wordpress.com/2017/10/30/a-step-by-step-guide-for-sitecore-9-installation-on-your-machine/

·         http://www.rockpapersitecore.com/2017/10/introducing-sif-less-for-easy-sitecore-9-installation/

 

 

Advertisements