I know I am quite late. – “Better Late than Never” – This is what I said myself when I started exploring Sitecore 9 since last 1 week.
Had some glitches as well during my installation with initial version (Sitecore Experience Platform 9.0).
Many Thanks to below blogs/tutorials which helped me in my way, as and when I was stuck at various steps.
Prerequisites
- Windows 8.1/10.
- .Net framewrok 4.6.2 or later.
- SQL Server 2016 SP1
- IIS 8.5 or 10
- JRE(Java run time environment) is required for running SOLR.
- Microsoft Powershell 5.1 +
- Web Platform Installer 5.0
- Web Administration Module with (IIS)- This should be installed by default with IIS 8.5 or 10.
- Web deploy 3.6 for Hosting Servers. – via Web Platform Installer.
- URL Rewrite 2+ . – Via Web Platform Installer.
- Microsoft SQL Server Data – Tier Application Framework (17.1) – Via Web Platform Installer.
- Microsoft SQL Server Transact-SQL ScriptDom Library- Via Web Platform Installer.
Let us follow below steps for installing Sitecore 9.0 in our local development Environment.
- Install SOLR 6.6.2 as Windows service. Earlier blog can be referred .
- Configure SSL for SOLR. Earlier blog can be referred .
- Setup an installation folder which will contain all required files which we will need to get sitecore 9 working with SIF(Sitecore Install Framework). In my case – I have created – D:\InstallSitecore9
- For SC 9.0 to be installed on local developer instance – We need On Prem XP0 instance packages. -> Sitecore 9.0.0 rev. 171002 (WDP XP0 packages).zip
Get it from – dev.sitecore.net - Extract Sitecore 9.0.0 rev. 171002 (WDP XP0 packages).zip – which gives you 3 files.
- Sitecore 9.0.0 rev. 171002 (OnPrem)_single.scwdp (.zip)
- Sitecore 9.0.0 rev. 171002 (OnPrem)_xp0xconnect.scwdp (.zip)
- XP0 Configuration files rev.171002 (.zip)
- Extract -XP0 Configuration files rev.171002 file – gives you below files.
- sitecore-solr
- sitecore-XP0
- xconnect-createcert
- xconnect-solr
- xconnect-xp0
- Copy below files from the above extractions to the setup folder created in above step 3.
- Sitecore 9.0.0 rev. 171002 (OnPrem)_single.scwdp.zip
- Sitecore 9.0.0 rev. 171002 (OnPrem)_xp0xconnect.scwdp.zip
- sitecore-solr.json
- sitecore-XP0.json
- xconnect-createcert.json
- xconnect-solr.json
- xconnect-xp0.json
- Grab the sitecore license file(license.xml) and place it in your setup folder as well.
- This is how the setup folder (D:\InstallSitecore9) should look like now-
- Setup SQL Server User – In past for all Sitecore installations I have been using sa user credential. In this step I will be setting up a standard user for all our Sitecore installations(having a ‘sysadmin’ role).
- Open SSMS (SQL Server Management Studio) and connect to your local database.
- Go to Security -> Login -> Add new Login
- Your login name – I have given – “sclogin” for me.
- Set your password.
- Un-check Enforce Password policy.
- From Server Roles – Give it a “sysadmin” server role and Click Ok
- Reconnect with newly created user – “sclogin” to verify if user is created successfully.
- Enable Contained Database Authentication- script is taken from Sitecore installation guide.
- Launch MS SQL Server Management Studio and log in as an administrator
- Run the following new query: – Can grab .sql file.
sp_configure 'contained database authentication', 1;
GO
RECONFIGURE;
GO
- Now its SIF time : “Sitecore Install Framework”
- Open PS prompt as an administrator.
- Register Sitecore repositories.
Register-PSRepository -Name sitecoreRepo -SourceLocation https://sitecore.myget.org/F/sc-powershell/api/v2
- Install SIF Module
Install-Module SitecoreInstallFramework
- Install Sitecore Fundamentals Module.
Install-Module SitecoreFundamentals
- At last – Now we are ready to run SC 9 installation script.
- I have taken the script from SC9 installation guide and placed it in my setup folder – installsc9.ps1 . You can grab script I used from here: installsc9.ps1
- Update all of the parameters accordingly in power shell script file- installsc9.ps1
#define parameters
$prefix = "learnsc9" ==> name for your sitecore instance
$PSScriptRoot = "D:\InstallSitecore9" => setup folder which you have created in Step 3
$XConnectCollectionService = "$prefix.xconnect"
$sitecoreSiteName = "$prefix.sc"
$SolrUrl = "https://localhost:8983/solr" => SOLR url - which I have setup in Step 1 and 2.
$SolrRoot = "D:\SOLR\solr-6.6.2" => SOLR root folder which I have setup in Step 1.
$SolrService = "solr662" => SOLR service name which I have setup in Step 1.
$SqlServer = "LAPTOP-FT2VPMF2\SQLDEV" => Connection to my local database.
$SqlAdminUser = "sclogin" => new login user which was created as part of Step 10
$SqlAdminPassword="passwordforsclogin" => password which was setup as part of Step 10
- Open Windows Power shell ISE as an administrator
- Lets import both modules(SitecoreInstallFramework and SitecoreFundamentals) into our current session which we have installed in Step 12.
- Browse for script file – installsc9.ps1 from the setup folder – D:\InstallSitecore9 (in my case)
- Execute PS Script and Fingers Crossed.
- Take a break – and you should be having your installation complete in next few minutes.
- Lets import both modules(SitecoreInstallFramework and SitecoreFundamentals) into our current session which we have installed in Step 12.
- Verify SC 9 installation by opening up the instances.
- Happy Me 🙂 – SC9 instance is up and running now
- Post Installation Steps. – Make sure the perform all the post installation steps mentioned in SC installation guide- Chapter 6.
- Rebuild the Search Indexes
- From Sitecore Launchpad, click Control Panel =>Indexing section => click Indexing manager.
- Indexing Manager dialog box => click Select all => click Rebuild
- Build the Link Databases
- Sitecore Launchpad=> Control Panel => Database section => click Rebuild Link Databases.
- Select the Master and Core databases and then click Rebuild.
- Add a Recognized User to the xDB Shard Databases
- Query can be grabbed from SC installation guide
- We need to update DatabasePrefix as per our installation.
- I have updated script it as per the current instance we have installed.
:SETVAR DatabasePrefix learnsc9
- Execute the Query in SSMS.
- Deploy Marketing Definitions
- Sitecore Launchpad => Control Panel => Analytics => click Deploy Marketing Definitions.
- select all the definitions and taxonomies and click Deploy.
- Rebuild the Search Indexes
- Wow !!!- We have successfully installed – up and running SC 9.0 instance in local developer box.
Happy Sitecoring !!