Understanding the Notes single user to multi-user migration assistant tool
The single-user to multi-user migration tool converts a Notes® single-user installation to a multi-user installation.
- Convert a clean, single-user Notes installation to a multi-user installation within the same release
- Convert a simulated multi-user Notes installation (a single-user installation in which each user's data directory is mapped to shared drive to simulate a multi-user environment) to a true multi-user installation within same release
The Notes multi-user migration assistant tool runs a supplied Visual Basic script, MUMigrationAssistant.vbs, that is controlled by a customized configuration file MUMigrationAssistant.ini. You can use the configuration file to customize the migration for unique deployment environments. You can find both the script file and the configuration file in the Utility folder of the Notes installation kit.
When you run the script, it reads the configuration file, and performs the necessary migration operations, modifying user-specific NOTES.INI values and registry settings, and converting the single-user installation to a multi-user installation. You edit the configuration file before you run the script to provide user-specific details, such as the location of the source and target data directories.
Although the action of the MUMigrationAssistant.vbs script is typically controlled by the contents of the MUMigrationAssistant.ini configuration file, the script is documented internally, and can be modified directly to support uniquely customized deployments.
Notes 8.5.1 was the first release to support multi-user installations with configurable data directories. In earlier releases, administrators sometimes simulated a multi-user Notes installation by installing a single-user Notes client and then mapping user data directories to shared drives. Each user would have a unique data directory on the shared drive, thus simulating a multi-user environment. The migration tool can be used convert a simulated multi-user Notes installation to a true Notes multi-user installation.
For situations in which you need to convert a simulated multi-user installation you would run the tool two or more times. First, an administrator runs the tool to move common shared files and to modify Windows registry settings. The administrator then creates a Windows login script to run the tool automatically for each user at the next time Windows login. As each user logs in, the login script runs the migration tool and uses the settings in the configuration file to determine what changes to make.