Gotchas while installing Sitecore 9 using the Sitecore installation framework

Sitecore released a nice Installation framework to install Sitecore, xConnect and configure Solr. I used this framework already a few times (on a few machines and it turned out that I am very proficient in breaking things. Especially Sitecore 9). During this installation I faced some inconvenient issues (and found out some tips) which I wanted to share with you. This should help you getting up and running even faster!

Download the prerequisites and setup your resource directory

First, download the following files:

Create a directory c:\resourcefiles and extract the contents of the installation package to this folder. There should be a Sitecore and an Extract the content of “XP0 Configuration files” to the root of this directory as well. Last but not least: copy your license.xml. Make sure to unblock your xml and zip-files. Right click on each file and select “Properties”. Enable unblock and press OK.

Install the latest version of the Sitecore Installation Framework

Use the following commands to install the latest version of SIF:

When this doesn’t work, there might be a chance that you manually installed an older version. Remove it. It might be found it the <userdirectory>\WindowsPowerShell\Modules or in “C:\Program Files\WindowsPowerShell\Modules”

Install Solr, run as a windows service and setup https

The first prerequisite is to have Solr running over https. First, install Solr as you normally would, after the installation, you should visit this blog by Kam Figy as he wrote a nice script to setup https.

The Sitecore installation framework requires Solr to run as a windows service. When heading back from the Sitecore Symposium I tried to set this up, but didn’t get it to work. The trick: make sure to run solr as a foreground process: solr.cmd -f -p 8983. This blog helped me on how to set it up. They made use of a tool called NSSM

Enabled Contained database authentication

This is generally not a best practice, but xConnect requires the ability to login using a sql login. When you copy the query from the installation guide, all the commands are placed on a single line, which causes sql to bug out. Copy the sql query from the source below and you’re good to go!

Download the configuration files

Don’t. As the Sitecore Installation framework uses a set of configuration files to deploy an environment, Sitecore provided a set of configuration files. The Installation guide tells us to download them from, but I spend like 20 minutes searching for them: they weren’t there. Turns out that they are part of the installation package.

Install Sitecore and xConnect (and repeat when this fails)

The next step would be to install Sitecore. Sitecore provides a nice installation script, but again: it gives some problems while copy-and-pasting it. This gist provides the same script, but is more easier to copy. Save it as c:\resourcefiles\install.ps1 When the Solr-task gets executed and gives a strange error, this might be due to the fact that the windows service hasn’t been started yet.

It might be possible that the installation doesn’t end successfully (due to some configuration errors). Just re-starting the installation will not work, as the framework tries to reinstall the databases. As manually deleting them isn’t fun, I always stop the two web applications ( and xp0.xconnect) and run the sql script below:

it might be possible that the Marketing automation table cannot be deleted. I always delete this one manually, just make sure to tick the box “close existing connections”

Note to self: do not forget to run the post-installation steps

For some reason I always forget those. As xConnect will NOT work without those post-installation steps the script below really should be executed. As it came from the guide: when copy-pasting it from the guide, the query will bug out. Fire up your Sql management studio, create a new query and set the mode to SQLCMD.



Having an automated installation is great and I will definitely use this over SIM, as this guide takes care of a secure installation, setups solr and xConnect. However, there are some inconvenient issues which I just wrote down, I really hope it helps you to get up and running as soon as possible!

