1 (905) 264-1100 Monday-Friday, 9am - 6pm
info@apiqu.com Drop us a line anytime!
100 Arbors Lane, Unit D Vaughan, Canada
Toggle Menu
1 (905) 264-1100 Monday-Friday, 9am - 6pm
info@apiqu.com Drop us a line anytime!
100 Arbors Lane, Unit D Vaughan, Canada
Toggle Menu
Sitecore Commerce

Installing Sitecore Commerce 8.2.1 - Part 2

Introduction

In the previous article, we’ve installed Sitecore 8.2 and Commerce Server 11.4. Now we are ready to connect everything together and make the necessary configurations. Let’s move to the next step.

Install Sitecore Modules

Nothing special there, just make sure you are installing packages in the order the is listed in the guide and confirm to override existing items.

Install Sitecore Update Packages

At this step we need to install Sitecore Commerce and Store Front packages, by navigating to  http://<your site>/sitecore/admin/UpdateInstallationWizard.aspx. Just follow the official installation guide and install package in the order it’s presented there. It’s going to take some time.

Sitecore Commerce Installation Update Packages

In case, if you have error after the latest package installation “Sitecore.Reference.Storefront.Powered.by.SitecoreCommerce.10.0.xxx.update” :

Sitecore Commerce Installation Update Packages Error

And your Sitecore website gives you the same error:

Sitecore Commerce Installation Update Packages Error

Don’t worry, it will be solved in next steps.

Set Up a Commerce Server Site

During this step I had some problems with executing Initialize-CSSite command. The Error was indicated “The ‘Initialize-CSSite’ was found in the module ‘CSPS’, but the module could not be loaded. For more information, run ‘Import-Module CSPS’.”

Sitecore Commerce Installation Initialize-CSSite Error

If the same party-pooper appears, please try the following:

      1. Change the execution policy (Choose Y).

      Set-ExecutionPolicy Unrestricted

      2. Execute the installation command.

      Import-Module CSPS

      3. Execute Initialize command again

      Initialize-CSSite

Now everything should be OK and we are ready to configure the encryption keys. Perhaps, if you strictly followed the official installation guide or you are not 100% aware of PowerShell syntax like myself, the following errors might appear while executing “ProfileKeyManager.exe” commands.

Sitecore Commerce Installation ProfileKeyManager error

Sitecore Commerce Installation ProfileKeyManager error

You can solve it this way:

Sitecore Commerce Installation ProfileKeyManager error

Once you’ll achieve step number 7 AND if you had error during the installation of “Sitecore.Reference.Storefront.Powered.by.SitecoreCommerce.10.0.xxx.update” package. Please go back to http://<your site>/sitecore/admin/UpdateInstallationWizard.aspx and reinstall this package.

Sitecore Commerce Installation Update Packages Error

Install the Commerce Authoring Service

If “dotnet restore” command doesn’t work and gives you the error “MSBUILD: error MSB1011: Specify which project or solution file to use because this folder contains more than one project or solution file”:

Sitecore Commerce Installation dotnet restore error

Or if after you’ve specified the file solution file to compile you have “error MSB4025: The project file could not be loaded. Data at the root level is invalid. Line 1, position 1.”:

Sitecore Commerce Installation dotnet restore error 2

Or during executing “dotnet publish” command you have the following error:

Sitecore Commerce Installation dotnet restore error 3

It means that ASP.NET Core SDK version specified in Sitecore Commerce SDK solution cannot be found in your system. To solve it please go back to the “Install ASP.NET and related software step” in Part 1 and follow the instructions.

Before executing:

Please do changes of the default settings first, especially if you have named instance of Microsoft SQL Server. Moreover, you have to change MSSQL Server names across all the files listing below (Paths can vary based on your installation but file names will remain the same):

Sitecore Commerce Authoring configs with sql connection strings

Please don’t forget to restart you IIS to make it consume all new configurations. Otherwise you will get something like this:

Sitecore Commerce Installation Boostrap error

If you have this error during the Initialize Environment step, you’ll have to execute sql command for “SitecoreCommerce_SharedEnvironments” database.


delete from CommerceEntities where Id is not null
delete from CommerceLists where ListName is not null

Then do reset of IIS and execute all commands again beginning from the Boostrap().

Final Configurations

After you’ve merged config files and views, open Sitecore Content Editor and navigate /sitecore/Commerce/Catalog Management/Catalogs. Make sure you’ve selected “Habitat_Master” Catalog.

Sitecore Commerce Catalog

After that, you should smart publish your website, rebuild indexes and enjoy. Now you have Sitecore Commerce installed and connected with Sitecore Website.

Sitecore Commerce Front Page

Summary

Sitecore Commerce installation is quite tricky and sometimes could diverge from the official installation guide because of differences in environments and configurations. I hope this article will help you save some time or successfully install Sitecore Commerce. If you have any questions please feel free to ask me in the comments bellow.