Overview of Migration Tools
You can customize Commerce Server 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 2000. This section provides an overview of the migration tools and how you use them.
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 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.
.gif "A figure showing an overview of how the Directory Migration tool works")
Write Object
Read Object
Membership Directory
AUO/LDAP
Migration Object
Site Server
Commerce Edition
Commerce Server
Migration Request
SQL
Active Directory
User profile object
Modify
Object
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. 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 Profile 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 re-submit the migration processes against the failed accounts to migrate them successfully.
Ad Server Migration Tool
The Ad Server Migration Tool is used for migration of ad data from SSCE to Commerce Server. This tool is named adservermigration.exe and it is located in the "SDK\Tools\Migration\Ad Server" folder in the Commerce Server installation folder.
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. For more information about the Ad Server Migration Tool see ''Migrating a Site Server 3.0 Commerce Edition Site to Commerce Server 2000" in the Microsoft Commerce Server 2000 Resource Kit.