Preupgradecheck: Stsadm operation (Office SharePoint Server)

Stsadm

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.

Operation name: Preupgradecheck

Runs rules that are intended to assist administrators in preparing for upgrade from Windows SharePoint Services 3.0 and related products to future version of SharePoint and Technology products.

For more information, see the Remarks section and Pre-upgrade scanning and reporting for future releases (Office SharePoint Server).

NoteNote:
The preupgradecheck operation was first introduced in Microsoft Office SharePoint Server 2007 with Service Pack 2 (SP2).

Syntax

stsadm -o preupgradecheck

   -[rulefiles <rule file name>]

   -[listrulefiles]

   -localonly

Parameters

Parameter name

Value

Required?

Description

rulefiles

A valid rule file

No

Specifies which rule files to use for the detection routines.

Requires a quoted, delimited (comma or semicolon) list of rule file names without additional path information. The default setting is to run all rules.

listrulefiles

<none>

No

Lists each detected rule file without executing check routines.

If XML fields are supported in a list rule file, the Name and Description fields of the XML rule file will be displayed.

The default setting is not to list rule files.

localonly

<none>

Yes

When this parameter is enabled, it checks the local server with rules marked with the localonly attribute and then runs them.

Remarks

The preupgradecheck operation calls the core execution engine and runs detection routines. The preupgradecheck operation runs in default mode without any parameters, will detect each rule file in the rule file directory (that is, "%commonserverfiles%/Microsoft Shared/web server extenstions/12/config/preupgradecheck"), and then execute each of them sequentially. A subset of rules files can be specified using the localonly parameter.

Examples

To check the local server only, and skip doing farm level checks, use the following syntax:

stsadm -o preupgradecheck –localonly

To return the set of rules in the "%commonserverfiles%/Microsoft Shared/web server extensions/12/config/preupgradecheck" directory, use the following syntax:

stsadm -o preupgradecheck -listrulefiles