US 1.877.212326.2662
Browse Search
HOWTO: Troubleshoot Problems with Deploying Farm Solutions
Created on: 21-Apr-11. Print Article
Last Modified on: 06-May-14. Email Article
Skill Level: Intermediate.
Article has been viewed: 62197 times.
Rated: 6 out of 10 based on 33 votes.


  • WSS 3.0 and MOSS 2007
  • SharePoint Foundation 2010/2013 and SharePoint Server 2010/2013


Issue 1:
With SharePoint 2010 and 2013, we sometimes see failures when trying to copy assemblies to the Global Assembly Cache (GAC) or remove assemblies or other files from the bin or 14 or 15 hive during solution retraction and/or deployment.


1. Restart the SharePoint 2010/2013 Administration service on all of the Web Front End servers (all servers on the farm where the Foundation Web Application service is running).
Restart the SharePoint 2010/2013 Timer service as well.

The SharePoint Administration service carries out the actual removing and adding of files during deployment. This works most of the time and the service will release the handle on a file.
However, if the Administration service does not release the handle on the file, then deployment can fail. Restarting the timer service on SharePoint 2010/2013 will restart all SharePoint 2010/2013 timer jobs and you will need to delay installation for a while, until all of those jobs have had a chance to complete.

2. Remove the solution.

3. Reinstall the solution.

For more information, see:

Issue 2:

Deployment fails, and the reason is not clear from the error shown in installation feedback (or just shows time out errors), or the Bamboo GUI installer appears to stop in the middle of the deployment, and eventually times out.

The Timer Job Definitions in Central Administration may show one or more persistent "one time" timer jobs listed.

Manual installations using stsadm also fails to complete the installation.


1. Delete the one-time timer jobs listed in the timer job definition list.  Restart the SharePoint 2010/2013 Timer service on each server in the farm running the Foundation Web Application service.
Try the installation again.

2. Any solutions that show up in on the Solution Management page in Central Administration with a status of "undeployed" or "error" need to be either deployed manually in Solution Management, or removed, if you are going to run the Bamboo GUI installer.   For more information, see:  PROBLEM: Installation stops at the Repair, Remove or Install screen
2. Run the stsadm installation using the -local rather than the -immediate parameter for stsadm -deploysolution.  This will not invoke the timer service.  As stated in the Technet article below:

-local "Deploys the solution synchronously on the local computer only. The timer service is not used."

You will have to run the deploysolution with the -local parameter on each server running the Windows SharePoint Services Web Application service or Foundation Web Application service.

For more information about deploysolution, see:
Deploysolution: Stsadm operation (Office SharePoint Server)

For more information about which server is running the Windows SharePoint Services Web Application Service, look in Central Administration:

- on SP 2007 in Operations > Servers in Farm

- on SP 2010 in System Settings > Manage Servers in this Farm

3. Clear the SharePoint Configuration cache. The Web Front End servers may be out of sync.

For more information and instructions see:

"If you experience issues with WSS and MOSS timer jobs failing to complete are receiving errors trying to run psconfig, clearing the configuration cache on the farm is a possible method for resolving the issue. The config cache is where we cache configuration information (stored in the config database) on each server in the farm.  Caching the data on each server prevents us from having to make SQL calls to pull this information from the configuration database.  Sometime this data can become corrupted and needs to be cleared out and rebuilt.  If you only see a single server having issues, only clear the config cache on that server, you do not need to clear the cache on the entire farm. To do a single server, follow the steps below on just the problem server.

To clear the config cache on the farm, follow these steps:

  1. Stop the OWSTIMER service on ALL of the MOSS servers in the farm.
  2. On the Index server, navigate to:                          

    Server 2003 location: Drive:\Documents and Settings\All Users\Application Data\Microsoft\SharePoint\Config\GUID and delete all the XML files from the directory. 
    Server 2008 location: Drive:\ProgramData\Microsoft\SharePoint\Config\GUID and delete all the XML files from the directory.

  3. Delete all the XML file in the directory. NOTE: ONLY THE XML FILES, NOT THE .INI FILE.
  4. Open the cache.ini with Notepad and reset the number to 1. Save and close the file.
  5. Start the OWSTIMER service on the Index server and wait for XML files to begin to reappear in the directory.
  6. After you see XML files appearing on the Index server, repeat steps 2, 3 & 4 on each query server, waiting for XML files to appear before moving to subsequent servers.
  7. After all of the query servers have all been cleared and new .xml files have been generated, proceed to the WFE and Application servers in the farm, following steps 2, 3, 4 and 5 for each remaining server. "

Issue 3:

Error message: "Copying of this file failed. This operation uses the SharePoint Administration service (spadmin), which could not be contacted. If the service is stopped or disabled, start it and try the operation again."


For instructions and more information, see:

Issue 4:

Error message: "This solution contains resources scoped for a Web application and must be deployed to one or more Web applications."


Usually this can be resolved by running the Bamboo GUI installer, removing the product, and then reinstalling it.

We have also found that if the solution is showing up in the Solution Management page as installed but not deployed, you can try to run a manual deployment using stsadm.
INFO: Best Practices for Installing Bamboo Products  
Also see:
MSDN Blog: Issues Deploying SharePoint Solution Packages

Issue 5:

After an apparently successful deployment, you see errors about not being able to find file(s) when attempting to view products on a page.

Be sure to exclude directories such as %systemroot%\Program Files\Common Files\Microsoft Shared\Web Server Extensions from file level antivirus scanning, or you may find that files that were deployed there will be removed when the antivirus scan runs.

For more information, see:  Technet: Certain folders may have to be excluded from antivirus scanning when you use file-level antivirus software in SharePoint

Related Articles
Q12462 - HOWTO: Manually Activate and Deactivate Site Collection Features and Web Application Features for PM Central in SharePoint 2010
Q12464 - INFO: Best Practices for Installing Bamboo Products
Q12630 - HOWTO: Migrate Bamboo Products from SharePoint 2007 to SharePoint 2010
Q12732 - HOWTO: SharePoint 2010 solution deployment when Claims Based Authentication is configured

Article Attachments
No Attachments Available.

Related External Links
No Related Links Available.
Help Us Improve This Article
What did you think of this article?


Tell us why you rated the content this way. (optional)
Approved Comments
No user comments available for this article.