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:
- Stop the OWSTIMER service on ALL of the MOSS servers in the farm.
- 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.
- Delete all the XML file in the directory. NOTE: ONLY THE XML FILES, NOT THE .INI FILE.
- Open the cache.ini with Notepad and reset the number to 1. Save and close the file.
- Start the OWSTIMER service on the Index server and wait for XML files to begin to reappear in the directory.
- 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.
- 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
