Dynamics Community Forum Thread Details

Getting an error at STEP 28 during the installation of Commerce Scale Unit

The error you're encountering during Step 28 (ScaleUnitHealthcheckStep) indicates that the RealtimeServiceCheck is failing, even though the Retail Server and database are accessible. This is a common blocker during Commerce Scale Unit installation, typically caused by one or more of the following issues with the Realtime Service (RetailServer) configuration.

✅ Root Cause

The error:

perl

ExpectedFailureException: Request to https://<host>/RetailServer/healthcheck?testname=ping&resultformat=json encountered an error

...means the installer is attempting to hit the Retail Server’s health check endpoint, but is failing due to a service, network, or configuration issue.

🔧 Solution Steps

Follow these steps to resolve the issue:

1. Verify Retail Server Endpoint

Manually open the following URL in a browser (on the Retail Server VM itself or via curl/Postman):

arduino

https://<RetailServerFQDN>:710/RetailServer/healthcheck?testname=ping&resultformat=json

You should get a 200 OK response and a JSON response like:

json

{ "Ping": "Success" }

If not:

Ensure the Retail Server site in IIS is running.
Ensure SSL binding is correct on port 710 (or whatever port your environment uses).

2. Check Self-signed or Expired SSL Certificate

In IIS → RetailServer site → Bindings, ensure the HTTPS binding uses a valid certificate.
If it's a self-signed cert, ensure it's:
- Trusted by the local machine.
- Not expired.
- Matching the FQDN used in the health check URL.

📌 Tip: You can regenerate and rebind a new self-signed cert if needed.

3. Check Application Pool Identity & Permissions

Make sure the RetailServer App Pool is running.
The identity should have:
- Permissions to access the database.
- Permissions to read from the registry and file system as required by RealtimeService.

4. Enable Detailed Logging for Realtime Service

To gather more info:
- Enable verbose logging in web.config of the RetailServer (found under IIS root → RetailServer folder).
- Restart IIS and retry the health check.

5. Firewall / Port Blockage

Ensure port 710 is open and not blocked by Windows Firewall or NSG rules if running in Azure.
Use PowerShell:

powershell

Test-NetConnection -ComputerName <RetailServerFQDN> -Port 710

6. Retry the Installer

After confirming the health check works in a browser or via curl, restart the installer from step 28 using the RetailDeployTool.exe or rerun the task sequence.

✅ Optional: Bypass RealtimeServiceCheck (Not Recommended for Production)

In a dev/test environment, if you're blocked and want to proceed, you can temporarily bypass the health check by editing the deployment manifest. Not advised unless you're sure the system is stable.

Let me know if you need help inspecting the Retail Server config, logs, or the deployment manifest.

Quick Links