Troubleshooting Server Deployment Issues

Deploying solutions to SharePoint farms depends heavily on the farm health. A SharePoint farm that is not running efficiently will have more issues deploying Bamboo web parts and solutions than a farm that is in good health.

Here are several things you can do to ensure there are no health issues with your SharePoint farm prior to deploying Bamboo web parts and solutions:

1. Monitor the SharePoint logs using the Microsoft ULS Viewer. Filter on Unexpected to see the most significant exceptions on your farm. Your logs should be free of Critical level errors.
2. Run the installPrecheck.ps1 script attached to this article and review the results. 
3. Install a current SharePoint CU and ensure the patches are applied. You should plan on updating SharePoint at least quarterly to ensure you have the latest fixes from Microsoft.

The most common SharePoint farm health issue is partial patching. This manifests itself with failed services, Critical ULS errors, and failed deployments. To make sure all SharePoint patches completed successfully, run the follow commands in the SharePoint command shell as Admin during a scheduled maintenance window:

stsadm -o SetProperty -PropertyName command-line-upgrade-running -PropertyValue No
psconfig -cmd upgrade -inplace b2b -force

Those commands will clear any previously "stuck" patches and complete the installation of the current patches. They will result in a temporary outage, so be sure to run these during an planned outage window in accordance with your IT governance policies.