26 thoughts on “Gotchas while installing Sitecore 9 using the Sitecore installation framework

  1. Jeroen

    Thank you for this. Got it working all the way to the post-installation steps and than I got stuck:

    Looks like it didn’t create both databases:

    Database ‘xp0_Xdb.Collection.Shard1’ does not exist. Make sure that the name is entered correctly.

    1. Reema Patel

      Hi Jeroen,

      I am facing the same issue while installing Sitecore 9. Can you share what you had to do in order to be able to create Xdb.Collection.Shard1 database.

      Thanks in advance

      1. Teeknow

        I’m late to the party but a dev I worked with had an issue when running this script with the creation of one of the shard dbs. They were using sql 2014 and after they bumped up to 2016 they were good to go.

  2. Pingback: A step by step guide for Sitecore 9 installation on your machine – Walking on clouds

  3. MikeD

    Wow, what a life saver! Much more refined than going through all the default installation configs. Thanks!

  4. Ganesh

    Thanks for sharing this. I am having below query.

    We are going to upgrade 8.2 to 9. Can i use this installation script on top my sitecore instance after I finish the upgrade steps.

    In the upgrade guide, they mention to follow the steps in the installation guide to install XConnect. Can you provide some information what are the items I need to install XConnect only.

  5. Pingback: Sitecore 9 Installation – Sitecore – World of Digital Experiences

  6. Pingback: How to Install sitecore 9 with SOLR SSLElaborating Sitecore Digital Experiences world

  7. Pingback: Install Sitecore 9 Update 1 - in 4 Simple Steps - Flux Digital Blog

  8. Suhas S

    I have my solr instance running. SIF is installed and I have done necessary updates as mentioned in the install script. But when I run the install script, I am getting the following error –

    Install-SitecoreConfiguration : The term ‘Install-SitecoreConfiguration’ is not recognized as the name of a cmdlet, function, script file, or operable
    program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
    At D:\Tools\Sitecore 9.0 update 1\resourcefiles\install.ps1:17 char:1
    + Install-SitecoreConfiguration @certParams -Verbose
    + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo : ObjectNotFound: (Install-SitecoreConfiguration:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

    I am unable to find solution anywhere for this. Any pointers on what may be causing the above issue.

    Suhas Shivaram

    1. Kevin Suarez

      Make sure you have PowerShell v5+ installed. Then delete all sitecore modules and retry.

      1. Suhas S

        Hi Kevin,

        Thank you for your suggestion. The issue with my system is that windows 10 is not upgraded from my organisation. Due to which I am still stuck with Powershell 5.0. To overcome this, I had to update 2 files in the following locations.
        SitecoreInstallFramework.psd1 – C:\Program Files\WindowsPowerShell\Modules\SitecoreInstallFramework\1.2.1
        SitecoreFundamentals.psd1 – C:\Program Files\WindowsPowerShell\Modules\SitecoreFundamentals\1.1.0

        In the above files replace – PowerShellVersion – 5.1 with 5.0.


  9. Deloras

    I am very happy successfully find this website, I have almost 2 hours
    searching on various websites, only this blog provides detailed info questions online poker .
    Explain from the bottom to the most complicated. Thank you, special site

  10. Stefan Hakansson

    Thanks for good article. I have a silly question, what SQL account should I put into the last “SETVAR” SQL script so that xConnect works (where is where I am stuck)?

  11. Pingback: Where is the Log File in #Sitecore 9? – Sitecore Solution || Tips & Tricks

  12. alternatif daftar judi

    Daftar Situs Judi Online Terbaik in Philippines
    Situsalternatif are a collection of provides of the greatest online gambling internet sites from all recognized
    bookies / providers in Indonesia. Info on online gambling internet sites
    listed on this page is definitely altering, because we only provide sites that will get good reviews.
    Each site provides some informative about the games available,
    deposit transaction choices, and alternative hyperlinks.

    Collection of Situs Alternatif and Daftar Taruhan online Terbaik
    Actively playing on gambling websites is not really completely clean, among the problems often experienced by players
    will be difficulty accessing the site where you can perform due
    to internet site blocking. Therefore, the choice Site collects
    alternate links here which are incredibly useful in order to help gamblers to easily login plus daftar taruhan online.

    Within addition, you avoid need to worry about the link alternatif judi that we
    all provide, obviously a person can access that easily and for free.

  13. linksbo

    Listing of Alternative Linksbo Backlinks
    Today is increasingly developing, making it simpler for folks to access computerized networks.
    Until now there are numerous on-line gambling games that can be played by any person online.
    Therefore, gambling lovers no lengthier need to go to typically the casino to learn gambling, this is
    fairly simple for them to play anytime plus anywhere without restrictions.

  14. Mariel

    Bandar Judi Nova88

    Nova88 is one of the better reliable online bookies in Indonesia which offers been operating given that 2004.
    More compared to thousand individuals register as
    official people each day at for a single reason only, particularly we remain devoted to paying members’ profits.
    Coupled with our upgraded and a lot more
    advanced platform betting system. From your Maxbet server migrated to be able to the Nova88 storage space,
    customers will encounter a much better gaming knowledge for maximum general gameplay.

  15. vipbetberry

    Betberry is a single of the top sites in the particular online gambling
    industry in Indonesia that will provides slots, on line casino, sportsbook, shooting species of fish, money claws,
    holdem poker, cockfighting and lottery. We have launched seamless technology of
    which provides a fairly easy answer for online gambling participants.
    With just one IDENTITY, you can enjoy all the video games
    from various suppliers without having to move cash in one provider to be able to another.
    Betberry by itself is certified by the Nexus
    Motor, which means we offer services in order to players for all
    those Indonesian players legally.


Leave a Reply

Your email address will not be published. Required fields are marked *

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