web
You’re offline. This is a read only version of the page.
close
Skip to main content

Notifications

Announcements

No record found.

News and Announcements icon
Community site session details

Community site session details

Session Id :
Dynamics 365 Community / Forums / Finance | Project Operations, Human Resources, ... / Getting an error at ST...
Finance | Project Operations, Human Resources, ...
Answered

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

(2) ShareShare
ReportReport
Posted on by Karam Baazab 23

During the installation or configuration of Microsoft Dynamics 365 Commerce Scale Unit, the process fails at step ScaleUnitHealthcheckStep with the following error:

RealtimeServiceCheck returns Failure in the health check result.

Although the Retail Server is accessible and the DBCheck returns Success, the RealtimeServiceCheck fails, which prevents the installation from proceeding.

Categories:
Dynamics 365 Commerce
I have the same question (0)
  • Saif Ali Sabri Profile Picture
    Saif Ali Sabri 2,351 Super User 2025 Season 2 on at
    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.
  • Verified answer
    Karam Baazab Profile Picture
    Karam Baazab 23 on at
    The solution of this issue is to add RetailServiceAccount in Microsoft Entra ID applications in HQ

     

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Responsible AI policies

As AI tools become more common, we’re introducing a Responsible AI Use…

Neeraj Kumar – Community Spotlight

We are honored to recognize Neeraj Kumar as our Community Spotlight honoree for…

Congratulations to the November Top 10 Community Leaders!

These are the community rock stars!

Leaderboard > Finance | Project Operations, Human Resources, AX, GP, SL

#1
André Arnaud de Calavon Profile Picture

André Arnaud de Cal... 449 Super User 2025 Season 2

#2
Martin Dráb Profile Picture

Martin Dráb 422 Most Valuable Professional

#3
BillurSamdancioglu Profile Picture

BillurSamdancioglu 239 Most Valuable Professional

Last 30 days Overall leaderboard

Featured topics

End-of-life Announcement for Microsoft Dynamics GP

Product updates

Dynamics 365 release plans