1. Set up a production environment

Install the Sitecore XP scaled topology

Version: 10.5

Once you have obtained the required certificates, you can run SIF and install the Sitecore XP scaled topology. You can install any of the configurations for dedicated server roles, on single or multiple servers.

The server roles are defined as a part of your desired scaling configuration.

Use SIF to install the Sitecore XP Scaled topology

To run SIF and install Sitecore XP:

  1. If you have not already done so, as an administrator, in a PowerShell command line, run the following cmdlet:

    Import-Module SitecoreInstallFramework

  2. To install the Solr cores, run the following cmdlets with the required parameters for your server roles:

    
Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\XConnect\Solr\xconnect-solr.json"

Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\Platform\Solr\sitecore-solr.json"

    For more information about installing Solr, see the section Install a search provider in a scaled solution.

  3. To install the server roles, run the following cmdlets with the required parameters for your server roles:

    
Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\IdentityServer\IdentityServer.json"

Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\Platform\XP1\sitecore-XP1-cm.json"

Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\Platform\XP1\sitecore-XP1-cd.json"

Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\Platform\XP1\sitecore-XP1-prc.json"

Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\xConnect\XP1\xconnect-xp1-collection.json"

Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\xConnect\XP1\xconnect-xp1-collectionsearch.json"

Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\xConnect\XP1\xconnect-xp1-MarketingAutomationReporting.json"

Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\xConnect\XP1\xconnect-xp1-MarketingAutomation.json"

Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\xConnect\XP1\xconnect-xp1-ReferenceData.json"

Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\xConnect\XP1\ xconnect-xp1-CortexProcessing.json"

Install-SitecoreConfiguration –Path "C:\SitecoreInstaller\Configurations\xConnect\XP1\ xconnect-xp1-CortexReporting.json"

For information about setting up EXM, see the EXM documentation.

Specifying the certificates during installation

To install Sitecore with your pre-installed certificates, when you run the Install-SitecoreConfiguration cmdlet, you must provide the certificates as parameters.

SIF searches for the certificates in the following path, by default:

Cert:\Localmachine\My

You can change the storage location.

Change the default location of the certificates

To change the default location of the certificates used for the deployment:

  • In a text editor, open the relevant .json file, and in the Variables section, change the default store value:

    "Security.CertificateStore": "Cert:\\Localmachine\\My"

Specify the names or thumbprints of the certificates

You must specify the names or thumbprints of the certificates that you created and installed earlier in this guide as parameters. For example:

  1. For the client authentication certificate:

    -XConnectCert "xConnect_client"

    or

    -XConnectCert "738F45F610221990DA2FE059E1D8C2ECCB5067F2"
    Note

    In the PowerShell command line parameter, you must specify the client certificate thumbprint in capital letters.

  2. For the server authentication certificate, for example, for an instance with the name "CM_test":

    -SSLCert "‎‎CM_test"

    or

    -SSLCert "‎‎2205a94867ee99e3b29ea7a9ac5a7646d43fd88b"

Skip database deployment when you install a server role

When you install a server role, you do not have to install the databases when you deploy the WDP packages.

A new the SkipDatabaseInstallation parameter has been added to the following deployment configuration files: ·

  • sitecore-XP1-cm.json
  • sitecore-XP1-prc.json
  • xconnect-xp1-collection.json
  • xconnect-xp1-CortexProcessing.json
  • xconnect-xp1-CortexReporting.json
  • xconnect-xp1-ReferenceData.json

The SkipDatabaseInstallation parameter is set to false by default and all the databases are installed when you deploy the WDP packages.

Note

The SkipDatabaseInstallation parameter is not supported by the SingleDeveloper and XM Scaled deployment configuration files.

To deploy a Sitecore server role without installing the databases:

  1. Ensure that you have already installed the databases that you need for the server role.

  2. Ensure that the database names contain the prefixes that you are going to use for this deployment.

  3. In the Powershell deployment command, enter all the required parameters.

  4. In the c:\resourcefiles\Role-Remote.json file, ensure that the SIFVersion parameter matches the latest version of SIF.

  5. In the Powershell deployment command, enter following parameter in the corresponding config files:

    • SkipDatabaseInstallation: true

  6. Pass the database user names and passwords, for example:

    
“SqlCoreUser” : “mycoreuser”

“SqlCorePassword” : “mycorepassword”

Install to a custom website folder

With Sitecore XP, you can specify the folder where the website is installed.

The deployment configuration files for each server role contain a SitePhysicalRoot parameter.

When you set this parameter, the website is installed in the [SitePhysicalRoot]\[SiteName] folder.

If you leave this parameter with the default value, the website is installed in the default IIS wwwroot folder.

Note

This parameter is supported by the SingleDeveloper and the Distributed deployment configuration files and the SitePhysicalRoot path that you provide is created for every website.

If you have suggestions for improving this article, let us know!