SCpbCS Reference storefront

Abstract

SCpbCS Reference storefront.

Before you set up the SCpbCS Reference storefront, ensure that you already gone through the Single Server SCpbCS install, or set up SCpbCS on a CM or CD server. Please note there is no need to perform the unpup portion of the Single Server SCpbSC install.

The release package for SCpbCS is available on GitHub, and is named Sitecore.Reference.Storefront.for.SCpbCS.<version>.zip. Within the zip file, the Database folder contains all of the artifacts related for configuring the Commerce Server site, and the Packages folder contains all of the artifacts related for configuring Sitecore.

Follow these steps to set up the Reference Storefront:

  1. Install the SQL Server.

  2. Install MongoDB.

  3. Create accounts to be used as app pools. For more information, see  the What are the required accounts and groups? topic.

  4. Setup a Sitecore site. For more information, see the Sitecore installation topic.

  5. Install Commerce Server. For more information, see the Commerce Server installation topic.

  6. Configure Commerce Server. For more information, see the Commerce Server configuration topic.

  7. Create a new website in IIS called CSServices, which will be used to house the Commerce Server web services.

  8. Expand the Sitecore.Reference.Storefront.for.SCpbCS.<version>.zip file you downloaded from GitHub.

  9. UnPup the Commerce Server site.

    1. Install the \Database\pup\SolutionStorefront.pup by double-clicking on it, or by opening the Commerce Server Site Packager and selecting the pup file.

    2. Select Quick Unpack.

    3. Set the Site name to CSSolutionStorefrontSite. If you choose a name other than CSSolutionStorefrontSite, you will need to update the siteName attribute on the CommerceServer element in the web.config to match this name.

    4. Set the IIS Web Site name to CSServices.

    5. Set the database server name. It is strongly suggested that you use Windows Integrated Security.

    6. Accept all of the defaults through the rest of the wizard.

  10. Secure Commerce Server Resources:

    1. Update the web service app pools accounts to use the web service accounts that you created in step 3.

    2. Use the Authorization Manager tool (AzMan.msc) to add your user name into the Administrator role for each web service authorization store:

      1. C:\inetpub\ CSServices\CSSolutionStorefrontSite_CatalogWebService\CatalogAuthorizationStore.xml

      2. C:\inetpub\ CSServices\CSSolutionStorefrontSite_MarketingWebService\MarketingAuthorizationStore.xml

      3. C:\inetpub\ CSServices\CSSolutionStorefrontSite_OrdersWebService\OrdersAuthorizationStore.xml

      4. C:\inetpub\ CSServices\CSSolutionStorefrontSite_ProfilesWebService\ProfilesAuthorizationStore.xml

    3. Ensure the catalog web service app pool user has write permissions to the CatalogAuthorizationStore.xml file.

    4. Lock down the Commerce Server databases with the web service and site app pools accounts. You can secure the Commerce Server databases (What are the required accounts and groups to create? ) manually, or you can use the \Database\Security\CommerceServer_Security.sql file as a helper. Search the document to replace the database names and user names with yours, and then run the SQL file against your database server.

    5. Grant the Sitecore App Pool access to the Commerce Server Staging DCOM. Using the Windows Components Service Manager, assign the Sitecore site app pool user the following permissions on the staging CReplicationProject COM object, located at /Component Services/Computers/My Computer/DCOM Config/{7E95698D-CD3C-4C98-93C7-6510C31F7DDF}:

      • Execute

      • Execute_Local

      • Activate_Local

  11. Import catalog data, using the Catalog Manager or ImportCatalog.exe:

    • catalog data and schema file (\Database\Catalog\Catalog.xml)

    • inventory data and schema file (\Database\Catalog\Inventory.xml)

  12. Import profile data:

    1. Run the \Database\Profiles\AdjustSchema.sql file against the CSSolutionStorefrontSite_profiles database.

    2. Using Commerce Server Manager, import the profile schema file (\Database\Profiles\Schema.xml) and point the database configuration to CSSolutionStorefrontSite_profiles.

  13. Import orders data:

    • Run the \Database\Profiles\PaymentMethod.sql and \Database\Profiles\ShippingtMethod.sql files against the CSSolutionStorefrontSite_transactionconfig database.

  14. Configure Profile System Encryption. For more information, see the How to configure encryption keys topic.

  15. Install Commerce Connect.

    1. Download the Commerce Connect software from the Sitecore Commerce Download page.

    2. Open the Update Wizard in a browser (http://<your_site>/sitecore/admin/UpdateInstallationWizard.aspx) and follow the steps in the wizard.

  16. Install Commerce Server Connect.

    1. Download the Commerce Server Connect software from the Sitecore Commerce Download page.

    2. Open the Update Wizard in a browser (http://<your_site>/sitecore/admin/UpdateInstallationWizard.aspx) and follow the steps in the wizard.

  17. Install the Merchandising Manager.

    1. Download the Sitecore Merchandising Manager software from the Sitecore Commerce Download page.

    2. Open the Update Wizard in a browser (http://<your_site>/sitecore/admin/UpdateInstallationWizard.aspx) and follow the steps in the wizard.

  18. Install the Sitecore Reference Storefront powered by Commerce Server.

    1. Download the Reference Storefront package from the Sitecore Commerce Download page.

    2. Open the Update Wizard in a browser (http://<your_site>/sitecore/admin/UpdateInstallationWizard.aspx) and follow the steps in the wizard.

  19. Navigate to the location of the Sitecore site on disk and do the following:

    1. Copy the contents of <site>\MergeFiles\Merge.CommerceServer.config file into the web.config file.

    2. Copy the contents of <site>\MergeFiles\Merge.Commerce.Storefront.config file into the web.config file.

    3. Update the Commerce Server siteName attribute on the CommerceServer node in the web.config file to be CSSolutionStorefrontSite.

  20. If you are using Solr, set Solr up:

    1. Follow the steps in the Setting up Solr topic to integrate Sitecore and Solr.

    2. Follow the steps in the Configure SCpbCS to work with Solr topic to enable SCpbCS Solr indexes.

  21. Install the Adventure Works images. Log into the Sitecore Launchpad and open the Content Editor.

    1. Log into the Sitecore Launchpad and open the Content Editor.

    2. From the Sitecore menu select Development Tools\Installation Wizard, and follow the steps in the wizard.

    3. Upload thee \Packages\Adventure Works Images.zip file

  22. Expose Commerce Server catalogs in the content tree, as described in the Configuration topic. 

  23. Publish all content to the Web.

  24. Index all content.

If you have a separate Processing server, then you need to deploy the Reference Storefront update package on that server, because it has a processor in the Initialize pipeline that needs to register some types with MongoDB.