guide

A step by step guide for Sitecore 9 installation on your machine

This one is a summary of my own experience for Sitecore 9 installation on my machine. I read a lot of articles + blog posts and decided to go with these ones below:

  1. Sitecore 9 Installation Guide (Note: must log into https://dev.sitecore.net/ before downloading) (Thank Sitecore team!)
  2. Gotchas while installing Sitecore 9 using the Sitecore installation framework by Bas Lijten (Thank you!)
  3. Getting Up and Running with Sitecore 9 by Parashar Mehta (Thank you!)

Happily, I was able to install Sitecore 9 successfully on my machine so that I wanted to write down a step by step guide for myself and for everyone. Hopefully, it’s helpful for your own journey.

Setup Prerequisites

Step by step guide

  1. install Windows 10 if not yet 😀
  2. install MS SQL Server 2017 if not yet
    • click here to download (Developer Edition for free)
  3. install MS SQL Management Studio 17 if not yet
    • click here to download
  4. create a new folder D:\sc9_install
  5. install SOLR 6.6.1 if not yet
    • click here to download
    • copy / paste solr-6.6.1.zip to D:\sc9_install and unzip it
    • open Command Prompt (run as administrator)
    • sc9_1
    • open a browser, navigate to http://localhost:8983/
    • you would see something like this
    • sc9_2.png
  6. make SOLR 6.6.1 run as a window service
    • download NSSM and install it
    • copy / paste nssm-2.24.zip to D:\sc9_install and unzip it
    • open Command Prompt (run as administrator)
    • sc9_3.png
    • make sure your Solr_6.6.1 window service is running
    • sc9_4.png
  7. set up HTTPS for SOLR 6.6.1
    • download Java Runtime Environment and install it if not yet
    • download solrssl.ps1 and put it into D:\sc9_install
    • open Windows PowerShell (run as administrator)
    • sc9_5
    • note: you may see the error below
      • sc9_15
    • if that is the case, open Windows PowerShell (run as administrator)
      • Set-ExecutionPolicy -Scope CurrentUser Unrestricted
      • sc9_14
    • copy / paste D:\sc9_install\solr-ssl.keystore.jks and D:\sc9_install\solr-ssl.keystore.p12 to D:\sc9_install\solr-6.6.1\server\etc
    • sc9_6.png
    • open D:\sc9_install\solr-6.6.1\bin\solr.in.cmd and add the lines below to it
      • 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 Solr_6.6.1 window service
    • open a browser, navigate to https://localhost:8983/
    • sc9_7
  8. install Sitecore Install Framework if not yet
    • refer to 3.2.1 Installing the Installation Framework Module Using MyGet (Page 20) in Sitecore 9 Installation Guide
    • open Windows PowerShell (run as administrator)
    • use the following commands to install the latest version of SIF
      1. Register-PSRepository -Name SitecoreGallery -SourceLocation https://sitecore.myget.org/F/sc-powershell/api/v2
      2. Install-Module SitecoreInstallFramework
      3. Update-Module SitecoreInstallFramework
  9. enable Contained Database Authentication if not yet
  10. download and unzip Package for XP Single (Note: must log into https://dev.sitecore.net/ before downloading)
    • copy / paste Sitecore 9.0.0 rev. 171002 (OnPrem)_single.scwdp.zip to D:\sc9_install
    • copy / paste Sitecore 9.0.0 rev. 171002 (OnPrem)_xp0xconnect.scwdp.zip to D:\sc9_install
    • unzip XP0 Configuration files rev.171002.zip and copy / paste all files to D:\sc9_install
    • sc9_13
  11. copy / paste Sitecore licence file (license.xml) to D:\sc9_install
  12. download sc9_install.ps1 and copy / paste it to D:\sc9_install then open it to correct 03 parameters below:
    • $SqlServer
    • $SqlAdminUser
    • $SqlAdminPassword
  13. open Windows PowerShell (run as administrator)
    • sc9_12.png
    • hopefully there is nothing can stop the installation process now then open a browser, navigate to http://sc9.sc/ and http://sc9.sc/sitecore/ (log into it by using super famous account admin / b)
    • This slideshow requires JavaScript.

  14. DO NOT forget to perform Post-Installation Steps
    • follow Chapter 6 Sitecore XP Post-Installation Steps (Page 37 – 44) in Sitecore 9 Installation Guide
    • Note: you should download the script for 6.1 Add a Recognized User to the xDB Shard Databases here, otherwise you have to update DatabasePrefix from xp1 to sc9

Note: some known issues

  1. Failed to start service ‘Sitecore XConnect Search Indexer…
    • due to Sitecore license limitation: you would see this one in the log file Required license is missing: Sitecore.xDB.Base
    • sc9_16
  2. you’re using Windows Powershell ISE instead of Windows Powershell
    • sc9_17.png
  3. Unable to connect to master or target server ‘xxx_Processing.Pools’. You must have a user with the same password in master or target server ‘xxx_Processing.Pools’
    • sc9_18
    • my suggestion: take a look at this blog post in order to be able to overcome it
  4. The SQL provider cannot run because of a missing dependency. Please make sure that Microsoft SQL Server Transact-SQL ScriptDom is installed
    • open Command Prompt (run as administrator)
    • run this command “C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0A\Bin\x64\gacutil” /i “C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Binn\ManagementStudio\Extensions\Application\Microsoft.SqlServer.TransactSql.ScriptDom.dll”
    • note: C:\Program Files (x86) may be different on your own machine
  5. Error CREATEing SolrCore…
    • SOLR 6.6.1 has a core lock bug, you should have a try with SOLR 6.6.2
  6. The process cannot access the file because it is being used by another process…
    • my suggestion: DO NOT play with Skype during installation, because of port 443 is in used and xConnect installation would fail

My recommendation:

Got issues?

Please send your issues (with screenshots if possible) to viet.hoang.sitecore@gmail.com so that I have a chance to understand your problem and be able to suggest the solution.

Happy Sitecore 9 Installation!

 

Advertisements

5 thoughts on “A step by step guide for Sitecore 9 installation on your machine

  1. Hi,

    In Step 7, I am getting certificate related issue.

    Generating .p12 to import to Windows…
    Importing keystore solr-ssl.keystore.jks to solr-ssl.keystore.p12…
    keytool error: java.io.FileNotFoundException: solr-ssl.keystore.jks (The system cannot find the file specified)

    Trusting generated SSL certificate…
    Import-PfxCertificate : The system cannot find the file specified. 0x80070002 (WIN32: 2 ERROR_FILE_NOT_FOUND)
    At C:\sc9_install\solrssl.ps1:59 char:9
    + $root = Import-PfxCertificate -FilePath $P12Path -Password $secureStringKeystore …
    + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo : NotSpecified: (:) [Import-PfxCertificate], Exception
    + FullyQualifiedErrorId : System.Exception,Microsoft.CertificateServices.Commands.ImportPfxCertificate

    Please help me on this issue

    Like

      1. I am trying to install it in a VM which uses Windows Server 2012 R2. So if i need to install the same in this, what are the steps?

        Like

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s