Preparetomove: Stsadm operation (Office SharePoint Server)

Updated: April 2, 2009

Applies To: Office SharePoint Server 2007

Updated: 2009-04-02

Operation name: Preparetomove

Used to temporarily stop the profile and membership synchronization service to synchronize user profile information to a specific site collection or a specific content database. Administrators run preparetomove before doing operations that result in change content databases ID or site collection ID; this includes moving a site collection from one content database to a different one.

The profile and membership synchronization service synchronizes user profile data down to the user information lists for all site collections to ensure consistent user data across the environment. The service also synchronizes site membership data back to the user profiles that store all of the sites where the user is a member. This site membership data is displayed on the user’s My Site. Not running preparetomove where required can cause deletion of user membership metadata. This metadata includes the selections made in the Privacy and Grouping section on the Edit Profile page for My Site memberships.

For additional information about how to configure group and privacy settings within a personalization site, see Manage personalization policies1.

Important Important:

Before moving a site collection between content databases, the preparetomove operation must be run in order to ensure all user membership metadata are correctly preserved.

Syntax

stsadm -o preparetomove

   -contentdb <server name: database name>

   -site <URL name>

   [-oldcontentdb] <unique identifier>

   [-undo]

Parameters

Parameter Value Required? Description

contentdb

A valid content database GUID, such as "WSS_Content_21d186e1-7036-4092-a825-0eb6709e9285"

Yes

The name of the content database that is to be moved to a new Web application.

To determine the database name, use the Enumcontentdbs: Stsadm operation (Office SharePoint Server)2 operation.

site

A valid URL, such as

"http://server_name"

Yes

URL of the site that is to be moved to a new Web application.

oldcontentdb

A valid content database GUID, such as "21d186e1-7036-4792-a825-0eb6709e9235"

No

When the preparetomove operation is not run prior to moving the content database, synchronization can fail on a particular content database that has been moved to a new Web application. Synchronization is fixed for that content database.

undo

<none>

No

Undoes the last preparetomove operation, for example, if you decide not to move the site or content database.

See Also

Links Table
1http://technet.microsoft.com/en-us/library/cc263140.aspx
2http://technet.microsoft.com/en-us/library/cc262488.aspx
3http://technet.microsoft.com/en-us/library/cc263115.aspx
Community Content Add
Annotations FAQ
Please update this document to prevent confusion
Seriously Microsoft.. If there is issue with this command after Infrastructure Update or SP2, please put the remarks in BOLD.. I am seriously confused now if I should run this command or not..
Seriously. Can someone at MS plese update this!
Better yet - why not completely remove the command from STSADM?!
Indeed: don't use this command if the Infrastructue Update is installed!

Brad Cote correctly states not to use this command in certain situations if the infrastructure update is installed. However, the link he provides didn't work for me. Below another link and again the suggestion that information in this article is updated accordingly.

http://social.technet.microsoft.com/Forums/en/sharepointadmin/thread/f04af6d1-6cf6-437c-b93e-a25f7715676e

Don't use this command if the Infrastructure Update is installed!
See -

http://technet.microsoft.com/en-us/library/cc262122.aspx

It would be professional if the documentation for this command were updated accordingly.