• Call now: US 1.877.226.2662   INTL +44 (0) 203.598.2917   
  • Home
  • Contact Us
 
 
Troubleshoot Problems with Deploying Farm Solutions
Browse Search
HOWTO: Troubleshoot Problems with Deploying Farm Solutions
Created on: 21-Apr-11. Print Article
Last Modified on: 16-Jan-13. Email Article
Skill Level: Intermediate.
Article has been viewed: 32686 times.
Rated: 6 out of 10 based on 8 votes.
KB.12662

APPLIES TO:

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

ISSUES AND RESOLUTIONS:

Issue 1:
With SharePoint 2010, 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 hive 14 during solution retraction and/or deployment.

Resolution:

1. Restart the SharePoint 2010 Administration on all of the Web Front End servers (or at least just make sure to restart the one on the WFE where the deployment failed).
Restart the SharePoint 2010 Timer service on all Web Front End servers.

The SharePoint 2010 Administration service carries out the actual removing and adding of files the GAC (Global Assembly Cache). 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 you will also need to restart the Timer service. Restarting the timer service on SharePoint 2010 will restart all SharePoint 2010 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:
http://msdn.microsoft.com/en-us/library/aa544500.aspx

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.

Resolution:

1. 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.

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


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

For more information and instructions see:

http://blogs.msdn.com/josrod/archive/2007/12/12/clear-the-sharepoint-configuration-cache-for-timer-job-and-psconfig-errors.aspx

"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."

Resolution:

For instructions and more information, see:

http://blogs.msdn.com/sudeepg/archive/2009/09/15/sharepoint-custom-solution-deployment-failure.aspx

Issue 4:

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

Resolution:

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

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?

poor 
1
2
3
4
5
6
7
8
9
10

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