Createcmsmigrationprofile: 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: Createcmsmigrationprofile

Description

Creates a migration profile by providing a profile name, database server name, database name, and database user name.

Important

This operation is case-sensitive. If you run the operation by using an uppercase "C", the following error message is displayed: "Windows SharePoint Services administration tool has encountered a problem and needs to close. We are sorry for the inconvenience."

Syntax

stsadm -o createcmsmigrationprofile

-profilename <profile name>

**\[-description\] \<description\>**

**\[-connectionstring\] \<connection string\>**

**   -databaseserver <server>**

**   -databasename <name>**

**   -databaseuser <user name>**

**\[-databasepassword\] \<password\>**

**\[-auth\] \<authentication type\>**

**   -destination <URL name>**

**\[-rootchannel\] \<channel name\>**

**\[-destinationlocale\] \<LCID\>**

**\[-migrateresources\]**

**\[-migrateacls\]**

**\[-emailto\] \<e-mail addresses\>**

**\[-emailon\]**

**\[-keeptemporaryfiles\]**

**\[-enableeventreceivers\]**

Parameters

Parameter (short name)

Value

Required?

Description

profilename

A valid profile name, such as "Profile1"

Yes

Name of the migration profile

description

A valid description, such as "This is my description"

No

Description of the migration profile

connectionstring

No

Provides the information to connect to the Microsoft Content Management Server 2002 database, including the server name, database name, user name, password, and authentication type.

databaseserver (ds)

A valid database server, such as "Databaseserver1"

Yes

Database server that hosts the Microsoft Content Management Server 2002 database and that contains the content to be migrated

Note

The name of the database must be for an installation of Microsoft Content Management Server 2002.

databasename (dn)

A valid database name, such as "Databasename1"

Yes

Database name on the server for Microsoft Content Management Server 2002 from which the content will be migrated

databaseuser (du)

Yes

Database user name to access the Microsoft Content Management Server 2002 database

databasepassword

No

Database password for the user

auth

Any one of the following values:

  • Windows authentication

  • SQL authentication

No

Specifies the authentication type. By default, Windows authentication is enabled.

destination

A valid URL, such as http://server_name

Yes

Specifies the URL of the site collection to which the content will be migrated.

rootchannel

A valid channel name, such as “Channel1”

No

Channel that will be the root Web for the destination site collection (for example, top level site). Only the content in and below the selected site will be migrated.

destinationlocale

A valid locale ID, such as "1033" for English

No

Specifies the language to use for the migrated sites.

migrateresources

Any one of the following values:

  • All

  • Onlyused

No

Specifies whether all shared resources should be copied into the destination site collection or only the shared resources that are used by the pages that are being migrated.

When the all value is used, all resources will be migrated during the next migration, even those that are not used and not changed (only applies to full migrations). However, the onlyused value is appropriate only when resources are actively being used by content in the site.

Note

During the incremental migration, only shared resources that are being used by pages in or under the selected root will be updated.

migrateacls

<none>

No

Specifies whether or not to migrate Access Control Lists (ACLs) from Microsoft Content Management Server 2002.

emailto

A valid e-mail address in the form: someone@example.com

No

When the migration job is finished, sends a notification of success or failure to a list of e-mail addresses. Use semicolons to separate multiple e-mail addresses.

emailon

Any one of the following values:

  • Success

  • Failure

  • None

  • Both

No

Use with the -emailto parameter. Sends a notification of success, failure, none, or both to a list of e-mail addresses.

keeptemporaryfiles

Any one of the following values:

  • Never

  • Always

  • Failure

No

Specifies whether the temporary exported files should be removed after migration.

enableeventreceivers

Any one of the following values:

  • Yes

  • No

No

Enables or disables event tracking.

For performance reasons, by default, the enableeventreceivers parameter is disabled during the import process. However, if a case exists where the events need to be captured (for example, if you have a third-party Web Part that relies on these events), this parameter can be enabled to track the events.