Sitecore SXA 1.8 Installation Guide for Development Machine

Reading Time: 5 minutes

Sitecore Experience Accelerator (SXA) 1.8 was released on 28th November 2018. In this post I will walk you through really quick installation of this version of SXA for your development machine. This is a follow up blog post to my installation guide for Sitecore 9.1.

 

TL;DR

If you have installed SXA before, just download Sitecore Powershell Extensions (SPE) version 5.0 from this link and also SXA 1.8 for Sitecore 9.1 from this link. Install these installation packages through Sitecore. Then add SXA Solr cores to Solr, populate schemas and rebuild newly created indexes (follow chapters 3c) – 3e)). That’s it! Simple as that!

 

For rest of you let’s get started!

1) SXA 1.8 Prerequisites

1a) Sitecore

These versions of Sitecore are supported:

  • Sitecore 9.0
  • Sitecore 9.1 (I have chosen this one)

1b) Sitecore Powershell Extensions (SPE)

These versions of SPE are supported:

  • SPE 4.7.2
  • SPE 5.0 (I have chosen this one)

 

2) Installation preparation

2a) Download SPE installation package

Open https://marketplace.sitecore.net/en/Modules/Sitecore_PowerShell_console.aspx and click on download button. Click on Package link on the right next to “5.0” at the end of the list to download it:

SXA 01.png

Rename downloaded file to “01 Sitecore PowerShell Extensions-5.0.zip”. Renaming is not needed but I am using this practice to know precise order for installing packages from file name.

2b) Download SXA installation package

If you are planning to install SXA 1.8 on Sitecore 9.1 on dev machine, click directly on this link to download installation package straight ahead or open https://dev.sitecore.net/Downloads/Sitecore_Experience_Accelerator/18/Sitecore_Experience_Accelerator_180.aspx and download suitable file based on your Sitecore version 9.0 / 9.1 (login is needed for download):

SXA 00

Rename downloaded file to “02 Sitecore Experience Accelerator 1.8 rev. 181112 for 9.1.zip”. Renaming is not needed but I am using this practice to know precise order for installing packages from file name.

You should end up with this download folder:

SXA 03

2c) Optional step – Download installation guide

If you are following this blog posts, you actually don’t need to download them but just in case 🙂 Open https://dev.sitecore.net/Downloads/Sitecore_Experience_Accelerator/18/Sitecore_Experience_Accelerator_180.aspx and download highlighted file manually:

SXA 02.png

3) SXA 1.8 Installation

3a) Install SPE 5.0

From Launchpad, open Control Panel:

SXA 04.png

Click on Install a package in Administration section:

SXA 05.png

Upload both files downloaded in chapter 2) by clicking on Upload package button, choosing both files on next screen and click on Next button:

SXA 06

Choose first package:

SXA 07

Click through the wizard and wait until package is installed.

 

3b) Install SXA 1.8

From Launchpad open Control Panel or just stay in Control Panel screen:

SXA 04.png

Click on Install a package in Administration section:

SXA 05.png

This time choose the second package:

SXA 08

Click through the wizard and wait until installation is finished.

On the last screen this time also check “Restart the Sitecore server” and click Close:

SXA 09

3c) Configure SXA Solr cores

Last step of installation is to add two SXA specific Solr cores.

Navigate to your Solr folder and copy two times “{YourSitecoreInstanceName}_master_index” folder. If you have followed my Installation Guide for Sitecore 9.1, it should be located under “C:\Solr\solr721\solr-7.2.1\server\solr”:

SXA 10.png

Rename newly copied folders as “{YourSitecoreInstanceName}_sxa_master_index” and “{YourSitecoreInstanceName}_sxa_web_index”:

SXA 11

Navigate to both new folders and remove data subfolder and core.properties file as highlighted here:

SXA 12

At the end you should leave only conf subfolder under both “{YourSitecoreInstanceName}_sxa_master_index” and “{YourSitecoreInstanceName}_sxa_web_index” folders like this:

SXA 13

Open solr admin ui in your browser. If you have followed my Installation Guide for Sitecore 9.1, url is https://solr:8983/solr/ .

Click on Core Admin (1) in left menu and then click on Add Core (2) button with green plus as shown below. Specify “{YourSitecoreInstanceName}_sxa_master_index” in name and instanceDir fields (3) and hit Add Core button (4). Do the same also for {YourSitecoreInstanceName}_sxa_web_index:

SXA 14.png

Open “C:\inetpub\wwwroot\sc910.sc\App_Config\Modules\SXA\Z.Foundation.Overrides” file in your text editor and change core parameters highlighted below to your newly created cores in Solr to each index accordingly (mind highlighted values for each master/web index):

SXA 15.png

3d) Populate Solr Managed Schema for SXA indexes

From Launchpad, open Control Panel:

SXA 04.png

Open Populate Solr Managed Schema (1) from Indexing section, select only SXA related indexes highlighted below (2) and click Populate button (3):

SXA 16

This is desired outcome:

SXA 17

 

3e) Rebuild SXA indexes

From Launchpad, open Control Panel:

SXA 04.png

Open Indexing Manager (1) from Indexing section, select only SXA related indexes highlighted below (2) and click Rebuild button (3):

SXA 18.png

This is the desired outcome:

SXA 19

That’s it!

Now create tenant and site and happy content editing with SXA from first minute after installation 🙂 Thanks to Barend Emmerzaal this could be trivial task for you:

 

Cheers!

——————————————————
Used sources:

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.