Sitecore XP 9.2 Initial Release – Playing around with custom install directory

This one is a summary of my own experience with Sitecore Experience Platform 9.2 Initial Release (aka Sitecore XP 9.2.0) installation on my machine. I’ve had many experiences in Sitecore XP 9.0 and Sitecore XP 9.1 installations so I decided to go only with the following ones:

• Quick Installation Guide for a Developer Workstation(Thanks Sitecore team!)
  • Note: must log in to https://dev.sitecore.net/before downloading

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

Note: I wanted to use my install directory rather than the default one

Setup Prerequisites

• Windows 10
• Windows PowerShell version 5.1 or later
• Sitecore Licensemust have xDB enabled
• MS SQL Server 2016 SP2or later
• .Net Framework 4.7.2or later
• .NET Core 2.1.7 Windows Hosting Module
• Web Deploy 3.6
• URL Rewrite 2.1
• SOLR 7.5.0
• Java Runtime Environment
• NSSM
• Sitecore Install Framework (SIF)1.0 or later
• Packages for XP Single
  • Note: must log in to https://dev.sitecore.net/before downloading
• ensure enabling the Transport Layer Security (TLS) protocol version 1.2

Step-by-step guide

1. create a new folder D:sc920_install
2. install SOLR 7.5.0 if not yet
   • copy / paste install-solr.ps1 and psm1 into D:sc920_install
   • note 1: the originals, SOLR installation and helper file on HabitatHome.Utilities
   • note 2: you may want to use your settings rather than default settings by opening install-solr.ps1 and editing the following ones:

• open Windows PowerShell (run as administrator)
• execute .install-solr

3. (optional) install Sitecore Install Framework(SIF) if not yet
   • refer to 3.1.1. Install the SIF Module using MyGet (Page 11)in the Quick Installation Guide for a Developer Workstation
   • open Windows PowerShell (run as administrator)
   • if you have never installed Sitecore 9 before, you will probably want to execute Set-ExecutionPolicy -Scope CurrentUser Unrestricted

• 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

4. (optional)if you already installed previous SIF versions, you would have upgraded it to a new version 2.1.0
   • open Windows PowerShell (run as administrator)
   • you should use the following command to get all the current SIF versions
     1. Get-Module -Name SitecoreInstallFramework -ListAvailable
   • option 1: use the following command to update to the latest version of SIF
     1. Update-Module SitecoreInstallFramework -force
   • option 2: use the following commands to remove the currents and then install the latest version of SIF
     1. Uninstall-Module SitecoreInstallFramework -AllVersions
     2. Install-Module SitecoreInstallFramework

5. enable Contained Database Authentication if not yet
   • refer to 2.8. Enable Contained Database Authentication(Page 08) in Quick Installation Guide for a Developer Workstation

• Note: you can download the above query.

6. download and unzip Package for XP Single

(Note: must log into https://dev.sitecore.net/ before downloading)

• • copy / paste the following ones to D:sc920_install
    1. Sitecore 9.2.0 rev. 002893 (OnPrem)_single.scwdp.zip
    2. Sitecore 9.2.0 rev. 002893 (OnPrem)_xp0xconnect.scwdp.zip
    3. Sitecore.IdentityServer 3.0.0 rev. 00211 (OnPrem)_identityserver.scwdp.zip
  • unzip XP0 Configuration files 9.2.0 rev. 002893.zip and copy / paste all files to D:sc920_install
  • 

7. override Sitecore-XP0.json+ xconnect-xp0.json + IdentityServer.json + XP0-SingleDeveloper.json to inject the custom install directory so we will have something like the following ones later

• open raw and then copy/paste sitecore-XP0.json into D:sc920_installsitecore-XP0.json
• open raw and then copy/paste xconnect-xp0.json into D:sc920_installxconnect-xp0.json
• open raw and then copy/paste IdentityServer.json into D:sc920_installIdentityServer.json
• open raw and then copy/paste XP0-SingleDeveloper.json into D:sc920_installXP0-SingleDeveloper.json

• (optional) download + unzip ConfigsForDirectories.zip and then copy / paste all to D:sc920_install

8. copy/paste your Sitecore license file license.xml to D:sc920_install
9.  (optional) if you have never installed Sitecore 9 before, you will probably want to install the prerequisites

• open Windows PowerShell (run as administrator)
• execute Install-SitecoreConfiguration -Path .prerequisites.json

10. download sc920_install.ps1 and copy / paste it to D:sc920_install then open it to correct the following parameters:

• (optional) $InstallDirectory (this one is to specify your own install directory)
  • Note: it’s “D:\websites\” by default, you should update it if the disk space is low
• (optional) $Prefix
• $SqlServer
• $SqlAdminUser
• $SqlAdminPassword
• (optional)$SitecoreAdminPassword
  • Note: leave the example value “SIF-Default” unchanged, a random password is generated for you

11. open Windows PowerShell (run as administrator)

a. (optional)if you have various SIF versions on your machine, you will probably have to run the 2.1.0 version of SIF by executing Import-Module SitecoreInstallFramework -Force -RequiredVersion 2.1.0

b. change directory to D:sc920_install

c. execute .sc920_install

12. hopefully there is nothing that can stop the installation process and then note Sitecore Admin Password

13. open a browser:

a. navigate to http://sc920.local/ to see the Sitecore default page

b. navigate to http://sc920.local/sitecore and then be redirected to https://sc920.identityserver.local/ (log into it by using account admin / Sitecore Admin Password)

How to uninstall it?

• open D:\sc920_install\sc920_install.ps1 and uncomment line 79 + comment out the line 76 then save it
• 
• open Windows PowerShell (run as administrator)
• change directory to D:sc920_install
• execute .sc920_install

• hopefully, it runs well and cleans everything up

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