Sitecore XP 10.2 Initial Release – Installation – SIF Way

Certainly, we should use Docker containers for installing Sitecore 10.2 Initial Release as that way is to support rapid deployment + more efficient solution and team onboarding. Personally, I wanted to keep playing around with Windows PowerShell console so I have a good chance to dive deeper into the problem of the install operation if any.

This blog post is a summary of my own experience for Sitecore Experience Platform 10.2 Initial Release (aka Sitecore version 10.2.0) installation by using Sitecore Install Framework (SIF) version 2.3 on my machine with the following install guide:

• Quick Installation Guide for a Developer Workstation (Thanks Sitecore team!)

I do hope that this blog post is helpful for your own journey as well.

Note: since Sitecore 9.3, by default, we have been able to use our own install directory rather than the default one

Setup Prerequisites

• Windows 10
• Windows PowerShell version 5.1 or later
• Sitecore License must have xDB enabled
• Microsoft SQL Server 2017 or later
• .Net Framework 4.8.0 or later
• .NET Core 3.1 Windows Hosting Bundle or later.
• Web Deploy 3.6
• URL Rewrite 2.1
• SOLR 8.8.2
• Red Hat OpenJDK 8 (64-bit)
• Sitecore Install Framework (SIF) 2.3.0
• Packages for XP Single
• ensure to enable the Transport Layer Security (TLS) protocol version 1.2

Step by step guide

1. (optional) if you have never installed Sitecore 9 and later, you will probably want to:
   • open Windows PowerShell (run as administrator)
   • execute Set-ExecutionPolicy -Scope CurrentUser Unrestricted
   • 
2. (optional) install Sitecore Install Framework (SIF) if not yet
   • 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. (optional) if you already installed previous SIF versions, you would have upgraded it to a new version 2.3.0
   • open Windows PowerShell (run as administrator)
   • you should use the following command to get all the the current SIF versions
     • Get-Module -Name SitecoreInstallFramework -ListAvailable
   • option 1: use the following command to update to the latest version of SIF
     • Update-Module SitecoreInstallFramework -force
     • 
   • option 2: use the following commands to remove the currents and then install the latest version of SIF
     • Uninstall-Module SitecoreInstallFramework -AllVersions
     • Install-Module SitecoreInstallFramework
4. enable Contained Database Authentication if not yet
   • 
   • Note: you can download the above query.
5. create a new folder D:sc1020_install
6. download and unzip Package for XP Single
   • copy / paste the following ones to D:sc1020_install
     1. Sitecore 10.2.0 rev. 006766 (OnPrem)_single.scwdp.zip
     2. Sitecore 10.2.0 rev. 006766 (OnPrem)_xp0xconnect.scwdp.zip
     3. Sitecore.IdentityServer 6.0.0 rev. 00301 (OnPrem)_identityserver.scwdp.zip
   • unzip XP0 Configuration files 10.2.0 rev. 006766.zip and copy / paste all files to D:sc1020_install
   • 
7. let’s install the prerequisites
   • open Windows PowerShell (run as administrator)
   • change directory to D:sc1020_install
   • execute Install-SitecoreConfiguration -Path prerequisites.json
   • 
   • Note: Sitecore prerequisites are now installed, YOU MUST launch a new PowerShell session to run further SIF configurations
   • 
8. install SOLR 8.8.2 if not yet
   • adjust appropriate values by editing D:sc1020_installSolr-SingleDeveloper.json such as SolrPort, SolrInstallRoot if necessary
   • 
   • open Windows PowerShell (run as administrator)
   • change directory to D:sc1020_install
   • execute Install-SitecoreConfiguration -Path Solr-SingleDeveloper.json
   • 
   • 
9. copy / paste your Sitecore license file license.xml to D:sc1020_install
10. adjust appropriate values by editing D:sc1020_installXP0-SingleDeveloper.ps1 such as:
    • $Prefix
    • $SitecoreAdminPassword
    • $SCInstallRoot
    • $SitePhysicalRoot
      • note: DON’T use double backslash in the folder path (for instance C:websites) otherwise you may get the following error Failed to start service ‘Sitecore Marketing Automation Engine
    • $SolrUrl
    • $SolrRoot
    • $SqlServer
    • $SqlAdminUser
    • $SqlAdminPassword
    • 
11. open Windows PowerShell (run as administrator)
    • (optional) if you have various SIF versions on your machine, you will probably have to run 2.3.0 version of SIF by executing Import-Module SitecoreInstallFramework -Force -RequiredVersion 2.3.0
    • change directory to D:sc1020_install
    • execute .XP0-SingleDeveloper.ps1
    • 
12. hopefully there is nothing can stop the installation process and then note Sitecore Admin Password + SSL enabled as well
    • 
13.  open a browser:
    • navigate to https://sc1020.sc/ to see the Sitecore default page
    • navigate to https://sc1020.sc/sitecore and then be redirected to https://sc1020.identityserver/ (log into it by using account admin / [Sitecore Admin Password])
    • 
14. DON’T FORGET to rebuild the search indexes and the Link database
    • 

How to uninstall it?

• open D:sc1020_installXP0-SingleDeveloper.ps1 and uncomment the line 85 + comment out the line 82 then save it
• 
• open Windows PowerShell (run as administrator)
• change directory to D:sc1020_install
• execute .XP0-SingleDeveloper.ps1
• hopefully, it runs well and cleans everything up
• 

Got issues?

Please send your issues (with screenshots if possible) to [email protected] so that I have a chance to understand your problem and be able to suggest the solution.

Happy Sitecore Experience Platform 10.2 Initial Release Installation!

This article originally appeared on Walking on clouds (https://buoctrenmay.com/).