Upgradetargetwebapplication: Stsadm operation (Windows SharePoint Services)

Applies To: Windows SharePoint Services 3.0

 

Topic Last Modified: 2008-07-10

Operation name: Upgradetargetwebapplication

Description

Prepares the environment for the gradual upgrade of a specific version 2.0 Web application by moving the existing version 2.0 Web application to a new URL and making a new version 3.0 Web application that is based on the existing version 2.0 Web application and associated settings. The version 3.0 Web application is set up to redirect any requests for content from sites that have not yet been upgraded back to the version 2.0 Web application.

Syntax

stsadm.exe -o upgradetargetwebapplication

**   -url <URL to upgrade>**

**   -relocationurl <new URL for non-upgraded content>**

**   -apidname <new app pool name>**

**\[-apidtype {configurableID | NetworkService}\]**

**\[-apidlogin \<domain\\name\>\]**

**\[-apidpwd \<app pool password\>\]**

**\[-exclusivelyusentlm\]**

Parameters

Parameter name Value Required? Description

url

A valid URL, such as http://server_name

Yes

The URL name that is to be upgraded.

relocationurl

A valid port number, such as "12345" or a host header

Yes

Relocates the existing SharePoint Web application to a new IIS site, and creates the newer version at the original location. The IIS site and existing Web application that are moved must have a new port or domain name.

An HTTP request for all content will be redirected to the proper domain throughout the gradual upgrade process.

NoteNote:
A new port or host header must be specified.

apidname

A valid application pool name, such as "Test1"

Yes

The application pool ID.

The application pool defines the account and credentials that are used by the upgraded version 3.0 Web application.

apidtype

One of the following types:

  • NetworkService

  • ConfigurableID

    NoteNote:
    If the ConfigurableID value is used, you must use the apidlogin parameter to specify a user name and password.

No

The identity type to use for the application pool.

NoteNote:
You cannot use the same application pool that you used for the previous version.

You can use the same user account, but you must create a new application pool, or use an application pool that you already created for your upgraded sites.

apidlogin

A valid user name in the form domain\username

No

The user name to use for running processes in the application pool.

This parameter must be a Windows user name, and must be qualified with a domain name.

apidpwd

A valid Windows password to the application pool

No

The password that is used in conjunction with the apidlogin parameter.

exclusivelyusentlm

<none>

No

Specifies to exclusively use NTLM authentication instead of Negotiate (Kerberos). Kerberos requires the application pool account to be a Network Service or special configuration by the domain administrator. NTLM authentication works with any application pool account and the default domain configuration.