January 4, 2019 / 0 comments

Sitecore 9.1 Initial Release Installation

This article contains the complete step-by-step guide to follow for Sitecore® 9.1 Initial Release installation. The process was fast and smooth compared to previous installations. And the overall duration process is calculated to take up to 2-6 hours of work, including computer speed, errors and or bug fixes that would possibly occur.
Inclusions below are the instructions and requirements needed to successfully install the program. Website links of used resources are also included in this article for references.

Prerequisites:

This release runs on most development environments and has been tested on:

  • Windows 10 – 10.0.17134
  • Windows 10 Pro – Version 1703 OS Build 15063.1387
  • Win Server 2016 – 10.0.14393

Before you can install the Sitecore® 9.1 Experience Platform Initial Release, you must have all the following prerequisites:

  • IIS 10.0
  • .Net Framework 4.7.1
  • SQL Server 2016 SP2, SQL Server 2017. SQL Server 2014 is compatible with the XM Scaled topology.
  • Solr 7.2.1 and run as service. Download solr-7.2.1.zip here. Installation guide is here.
  • For the new Sitecore Identity server, you must install:
  • .Net Core 2.1 Runtime (v2.1.3)
  • Sitecore Install Framework 2.0.0 – Beta 0260 or later. For more information about installing SIF and SQL Server, see the Sitecore documentation for Sitecore XP 9.0.2.

The prerequisite for the Sitecore Install Framework are:

  • Web Deploy 3.6
  • URL Rewrite Module 2.1
  • SQL Server PowerShell Module
  • SQL ODBC Drivers
  • SQL sqlcmd Utility
  • SQL Server CLR Types (x86 and x64)
  • SQL Server Data-Tier Application Framework DacFx (x86 and x64)

Files Needed:

  • Sitecore 9.1.0 rev. 001442 (OnPrem)_single.scwdp.zip
  • Sitecore 9.1.0 rev. 001442 (OnPrem)_xp0xconnect.scwdp.zip
  • IdentityServer 2.0.0 rev. 00151 (OnPrem)_identityserver.scwdp.zip
  • XP0 Configuration files 9.1.0 rev. 001564.zip
  • license.xml

Instructions:

1. ) Installing Sitecore Install Framework 2.0.0 Beta 0260 using the ZIP files

  • To install Sitecore XP 9.1 preview release, you must download and use the latest version of SIF.
  • Unzip the package to a folder on your local machine, for example C:\Program Files\PowershellGet\Modules\SitecoreInstallFramework.
  • When you have unzipped the module, you must import it before it can be used.
  • If you unzipped it to c:\SitecoreInstallFramework, run the following command to import the module:
  • Import-Module c:\SitecoreInstallFramework\SitecoreInstallFramework.psd1
  • Then check Repository if added: Get-PSRepository.1

2.) Installing Sitecore Install Framework 2.0.0 Beta 0260 using a NuGet feed.
Install the Sitecore Install Framework 2.0.0  from a NuGet feed, if it is
available:

  • Open a PowerShell window as an administrator.
  • Run the following commands:

         Register-PSRepository -Name SitecoreGallery_Internal -SourceLocation                                    https://sitecore.myget.org/F/sc-powershell/api/v2

                    Note: after using this script I encountered this issue   2

  • To Fix the above(image) issue: Run the script Unregister-PSRepository -Name              “SitecoreGallery” to the path C:\Program                       FIles\WindowsPowerShell\Modules\PowerShellGet
    • Then to check repository run the script: Get-PSRepositor3
    • Then run the script Register-PSRepository -Name SitecoreGallery_Internal –           SourceLocation https://sitecore.myget.org/F/sc-powershell/api/v2 –             InstallationPolicy Trusted in the same path above:
    • Then check Repository if added: Get-PSRepository4
    • Install-Module SitecoreInstallFramework -AllowPreRelease

Note: It can also be Install-Module SitecoreInstallFramework – RequiredVersion “2.0.0”

To check that the module has been installed correctly, run the following        command: Get-Module -ListAvailable -Name SitecoreInstallFramework5

                (Note: Installed SIF using the ZIP files then installed using an NuGet feed.)

3.) Install the prerequisites for XP Single and XM Scaled
To install the prerequisites for the XP Single and XM Scaled topologies:

  • Download the following SIF configuration file and save it on the server:

– Prerequisites.json

  • Run the following command:

– Install-SitecoreConfiguration -Path .\prerequisites.json

  • Reboot the server.

Note: You must have a working version of SOLR 7.2.1 on your local server configured with SSL.

4.) Install the XP Single topology.

