Troubleshooting StoreFront propagation issues

Troubleshooting StoreFront propagation issues

book

Article ID: CTX206872

calendar_today

Updated On:

Description

StoreFront propagation fails to complete.

The issue can manifest itself with any of the following errors:

  • StoreFront Error: "Propagation Failed on One or More Servers"
  • StoreFront Propagation Fails with Event ID: 31 "Could not find a part of the path"
  • StoreFront Error: "Event ID 19 Failed to Get the End Status of the Configuration Update, Unable to Propagate Changes in StoreFront"
  • StoreFront Error is recorded in the event viewer logs: Cannot find path to E:www/web.config.
  • StoreFront Error: "Event ID 9 - The replication channel failed to open. Synchronization is disabled"

Resolution

Complete the following steps to troubleshoot this issue:

  1. Close all the StoreFront MMC consoles except the console on the primary server (server where you are propagating changes from).

  2. Close any PowerShell windows that are open on all of the StoreFront servers.

  3. Open Services and confirm Citrix Credential Wallet Service is running on all StoreFront servers in the group.

  4. Open Services and confirm Citrix Configuration Replication service is started on all StoreFront servers in the group.

    If the service fails to start, try setting the Configuration Replication service to use the local system identity, instead of Network Service (Network Service is the default account). Only required if the service cannot be a member of local administrators.

  5. Open MMC > File > Add & Remove Snap-In > Local Users and Groups > Groups > Administrator > Properties > Members and confirm the NT SERVICE\CitrixConfigurationReplication and NT SERVICE\CitrixClusterService account is included in the local Administrators group on the StoreFront server.

  6. Confirm Both StoreFront servers are in a trusted domain.

  7. Turn off Windows Firewall and disable any Antivirus from all of the StoreFront servers when troubleshooting StoreFront propagation issues.

  8. Use Telnet from each of the StoreFront servers to confirm that all StoreFront servers are listening on port 808. For more information see CTX101810 - Communication Ports Used by Citrix Technologies.

  9. Confirm that IIS is using the same disk drive for the directory /Inetpub/wwwroot on all StoreFront servers. If IIS is using different disk drives propagation will fail. 

  10. Examine Event Viewer for any errors on the StoreFront servers. Most errors include messages like the following:

    MessageAction
    A folder exists that needs to be created.Delete the folder specified on all the other StoreFront servers except the one you are propagating from
    An IIS application exists that needs to be created.Remove the application specified on all the other StoreFront servers except the one you are propagating from.
    A Windows service exists that needs to be created after a previous failed attempt.Remove the Windows Service specified by using the command sc delete <service name> on all the other StoreFront servers except the one you are propagating from.
  11. If any folders were deleted as instructed in the previous step, follow Steps 12 – 15. Otherwise, skip to Step 14.

  12. Locate the Framework.xml file in C:\Program Files\Citrix\Receiver StoreFront\Framework\FrameworkData folder and save a backup on all StoreFront servers except the one you are propagating from.

  13. Search and delete the opening instance tag, closing instance tag, and data in between containing the store/site you recently deleted in Step 10. 

  14. If Client Deployment was configured on the StoreFront server propagating from, remove both the Mac and Windows Directories from the C:\Program Files\Citrix\Receiver StoreFront\Receiver Clients path.
  15. Ensure that the web.config file are on the same drive on both StoreFront servers.

  16. Reboot the servers and try to propagate again.

Issue/Introduction

This article lists the steps to troubleshoot propagation issues in a StoreFront group.