Right after I came back from the Symposium 2017, I listed all the reasons to be excited about Sitecore XC9 on my company blog post – http://www.verndale.com/insights/blog/2017/november/while-awaiting-sitecore-commerce-9/
Well, the much awaited Sitecore XC 9 finally released in January 2018, and I finally got to install my very first Sitecore XC9 instance. In this post I am sharing what FUN it has been!J
First, you need Sitecore installed. Follow my blogposts below to get that out of the way! J
My Sitecore Commerce XC9 installation has Sitecore 9 Update 1, but I followed the posts for Sitecore 9 installation just fine.
- Getting ready – https://davehetal.wordpress.com/2017/11/01/sitecore-9-fun-1-getting-ready/
- Setting up Solr – https://davehetal.wordpress.com/2017/11/03/sitecore-9-fun-2-setting-up-solr/
- Installing Sitecore XP 9 Site – https://davehetal.wordpress.com/2017/11/21/sitecore-9-fun-3-installing-sitecore-xp-9-site/
Sitecore Commerce Installation
Before you begin your Sitecore XC9 installation and setup, create the folder C:/Deploy/Assets.
Download Sitecore PowerShell Tools to C:\Deploy\Assets folder. – https://marketplace.sitecore.net/en/Modules/Sitecore_PowerShell_console.aspx
Download Sitecore Experience Accelerator to C:\Deploy\Assets folder –https://dev.sitecore.net/Downloads/Sitecore_Experience_Accelerator/16/Sitecore_Experience_Accelerator_16_Initial_Release.aspx
MS Build Microsoft Visual Studio Web targets Nuget: https://www.nuget.org/packages/MSBuild.Microsoft.VisualStudio.Web.targets/
Extract the downloaded Nuget package and then in the extracted folder navigate to C:\SitecoreInstaller\XC9\msbuild.microsoft.visualstudio.web.targets.18.104.22.168\tools\VSToolsPath\Web.
Copy the file Microsoft.Web.XmlTransform.dll to the C:\Deploy\Assets folder.
Sitecore Commerce Release Package: https://dev.sitecore.net/Downloads/Sitecore_Commerce/90/Sitecore_Experience_Commerce_90_Initial_Release.aspx
- Download the package to any folder you like. I downloaded it to C:\SitecoreInstaller\XC9.
- Extract the package to C:\SitecoreInstaller\XC9\Sitecore.Commerce.2018.01-2.0.254.
Copy all extracted files from C:\SitecoreInstaller\XC9\Sitecore.Commerce.2018.01-2.0.254 to C:\Deploy.
Now, in the Deploy folder, extract following files in their own folders. I use 7-Zip that makes things easy for me.
You can then delete the ones in red boxes. Green box is the extracted folders for these files.
Copy the file C:\Deploy\Sitecore.Commerce.Engine.SDK.2.0.1922\Sitecore.Commerce.Engine.DB.dacpac to C:\Deploy\Assets.
Install the SSL certificate. Open a PowerShell Window as admin and run the following command.
New-SelfSignedCertificate -certstorelocation cert:\localmachine\my -dnsname “Sc_Xc9.CommerceEngineConnect”
Copy the Thumbprint value somewhere. You will need it for the next step.
Export the certificate to a file by running the following cmdlet:
Export-Certificate -Cert cert:\localMachine\my\BF055C200F0142B2EF72E3592B06C1666E2C55C5 -FilePath “C:\Deploy\Assets\Sc_Xc9.CommerceEngineConnect.cert”
This is how the completed set up would look like – with all the necessary files and packages.
Stop the xConnect Service of your Sitecore installation.
Navigate to C:\Deploy\SIF.Sitecore.Commerce.1.0.1748 and create a copy of the file – Deploy-Sitecore-Commerce.ps1. I renamed my copy as My-Deploy-Sitecore-Commerce.ps1
If you want to process some test payments, you should also set up a Braintree Sandbox account. It is easy. I documented the process of creating a Braintree Sandbox account in one of my previous posts setting up Sitecore Commerce 8.2. – https://davehetal.wordpress.com/2017/06/10/fun-with-sitecore-commerce-8-2-1-part-5-commerce-authoring-service/
Once you set up the account, you can use that information to populate Braintree parameters in the installation script.
Now, you need to make some changes to this file – some to match your own names and paths and some are corrections to some typos in the original script to match the names of the Sitecore package names correctly. Below are the parameters that you would need to verify.
I have attached the script here. Sitecore XC9 Install Script
Greens are the parts-n-pieces I modified to match my name and path changes and to match to the correct package names in the originally downloaded Sitecore packages. I got it right after few tries. Hope this will help others.J
- The value of the $SiteName parameter should be same as your Sitecore Install site.
The value of $SqlDbPrefix should be same as the prefix you had when you installed your Sitecore site.
You may get time out error in the Index rebuild step. Don’t worry. You can manually rebuild the indexes from the Sitecore Control Panel Indexing Manager. That is what I did too.
Start the xConnect service that you stopped in step 13. Follow the steps from the Sitecore Installation guide.
Sitecore creates Commerce specific roles. You can create users with these roles as necessary. I did not configure any new user accounts with these roles, as this was just a demo site installation.
- Commerce Administrator
- Commerce Business User
- Customer Service Representative
- Customer Service Representative Administrator
- Pricer Manager
- Promotioner Manager
The complete installation will have the following components –
Solr Service (i.e. the name of my Solr Service is : Solr662AsService)
- Sitecore Marketing Automation Engine Service
Sitecore Xconnect Search Indexer Service
This post helped me with few issues while installing.
Feel free to message me here or on Sitecore Slack, or Twitter or LinkedIn if you have questions.