Command-line-upgrade-running: Stsadm property (Windows SharePoint Services)

Applies To: Windows SharePoint Services 3.0

 

Description

Specifies whether the upgrade process has already been started.

The PSConfig tool checks this property before allowing upgrade to continue. For additional information on the PSConfig tool, see Command-line reference for the SharePoint Products and Technologies Configuration Wizard (Windows SharePoint Services).

For example, if an upgrade is started using the stsadm command line tool, you will not able to start another upgrade process from the user interface. If you try to start a second instance of upgrade, the following error message will be displayed:

"Unable to upgrade SharePoint Products and Technologies because an upgrade is already in progress. Upgrade progress can be monitored using the Central Administration Web Application or by monitoring the upgrade log on server "X"."

"X" is the name of the server that initiated the upgrade process.

Syntax

stsadm -o setproperty

-propertyname command-line-upgrade-running

-propertyvalue {Yes | No}

**\[-url** \<https://server\_name\>**\]**

The syntax for the getproperty operation is:

stsadm -o getproperty

propertyname command-line-upgrade-running

**\[-url** \<https://server\_name\>**\]**

Note

You can substitute -pn for -propertyname and -pv for -propertyvalue.

Property values

The following table shows possible values.

Name

Value

propertyname

Gets or sets the name of the property.

propertyvalue

Yes: Checks to see if an upgrade process is running. This is the default setting.

No: Does not check to see if an upgrade process is running.

url

Typically, a path to the URL of the Web application, in the form http://server_name.

Remarks

This property is provided as a fail-safe in case the upgrade process is abruptly stopped or if an error occurs during an upgrade process. While unlikely, it is possible to get into a state where the farm thinks that upgrade is running on one computer, but in reality the upgrade process has stop responding. In this unlikely scenario, the administrator could reset the command-line-upgrade-running property so that the upgrade process could be run again.

Examples

To reset the command-line-upgrade-running property where an upgrade process stopped responding and no upgrade process is running, use the following syntax:

stsadm -o setproperty -pn command-line-upgrade-running -pv Yes