- WSS 3.0 and MOSS 2007
- SharePoint Foundation 2010/2013 and SharePoint Server 2010/2013
ISSUES AND RESOLUTIONS:
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:
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:
- 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. "
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:
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
MSDN Blog: Issues Deploying SharePoint Solution Packages
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