You need the following files from the XP0 Configurations Folder

    • createcert.json
    • xconnect-xp0.json
    • xconnect.solr.json
    • sitecore-solr.json
    • sitecore-XP0.json
    • IdentityServer.json
    • XP0-SingleDeveloper.json

You also need:

    • license.xml
    • The latest WDPs

Note: The following PowerShell script uses these files to install the XP Single topology.You must update the script with the appropriate values for your environment.This sample script only contains the minimum set of parameters. If a parameter is not included it will use either the default value or a calculated value.

5.) To install the XP Single topology:

  • Open a PowerShell window as an administrator.
  • Save the following Script below to c:\install91
  • Run the following script that you have saved.

# The prefix that will be used on the SOLR, Website, and Database
instances.
# The prefix that will be used on the SOLR, Website, and Database instances.
$Prefix = "sc910"
# The root folder with the license file and the WDP files.
$SCInstallRoot = "C:\Temp\XP0"
# The name of the XConnect service.
$XConnectSiteName = "$prefix.xconnect"
# The Sitecore site instance name.
$SitecoreSiteName = "$prefix.sc"
# The Identity Server site name.
$IdentityServerSiteName = "$prefix.identityserver"
# The path to the license file.
$LicenseFile = "$SCInstallRoot\license.xml"
# The URL of the Solr Server.
$SolrUrl = "https://localhost:8983/solr"
# The folder that Solr has been installed in.
$SolrRoot = "C:\Solr-7.2.1"
# The name of the Solr Service.
$SolrService = "Solr-7.2.1"
# The DNS name or IP address of the SQL Instance.
$SqlServer = "localhost"
# A SQL user with sysadmin privileges.
$SqlAdminUser = "sa"
# The password for $SQLAdminUser.
$SqlAdminPassword = "Password123"
# The path to the XConnect package to deploy.
$XConnectPackage = "$SCInstallRoot\Sitecore 9.1.0 rev. 001442 (OnPrem)_xp0xconnect.scwdp.zip"
# The path to the Sitecore package to deploy.
$SitecorePackage = "$SCInstallRoot\Sitecore 9.1.0 rev. 001442 (OnPrem)_single.scwdp.zip"
# The path to the Identity Server package to deploy.
$IdentityServerPackage = "$SCInstallRoot\Sitecore.IdentityServer 2.0.0 rev. 00151 (OnPrem)_identityserver.scwdp.zip"
# The Identity Server password recovery URL, this should be the URL of the CM instance.
$PasswordRecoveryUrl = "http://$SitecoreSiteName"
# The URL of the XconnectService.
$XConnectCollectionService = "https://$XConnectSiteName"
# The URL of the Identity Authority.
$SitecoreIdentityAuthority = "https://$IdentityServerSiteName"
# The random string key used for establishing a connection with the IdentityService.
$ClientSecret = "SIF-Default"
# A pipe-separated list of instances (URIs) that are allowed to log in through Sitecore Identity.
$AllowedCorsOrigins = "http://$SitecoreSiteName"

# Install XP0 via combined partials file.
$singleDeveloperParams = @{
    Path = "$SCInstallRoot\XP0-SingleDeveloper.json"
    SqlServer = $SqlServer
    SqlAdminUser = $SqlAdminUser
    SqlAdminPassword = $SqlAdminPassword
    SolrUrl = $SolrUrl
    SolrRoot = $SolrRoot
    SolrService = $SolrService
    Prefix = $Prefix
    XConnectCertificateName = $XConnectSiteName
    IdentityServerCertificateName = $IdentityServerSiteName
    IdentityServerSiteName = $IdentityServerSiteName
    LicenseFile = $LicenseFile
    XConnectPackage = $XConnectPackage
    SitecorePackage = $SitecorePackage
    IdentityServerPackage = $IdentityServerPackage
    XConnectSiteName = $XConnectSiteName
    SitecoreSitename = $SitecoreSiteName
    PasswordRecoveryUrl = $PasswordRecoveryUrl
    SitecoreIdentityAuthority = $SitecoreIdentityAuthority
    XConnectCollectionService = $XConnectCollectionService
    ClientSecret = $ClientSecret
    AllowedCorsOrigins = $AllowedCorsOrigins
}
Push-Location $SCInstallRoot
Install-SitecoreConfiguration @singleDeveloperParams *>&1 | Tee-Object XP0-SingleDeveloper.log
Pop-Location

Note: The installation information is saved in the XP0-SingleDeveloper.log file.

  • Then after installation:6

6.) Install the XM Scaled (XM1) topology (Optional)

You need the following files from the XM1 Configuration Folder:

    • sitecore-solr.json
    • sitecore-XM1-cd.json
    • sitecore-XM1-cm.json
    • createcert.json
    • IdentityServer.json
    • XM1-SingleDeveloper.json

