Installing Commerce Server

By Brad Christie

This article walks you through installing Commerce Server.

Prerequisites

Before beginning this guide ensure you’ve followed our Getting Started guide. Also, make sure you’ve downloaded Commerce Server locally.

Pre-Installation

Commerce Server requires Windows Identity Foundation to be installed. To do so, please goto the application manager and select “Turn Windows Features On or Off”.

../_images/turn_windows_features_on_or_off.png

Next, select the checkbox next to Windows Identity Foundation

../_images/install_wif.png

Tip

Why WIF? Because if you don’t, you’ll see an error while installing letting you know it’s required.

../_images/cs_err_wif.png

Also, select the checkbox next to IIS Metabase and IIS 6 configuration compatibility

../_images/install_mgmt_compat.png

Tip

Why Metabase & IIS 6 compatibility? Because if you don’t you’ll see an error in the install phase regarding access to iisadmin.

../_images/cs_err_iisadmin.png

Installation

  1. Run the installer, and click install
../_images/cs_01_install.png
  1. Agree to the terms of the license agreement, then click OK
../_images/cs_02_license.png

3. Once finished, the configuration window will appear. At this point you may either continue on (and continue on from the Pre-Configuration section below), or close it and return back to it later.

../_images/csc_01_start.png

Tip

Though configuration is kicked off immediately after an install, it can be picked back up again. Simply close the configuration window and go about your business. When you’re ready, you can access it again using “Configuration Wizard” located under “Commerce Server” in your start menu.

  1. Sitecore Commerce Server is now installed.
../_images/cs_04_done.png

Pre-Configuration

Accounts and Roles

This topic provides a summary of the user accounts and groups that you create. In a multi-server deployment, Sitecore Commerce accounts and user groups must be created on the domain controller. In a single-server deployment, you can create these accounts and groups on the computer where Sitecore Commerce is installed. For the internal test and development environments, create the same accounts and groups that you create for the data domain in the production environment.

In a multi-computer deployment, Sitecore Commerce accounts and user groups must be created on the domain controller. In a single-server deployment, you can create these accounts and groups on the computer where Sitecore Commerce is installed. For the internal test and development environments, create the same accounts and groups that you create for the data domain in the production environment.

See the following sections for the account and group requirements for each of these areas:

  • Commerce Server User and Service Accounts
  • Commerce Server Groups and Account Assignments
  • Additional User Groups for Granular Security
  • SQL Server Database Instances, Accounts, and Role User Mappings

Commerce Server User and Service Accounts

The following table lists the accounts that are created or that you create when you install the prerequisite software. You must create the <CS Installer>, <CS Staging User>, CSLOB, and RunTimeUser accounts before you install Commerce Server. After installation, you will create SQL Server Login accounts, and associate the user accounts with Windows user groups.

Account Role Description Windows User Group(s) SQL Server Account
<CS Installer> Account of person logged on to install & configure Commerce Server. Administrator, CatalogAdminGroup, MarketingAdminGroup, OrdersAdminGroup n/a
<CS Staging User> Account of person who manages Commerce Server Staging. n/a <CS Staging User>
CSLOB Commerce Server Adapters identity. n/a n/a
CSStageSvc Commerce Server Staging (CSS) service identity CSS_SG, CSS Administrators, CSS Operators CSStageSvc

Commerce Server Groups and Account Assignments

Commerce Server Administrator Groups

Create the four administrator groups that are listed in the following table. These are the minimum number of groups to define. Create separate user groups based on your business needs, and then assign those groups to authorization roles through the Authorization Manager. For more information, see Authorizing Users and Groups to Access Web Services.

User Group Description Accounts to assign
CatalogAdminGroup Administrator group for the Catalog and Inventory Web services. <CS Installer>, Business User Accounts
MarketingAdminGroup Administrator group for the Marketing Web services. <CS Installer>, Business User Accounts
OrdersAdminGroup Administrator group for the Orders Web services. <CS Installer>, Business User Accounts
ProfilesAdminGroup Administrator group for the Profiles Web services. <CS Installer>, Business User Accounts

Commerce Server Web Application Accounts

Use the Service user accounts for the Sitecore Commerce web applications to perform the following tasks:

  • To run Internet Information Services (IIS) application pools.
  • To help secure folders.
  • To establish anonymous access to the Web site.
  • To access the Commerce Server databases.

Commerce Server creates the Web applications when you unpack a Commerce Server site, and select the Web services that you want to install. Each Commerce Server Web application requires the definition of a Windows user account and a Windows user group.

Create the following accounts and user groups on the data tier domain controller, and make assignments before or after you install Commerce Server. Also create the RunTimeUser account on the Data tier domain controller. The following table lists the default names that are used in this deployment guide:

Account name Description
RunTimeUser The account to run the Sitecore site application pool.
CatalogWebSvc The account to run the Catalog web service application pool.
MarketingWebSvc The account to run the Marketing web service application pool.
OrdersWebSvc The account to run the Orders web service application pool.
ProfilesWebSvc The account to run the Profiles web service application pool[JV1].

Configuration

  1. To begin, click next
../_images/csc_01_start.png
  1. Configure your SQL connection, then click next
../_images/csc_02b_sql.png

Important

Recommended practice is to use Windows Authentication as the security mechanism.

../_images/csc_02c_sql.png

Todo

Find out min. permissions required for this account. Assumption is dbo of SQL, but not confident of anything else.

  1. Configure staging service, then click next
../_images/csc_03_stage.png
  1. Review summary, then click next
../_images/csc_04_summary.png
  1. Installation complete.
../_images/csc_05_done.png

Important

Don’t launch upgrade wizard!

More Information

See also

Though this guide aims to be a complete resources, in the event that something has been missed, please check out these additional links. One thing I do ask is give this document a once-over before visiting the below links, otherwise this guide isn’t serving its purpose.

Installation
Information as it relates to running the Commerce Server installer.
Pre-Configuration
Information detailing the necessary accounts to create before configuring Commerce Server
Configuration
Guide on configuring Commerce Server once it’s installed.