Install the prerequisites
You must install the prerequisites. You can install them automatically or manually.
Automated installation of prerequisites
A predefined SIF configuration file Prerequisites.json is distributed in the configuration packages. This file downloads and installs most of the prerequisites.
This file does not install:
- Microsoft SQL Server
- Solr
For more information about how to use this file, see the section Install a SIF configuration file.
SIF does not install any of the prerequisite software if it is already installed. You must ensure that you install the correct versions.
Manual installation of the prerequisites
To install most of the Sitecore server roles, you must have the following prerequisites:
- IIS, ASP.NET 4.8, and the Web administration PowerShell Module
- SQL PowerShell Module
The Sitecore server roles require:
| Requirement | Feature | Details |
|---|---|---|
| WebAdministration module | Supports IIS management. | When you configure a computer with IIS, the WebAdministration module is installed automatically. |
| Web Deploy 4.0 or later for Hosting Servers | Supports the installation of Web Deploy Packages. | Download and install Web Deploy v4.0 or later. |
| URL Rewrite 2.1 | Supports URL rewrites for Sitecore when installed as a Web Deploy Packages. | Download and install URL Rewrite 2.1. |
| Microsoft SQL Server Data-Tier Application Framework (DacFx) version 15 (x64). | Supports the installation of .dac files in Web Deploy Packages | Download and install DacFx x64. This must be installed on servers that have been assigned a Sitecore server role and where you are going to install DAC packages: In the XM Scaled topology:
To ensure that DacFx works correctly, you must install its system requirements including Microsoft System CLR Types for SQL Server 2019 (x64).. If you are running an x64 environment, you must install both the x64 and x86 versions of DacFx and SQLSysCLRTypes. Note If DACFx fails to install, you can see the following error message when you use the framework: The SQL provider cannot run with dacpac option because of a missing dependency. Please make sure that DACFx is installed. For information about how to resolve this error, see this Sitecore Knowledge Base article. |
If you don't have SQL Server installed, you need to install SharedManagementObjects.msi and its dependency SQLSysClrTypes.msi. They both can be taken from Microsoft® SQL Server® 2016 Service Pack Feature Pack. It is required for the SQL Server database deployments used by Web Deploy.