Upgrade: Stsadm operation (Office SharePoint Server)

Applies To: Office SharePoint Server 2007

This Office product will reach end of support on October 10, 2017. To stay supported, you will need to upgrade. For more information, see , Resources to help you upgrade your Office 2007 servers and clients.


Topic Last Modified: 2015-03-09

Operation name: Upgrade


Upgrades the specified site collection during a gradual upgrade. For information on upgrading sites, see Upgrade sites (Office SharePoint Server). This operation is also used by PSConfig, which can perform an in-place upgrade, gradual upgrade, or upgrade your server. For additional information about PSConfig, see Command-line reference for the SharePoint Products and Technologies Configuration Wizard (Office SharePoint Server)


stsadm.exe -o upgrade

**   {-inplace |**

**   -sidebyside}**

**\[-url \<URL name\>\]**



**\[-farmuser \<farm user\>\]**

**\[-farmpassword \<farm user password\>\]**


**\[-sitelistpath \<sites XML file\>\]**


Parameter name Value Required? Description



Yes. Either the inplace or sidebyside parameter is required.

Specifies an in-place upgrade, where the version 2.0 sites are upgraded immediately, and the version 2.0 environment is not available after the upgrade process is complete.

Although version 2.0 databases and settings will be upgraded to version 3.0 during this process, the version 2.0 software is not removed during in-place upgrade, and must be removed separately.



Yes. Either the inplace or sidebyside parameter is required.

Specifies a gradual upgrade in which the version 2.0 sites are preserved in the version 2.0 environment.


When you perform a gradual upgrade from the command line, you cannot upgrade groups of sites from different content databases. If your Web application contains a large number of sites spread across multiple content databases, break the list into smaller groups of sites contained within the same content database, and upgrade each group in a separate upgrade pass.


A valid URL, such as http://server_name


The version 2.0 URL of the site collection that you want to upgrade.




Specifies whether or not to force the upgrade.




Specifies that the upgrade process is run in quiet mode.


A valid user name in the form domain\username


Specifies the user account to use in performing the upgrade.


A valid Windows password for the farm account


Specifies the password for the FarmUser account.




Specifies whether to reset pages to site definition (also known as reghost) during upgrade.


A valid XML format in the form:

<RedirectedSites Count="2”>  <Site Url="http://server_name" TargetDatabase="DB1" />     <Site Url="http://server_name/sites/site1"  TargetDatabase="DB1" /> </RedirectedSites>

The Count and TargetDatabase attributes are optional.

Specify just the set of sites you want to upgrade from a single content database.


Allows you to specify an XML file with a list of specific site collections to upgrade.

Alternatively, use the command stsadm –o enumsites –url <V3url> -redirectedsites to produce this same XML for site collections.