Edit

Share via

Download and install Commerce Scale Unit

This article explains how you can download and install a Commerce Scale Unit (CSU) on one or more computers in a brick-and-mortar store.

CSU combines the Commerce channel database, Commerce Async Client, Retail Server, and Cloud point of sale (POS) components. A Commerce environment already provides these components in the cloud, but you can now configure them so that they work locally in a store or datacenter.

Download the sealed self-hosted installer

Note

Sealed CSU installers are only available from the Microsoft Dynamics Lifecycle Services (LCS) Asset library.

To download the sealed self-hosted CSU installer, follow these steps.

  1. Open a web browser and sign in to Microsoft Dynamics Lifecycle Services.
  2. From the home page, select Shared asset library.
  3. Select Retail Self-service package.
  4. If you already have a sealed CSU installer in your list, select the package name to start the download.
  5. If you don’t have a CSU sealed installer in the list, select Import, select the sealed installer version you want to use, select Pick, and then select the package name to start the download.
  6. Copy the sealed installer from the Downloads folder to C:\temp.

Download the Commerce Scale Unit channel configuration file

To download the Commerce Scale Unit channel configuration file, follow these steps.

  1. In headquarters, go to Retail and Commerce > Headquarters setup > Commerce scheduler > Channel database.

  2. In the list of channel databases on the left, select the channel database that you created earlier.

  3. On the Action Pane, select Download.

  4. On the drop-down menu, select Configuration file.

    Note

    For on-premises deployments, currently the configuration file requires the following manual edits:

    • StoreSystemAosUrl should have the value used to access headquarters. There must be a trailing slash at the end of this URL (for example, https://myContosoURL.com/namespaces/AXSF/).
    • Microsoft Entra IDTokenIssuerPrefix should have the value https://NOTUSED.microsoft.com.
    • TransactionServiceAzureAuthority should have the value https://<ADFS FQDN including .com>/adfs.
    • TransactionServiceAzureResource should have the base URL value of the StoreSystemAosUrl value. For example, https://myContosoURL.com is the base URL value, after removing the /namespaces/AXSF/ portion of the URL.

  5. On the notification bar that appears at the bottom of the Microsoft Edge window, select Save. (The notification bar might appear in a different place in other browsers.) Save the XML configuration file to the same location as the installer (for example, C:\temp\StoreSystemSetup.xml).

    Browsers might block the download pop-up that is generated. If the pop=up is blocked, select either Allow once or Options for this site > Always allow, and then select Download again.

Install the sealed CSU

The process of installing a sealed CSU usually employs a configuration file downloaded from headquarters that contains all of the information needed for Retail Transaction Service (RTS) authentication. If you don't use a configuration file, you must specify parameters such as --AadTokenIssuerPrefix, --StoreSystemAosURL, --StoreSystemChannelDatabaseId, and --TenantId. For a full list of installer commands, see Mass deployment of sealed Commerce self-service components.

To install the sealed CSU, follow these steps.

  1. Open a Windows Command Prompt with administrator privileges.
  2. Change the directory to C:\temp (for example, CD C:\temp).
  3. Execute the following command.
CommerceStoreScaleUnitSetup.exe install --port 446 --SSLCertThumbprint "<SSL thumbprint of certificate created earlier>" --RetailServerCertThumbprint "<SSL thumbprint of certificate created earlier>" --AsyncClientCertThumbprint "<SSL thumbprint of certificate created earlier >"  --AsyncClientAADClientID "<CSU Azure APP Client ID>" --RetailServerAADClientID "<CSU Azure APP Client ID>" --CPOSAADClientID "<CPOS Azure APP Client ID>" --RetailServerAADResourceID "<Application ID URI>" --Config "c:\temp\StoreSystemSetup.xml" --SkipSChannelCheck --trustSqlservercertificate

Note

  • When you install the sealed CSU on a development machine, you're allowed to use the same SSL thumbprint to run all services. For production and user acceptance testing (UAT) environments, these values should be different.
  • Don't enter port 80 or 443 during installation. Entering either of these values interferes with the application object server (AOS) service that hosts Commerce headquarters.

Health check

As a final step, the installer automatically executes a health check and shows the results.

To check the health of a CSU at any time, you can access a specific URL in a web browser. The URL format is https://<CommerceScaleUnitURL>/healthcheck?testname=ping. Replace <CommerceScaleUnitURL\> with the actual URL of your CSU instance. Be sure to include the port number specified during installation. Accessing this URL executes a ping test and returns results indicating whether the CSU is reachable and healthy.