Sitecore XP 10.0 Update 2 – Installation – SIF Way

To keep up to date with trends, you should use Docker containers for installing Sitecore 10.0.2 to support rapid deployment + more efficient solutions and team onboarding. Personally, I wanted to keep playing around with the 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 with Sitecore Experience Platform 10.0 Update 2 (aka Sitecore version 10.0.2) 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 journey as well.

Note: since Sitecore 9.3, by default, we have been able to use our 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.0or later
• .NET Core 2.1.18 Windows Hosting Module
• Web Deploy 3.6
• URL Rewrite 2.1
• SOLR 8.4.0
• Red Hat OpenJDK 8 (64-bit)
• Sitecore Install Framework (SIF)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 3.0
   • open Windows PowerShell (run as administrator)
   • you should use the following command to get all 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:sc1002_install
6. download and unzip Package for XP Single
   • copy / paste the following ones to D:sc1002_install
     1. Sitecore 10.0.2 rev. 006052 (OnPrem)_single.scwdp.zip
     2. Sitecore 10.0.2 rev. 006052 (OnPrem)_xp0xconnect.scwdp.zip
     3. IdentityServer 5.1.1 rev. 00292 (OnPrem)_identityserver.scwdp.zip
   • unzip XP0 Configuration files 10.0.2 rev. 006052.zip and copy/paste all files to D:sc1002_install
   • 
7. let’s install the prerequisites
   • open Windows PowerShell (run as administrator)
   • change directory to D:sc1002_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.4.0 if not yet
   • adjust appropriate values by editing D:sc1002_installSolr-SingleDeveloper.json such as SolrPort, SolrInstallRoot if necessary
   • 
   • open Windows PowerShell (run as administrator)
   • change directory to D:sc1002_install
   • execute Install-SitecoreConfiguration -Path Solr-SingleDeveloper.json
   • 
   • 
9. copy/paste your Sitecore license file xml to D:sc1002_install
10. adjust appropriate values by editing D:sc1002_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:sc1002_install
    • execute .XP0-SingleDeveloper.ps1
    • 
12. hopefully there is nothing that can stop the installation process and note Sitecore Admin Password + SSL enabled as well
    • 
13. open a browser:
    • navigate to https://sc1002.sc/to see the Sitecore default page
    • 
    • navigate to https://sc1002.sc/sitecore and then be redirected to https://sc1002.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:sc1002_installXP0-SingleDeveloper.ps1and uncomment the line 80 + comment out the line 77 then save it
• 
• open Windows PowerShell (run as administrator)
• change directory to D:sc1002_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 I can understand your problem and suggest a solution.

Happy Sitecore 10.0 Update 2 Installation!

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