Add to My Yahoo! | Google Reader or Homepage | Add to Windows Live | Add to Windows Live Alerts

Wictor Wilén

Microsoft Certified Master (MCM) - SharePoint 2010 | Microsoft Most Valuable Professional (MVP) - SharePoint Server MVP | Author

Say hello to SharePoint STSAdm preupgradecheck command

Posted at 2009-04-28 11:00 by Wictor Wilén in SharePoint with 12 comments.

The Office 2007 Service Pack 2 are here and for the server products (WSS 3.0 and MOSS 2007) we have a new STSAdm command called; preupgradecheck. This command allows you to check any WSS 3.0 SP2 based installation for potential issues that may prevent an upgrade to Windows SharePoint Services 4 (WSS 4.0) or SharePoint Server 2010. For full reference of the command check out KB960577.

The pre-upgrade check command uses a set of rules found in the 12\CONFIG\PreUpgradeCheck\WssPreUpgradeCheck.xml file to check your farm or you can use a custom file.

This is how it looks like on a WSS 3.0 SP2 machine when run:

preupgradecheck

You will see a summary of all steps while it checks your installation for a few minutes, and when done you can open the HTML log file to dig deeper into your potential problems. There are three categories:

  • Passed (in green) - This is when everything looks fine
  • Information Only (in yellow) - You have to check the log file for more information. The log file may have references to KB articles that you have to read to fully understand what to do to make the upgrade smooth. All manual upgrades are noted here, such as customized fields, CAML views (which are replaced with the new XSLT-based views), custom site definitions (will require a special Upgrade Definition file) etc etc
  • Failed (in red) - This is when there are something that really prevents you from upgrading, read the log file to get the exact reason.

The sample image above contains two failed steps; one is about referenced features that are missing, which needs to be installed to perform an update. The second one is about the OS prerequisites, this sample is taken from a 32-bit Windows 7 which obviously is not a correct machine since only Windows Server 2008 x64 is supported on the next version of SharePoint.

It’s well worth running this command on all your installations even though you don’t plan any upgrade right now. The articles contains a great deal of information on how you can make sure that you finally can upgrade your installation smoothly. All articles does not seem to be available yet though…

Comments and trackbacks

#  Funrther information on preupgradecheck by Manish
Screenshot from websnpr Thanks for giving useful information on new STSADM command. See some further information on preupgradecheck command here: http://manish-sharepoint.blogspot.com/2009/04/new-stsadm-command-in-service-pack-2.html
#  @Manish by Wictor
Screenshot from websnpr Thanks for the link, nice post.
#  5 Reasons SharePoint 2010 PreUpgradeCheck is better than Prescan by Trackback
Screenshot from websnpr I was a huge fan of Prescan back in the early betas of SharePoint 2007 ( Prescan is your friend and Don
#  5 Reasons SharePoint 2010 PreUpgradeCheck is better than Prescan by Trackback
Screenshot from websnpr I was a huge fan of Prescan back in the early betas of SharePoint 2007 ( Prescan is your friend and Don
#  5 Reasons SharePoint 2010 PreUpgradeCheck is better than Prescan by Trackback
Screenshot from websnpr I was a huge fan of Prescan back in the early betas of SharePoint 2007 ( Prescan is your friend and Don’t
#  Preupgrade Check on Sharepoint 2007 by Genevieve Guerrero
Screenshot from websnpr I get this when trying to run the check tool on our Intranet. Any ideas or suggestions are appreciated!!! Pre-upgrade check cannot proceed because the current farm is not joined to a far m, or the farm configuration database is not responding gguerrero@cdfa.ca.gov
#  ansver: Preupgrade check on sharepoint 2007 by Michael Toft Thøgersen
Screenshot from websnpr you have to run your command with farm admin credentials. so make sure you have logged on 2007 sharepoint server with the farm-admin account for the 2007 Sharepoint installation.
#  Command does not complete successfully by Anonymous
Screenshot from websnpr I am trying to run the stsadm preupgradecheck command and it runs fine but stops at the last step with the message: "An error occured while parsing EntityName.line 11, position 72" It does not create the 'xml' or 'htm' file. The command was working fine a few months back when I tried it, but it gives this error now. Any suggestions how to resolve it?
#  @Anonymous by Wictor
Screenshot from websnpr Check the ULS logs for more information
#  stsadm by linda
I try running the command and I get does not support this cmdlet. I'm using powershell v1.0 Share Point 2007
#  SharePoint Consulting by olive
Screenshot from websnpr First I would like to appriciate you for the valuable information sharing with us. Thanks for making informative blog. An integral part of SharePoint consulting is SharePoint farming.
#  SharePoint by velien
Screenshot from websnpr You own a very interesting blog covering lots of topics I am interested as well. SharePoint Consulting is a platform for the most admired companies to work together and pull resources.
Make a comment on this post:
Subject:  

Your name:  
Your Url:  
Note: submissions may have to be approved before being visible, so don't submit your comment multiple times.