Troubleshooting StoreFront Upgrade Issues

Troubleshooting StoreFront Upgrade Issues

book

Article ID: CTX201213

calendar_today

Updated On:

Description

Unable to upgrade StoreFront.

Resolution

Use the following steps to troubleshoot StoreFront upgrade issues:

  1. Confirm that there is a snapshot/backup of the StoreFront servers before attempting an upgrade.
  2. Verify the upgrade is being performed from StoreFront 1.2 to 2.0 ONLY, or from 2.0 to 2.x and so on.
  3. If the StoreFront server is part of a Server Group Deployment, then all servers in the group must be upgraded sequentially. Simultaneous upgrades of a StoreFront Server Group Deployment is NOT supported.
  4. Verify that there are no thumbs.db files located in the inetpup/wwwroot/citrix and subdirectories. You should be able to view hidden files to complete this step: go to Folder Options > View, set the options to ‘Show hidden files, folders and drives’. Remove the option to ‘Hide protected operating system files (Recommended)’. Search the inetpup/wwwroot/citrix and subdirectories for thumbs.db, if you find any then delete them.
  5. Ensure to disable the antivirus before starting the upgrade procedure.
  6. Confirm the servers that are being upgraded are removed from any load balancer and there are NO active user sessions to the server.
  7. Reboot the server before performing the upgrade.
  8. Manually stop the following Services:
    • CitrixConfigurationReplication
    • CitrixCredentialWallet
    • CitrixDefaultDomainService
    • CitrixPeerResolutionService
    • CitrixSubscriptionsStore
  9. Make sure the Management console for StoreFront is NOT open.
  10. Perform the install of the upgrade.
  11. If the Upgrade fails, open the latest CitrixMsi*.log in C:\Windows\Temp\StoreFront and search for any “exception” error.
  12. Is the exception for “Thumbs.db Access”? If so, see #4 above. Open Windows Explorer, set Folder Options to view hidden files, search C:\inetpup\wwwroot\citrix and it’s subdirectories for any thumbs.db files and delete any found.
  13. Is the exception for “Cannot get exclusive file access \in use”? Preferably restore the snapshot/backup if available.If not, restart the server, and stop any StoreFront services manually.
  14. Is the exception for “Service cannot be started”? Preferably restore the snapshot/backup if available. If not, install the full version of the .NET framework 4.5 (not client profile).
  15. If no “exception” was found in the CitrixMsi*.log, check the server’s Event Viewer > Delivery Services for any errors containing any of the above exception error messages. If so, follow the steps corresponding with the exception error message above.
  16. If no exception error was found in the Event Viewer, check the Admin logs in C:\Program Files\Citrix\Receiver StoreFront\logs for any of the above exception errors.
  17. If the you do not want to preserve any existing information then you can manually remove StoreFront and then reinstall it. To manually remove Storefront:
    1. Remove Citrix StoreFront
    2. Remove Web Server Role
    3. Delete “Receiver StoreFront” folder from C:\Program Files\Citrix
    4. Delete any subdirectories under C:\Program Files\Citrix\StoreFront Install
    5. Delete “Inetpub” folder under C:\
    6. Run the StoreFront Installer.

Issue/Introduction

This article lists the troubleshooting steps to resolve StoreFront upgrade issues.