Upgrade: Stsadm operation (Windows SharePoint Services)
Applies To: Windows SharePoint Services 3.0
Topic Last Modified: 2007-07-12
Operation name: Upgrade
Description
Upgrades the specified site collection during a gradual upgrade. For information on upgrading sites, see Upgrade sites (Windows SharePoint Services). This operation is also used by the 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 (Windows SharePoint Services)
Syntax
stsadm.exe -o upgrade
** {-inplace |**
** -sidebyside}**
**\[-url \<URL name\>\]**
**\[-forceupgrade\]**
**\[-quiet\]**
**\[-farmuser \<farm user\>\]**
**\[-farmpassword \<farm user password\>\]**
**\[-reghost\]**
**\[-sitelistpath \<sites XML file\>\]**
Parameters
| Parameter name | Value | Required? | Description |
|---|---|---|---|
inplace |
<none> |
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. |
sidebyside |
<none> |
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. Note 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. |
url |
A valid URL, such as http://server_name |
No |
The version 2.0 URL of the site collection that you want to upgrade. |
forceupgrade |
<none> |
No |
Specifies whether or not to force the upgrade. |
quiet |
<none> |
No |
Specifies that the upgrade process is run in quiet mode. |
farmuser |
A valid user name in the form domain\username |
No |
Specifies the user account to use in performing the upgrade. |
farmpassword |
A valid Windows password for the farm account |
No |
Specifies the password for the FarmUser account. |
reghost |
<none> |
No |
Specifies whether to reset pages to site definition (also known as reghost) during upgrade. |
sitelistpath |
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. |
No |
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. |