Overview of Migration Tools

  • Article

You can customize Commerce Server 2002 migration tools to meet your needs. Source code, as well as a Software Development Kit (SDK) explaining how to customize and extend the tools are provided with Commerce Server 2002. This section provides an overview of the migration tools and how you use them.

Directory Migration Toolbox

Ad Server Migration Tool

Directory Migration Toolbox

The Directory Migration Toolbox is a set of tools and Component Object Model (COM) objects written in C++. It includes the following objects: MigrationMainObj, MigrationReadObj, MigrationWriteObj, MigrationModifyObj, and MigrationLogObj. Use these objects to migrate user data from your Membership Directory in Site Server to your Commerce Server 2002 Profiles database. The Directory Migration Toolbox includes source code so that it can be modified to suit the requirements of a given Membership Directory implementation.

The following figure provides an overview of how the migration objects work.

A figure showing an overview of how the Directory Migration tool works.

A key component of the Directory Migration Toolbox is the Directory Migration tool, which performs the actual migration. The Directory Migration tool is designed to maintain a state between multiple instances of real-time mode and a single instance of batch mode implementations. This balance is to prevent race conditions between instances of the Directory Migration tool attempting to migrate the same account. You can use the Directory Migration tool in two modes:

  • Real-time mode. Designed to migrate users as they attempt to authenticate through the Login.asp file. The normal Login.asp code is extended so that if an authentication fails due to the user profile not being in the database, the migration tool can be called to perform a "real-time" migration of the user profile to the new Profiling System in Commerce Server 2002. Once the migration is completed successfully, the Login.asp file completes the authentication of the user and normal processing resumes.
  • Batch mode. Designed to migrate users in the Membership Directory to the Profile store used by the Commerce Server 2002 Profiles service. It processes the entire list of users on a stand-alone server. Once the list is processed, the entire migration process is complete except for addressing migration failures that are logged for resolution. After you resolve the problem causing the failure, you resubmit the migration processes against the failed accounts to migrate them successfully.

Securing your migration is an important step in migrating user data from Site Server to Commerce Server 2002. You should plan security measures when planning your migration. For detailed information about securing Commerce Server 2002, see Securing Your Site.

Ad Server Migration Tool

The Ad Server Migration tool is used for migration of ad data from SSCE to Commerce Server 2002. This file name of this tool is Adservermigration.exe and it is located in the following folder: Microsoft Commerce Server 2002\SDK\Tools\SSCE Migration\Ad Server.

The Ad Server Migration tool creates expressions for target evaluation and moves the ads between Web sites. This tool also uses current expressions to drive the process of ad selection.

See Also

Migrating the Membership Directory

Copyright © 2005 Microsoft Corporation.
All rights reserved.