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:
- Confirm that there is a snapshot/backup of the StoreFront servers before attempting an upgrade.
- Verify the upgrade is being performed from StoreFront 1.2 to 2.0 ONLY, or from 2.0 to 2.x and so on.
- 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.
- 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.
- Ensure to disable the antivirus before starting the upgrade procedure.
- Confirm the servers that are being upgraded are removed from any load balancer and there are NO active user sessions to the server.
- Reboot the server before performing the upgrade.
- Manually stop the following Services:
- CitrixConfigurationReplication
- CitrixCredentialWallet
- CitrixDefaultDomainService
- CitrixPeerResolutionService
- CitrixSubscriptionsStore
- Make sure the Management console for StoreFront is NOT open.
- Perform the install of the upgrade.
- If the Upgrade fails, open the latest CitrixMsi*.log in C:\Windows\Temp\StoreFront and search for any “exception” error.
- 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.
- 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.
- 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).
- 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.
- 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.
- 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:
- Remove Citrix StoreFront
- Remove Web Server Role
- Delete “Receiver StoreFront” folder from C:\Program Files\Citrix
- Delete any subdirectories under C:\Program Files\Citrix\StoreFront Install
- Delete “Inetpub” folder under C:\
- Run the StoreFront Installer.
Issue/Introduction
This article lists the troubleshooting steps to resolve StoreFront upgrade issues.
Was this article helpful?
thumb_up
Yes
thumb_down
No