You also need:

    • license.xml
    • The latest WDPs

To install the XM Scaled (XM1) topology:

    • Open a PowerShell window as an administrator.
    • Save the following Script below to c:\install91
    • Run the following script that you have saved.

Note: The following PowerShell script uses these files to install the XM Scaled topology. You must update the script with the appropriate values for your environment. This sample script only contains the minimum set of parameters. If a parameter is not included it will use either the default value or a calculated value.

The prefix that will be used on the SOLR, Website, and Database instances:

# The prefix that will be used on the SOLR, Website, and Database instances.

$Prefix = "XM910"

# The root folder with the license file and the WDP files.

$SCInstallRoot = "C:\Temp\XM1"

# The name for the Sitecore Content Delivery server.

$SitecoreContentManagementSitename = "$Prefix.cm.local"

# The name for the Sitecore Content Management Server.

$SitecoreContentDeliverySitename = "$Prefix.cd.local"

# The Identity Server site name.

$IdentityServerSiteName = "$prefix.identityserver"

# The path to the license file.

$LicenseFile = "$SCInstallRoot\license.xml"

# The URL of the Solr Server.

$SolrUrl = "https://localhost:8983/solr"

# The folder that Solr has been installed in.

$SolrRoot = "C:\Solr-7.2.1"

# The name of the Solr Service.

$SolrService = "Solr-7.2.1"

# The DNS name or IP address of the SQL Instance.

$SqlServer = "172.21.232.150"

# A SQL user with sysadmin privileges.

$SqlAdminUser = "sa"

# The password for $SQLAdminUser.

$SqlAdminPassword = "Password123"

# The path to the Sitecore Content Management package to deploy.

$SiteCoreContentManagementPackage = "$SCInstallRoot\Sitecore XM 9.1.0 rev. 001442 (OnPrem)_cm.scwdp.zip"

# The path to the Sitecore Content Delivery package to deploy.

$SitecoreContentDeliveryPackage = "$SCInstallRoot\Sitecore XM 9.1.0 rev. 001442 (OnPrem)_cd.scwdp.zip"

# The path to the Identity Server package to deploy.

$IdentityServerPackage = "$SCInstallRoot\Sitecore.IdentityServer 2.0.0 rev. 00151 (OnPrem)_identityserver.scwdp.zip"

# The Identity Server password recovery URL, this should be the URL of the CM instance.

$PasswordRecoveryUrl = "http://$SitecoreContentManagementSitename"

# The URL of the Identity Authority.

$SitecoreIdentityAuthority = "https://$IdentityServerSiteName"

#The random string key used for establishing a connection with the IdentityService.

$ClientSecret = "SIF-Default"

#The adding allowed CORS Origins, urls of all clients should be added here.

$allowedCorsOrigins = "https://$SitecoreContentManagementSitename"

# Install XM1 via a combined partials file.

$singleDeveloperParams = @{

Path = "$SCInstallRoot\XM1-SingleDeveloper.json"

SqlServer = $SqlServer

SqlAdminUser = $SqlAdminUser

SqlAdminPassword = $SqlAdminPassword

SolrUrl = $SolrUrl

SolrRoot = $SolrRoot

SolrService = $SolrService

Prefix = $Prefix

IdentityServerCertificateName = $IdentityServerSiteName

IdentityServerSiteName = $IdentityServerSiteName

LicenseFile = $LicenseFile

SiteCoreContentManagementPackage = $SiteCoreContentManagementPackage

SitecoreContentDeliveryPackage = $SitecoreContentDeliveryPackage

IdentityServerPackage = $IdentityServerPackage

SitecoreContentManagementSitename = $SitecoreContentManagementSitename

SitecoreContentDeliverySitename = $SitecoreContentDeliverySitename

PasswordRecoveryUrl = $PasswordRecoveryUrl

SitecoreIdentityAuthority = $SitecoreIdentityAuthority

ClientSecret = $ClientSecret

AllowedCorsOrigins = $AllowedCorsOrigins

}

Push-Location $SCInstallRoot

Install-SitecoreConfiguration @singleDeveloperParams *>&1 | Tee-Object XM1SingleDeveloper.log
Pop-Location

Note: The installation information is saved in the XM1-SingleDeveloper.log file.

Resources:

See https://github.com/raseniero/sitecore-v9.1-Installation GitHub for this guide with regards on the other files that is needed for this installation.

https://dev.sitecore.net/Downloads/Sitecore_Experience_Platform/91/

https://dev.sitecore.net/Downloads/Sitecore_Installation_Framework.aspx

http://archive.apache.org/dist/lucene/solr/7.2.1/

Leave a comment