The Notes multi-user migration assistant tool runs a supplied Visual Basic script (MUMigrationAssistant.vbs), which in turns is driven by a customized configuration file (MUMigrationAssistant.ini). The configuration file enables you to customize the migration for your unique deployment environment. The tool files are supplied in the Utility folder of the Notes install kit.

There are two use cases for this migration tool:

• Clean single user Notes installation to multi-user installation within same release
• Simulated multi-user Notes installation (a Notes single user installation where each user's data directory is mapped to shared drives to simulate a multi user environment) to true multi-user installation within same release

Note: While the MUMigrationAssistant.vbs script can be edited, it is designed to be used as supplied with a customized configuration file MUMigrationAssistant.ini. The editable configuration file is supplied in the install kit's Utility subdirectory. However, the MUMigrationAssistant.vbs script is documented internally, so opening the script and reviewing the embedded comments is helpful. The tool provides basic functionality and you can modify the script for your own environment. Most installations can be addressed by just editing the configuration file. However, for uniquely customized installations, you can edit the MUMigrationAssistant.vbs script as needed.

As an administrator, you'll edit fields in the supplied configuration file with user-specific details such as location of the old and new data directories.

Note: Be sure to have enabled permission for needed read/write/delete operations in those directories.

When you start the MUMigrationAssistant.vbs tool, it reads the configuration file and performs the necessary migration operations, including modification of user-specific NOTES.INI values and needed registry setting changes, and migrates the single user install to a multi-user install.

Understanding a simulated multi-user Notes installation

Notes 8.5.1 introduced install options to configure MULTIUSERBASEDIR and MULTIUSERCOMMONDIR directory paths. In Notes 8.5.1 we introduced install options to configure MULTIUSERBASEDIR and MULTIUSERCOMMONDIR directory paths. A simulated multi-user Notes installation was sometimes used prior to the support of a configurable data directory. A simulated multi-user installation is a single user Notes client installation where the user's data directory is mapped to a shared drive. Each user who logs in to the system will have their own data directory on their shared drive, thereby simulating a multi-user environment. The MUMigrationAssistant tool migrates user data and registry entries properly to move from the simulated multi-user Notes installation to a true Notes multi-user installation.

1. An administrator runs the MUMigrationAssistant for the admin user on the system where they have access to the mapped data drive for a specific user.

2. The MUMigrationAssistant tool runs and does the following:

• Creates a shared data directory
• Modifies registry settings to multi-user
• Moves the current user's data from the mapped drive, for example H:\, to the value specified in the MULTIUSERBASEDIR.option

  Note: To keep "as is" you can set MULTIUSERBASEDIR to H:\ and set MIGRATE_USERDATA_DIR=false.

• Modifies shortcuts
• Registers itself in the registry to indicate that it has been run once

4. As each user logs in, the MUMigrationAssistant tool runs again and migrates that user's data as per the configuration ini file.

Run the tool initially to migrate the common files shared between all users, and also modify the registry settings entries for the whole machine. As each user logs in, a login script is run, with different parameters, which moves only that user's data from his mapped drive and also modifies that user's registry settings.

Considerations

The following considerations exist:

• Migration is only available for Notes client installations that were installed in single user mode and Notes-only mode. Single user installations in which Domino® Designer and/or Domino Administrator were also installed are not supported. An "unsupported configuration" message appears if the source install is not single user and if the single user install is an Allclient installation.
• To run the tool you must be logged in to your Windows OS as an administrator to allow permissions for copying and moving of data.

  Note: Exceptions exist if you are migrating from a simulated multi-user installation, see the "Understanding a simulated multi-user Notes installation" section above.

• You can run the migration tool in two modes -- "dry run" and "actual." In dry run mode, you receive a report indicating what the tool would have done had you actually run it.
• The tool writes actions information to the LotusInstall.log. The LotusInstall.log file resides in the installing user's My Documents folder and the migrated user's data directory.
• When the source data directory is local or is on a shared network drive for all users on the machine, an administrator can run MUMigrationAssistant.vbs and provide the target data directory locations in the MUMigrationAssistant.ini file for all the users on the machine.
• When the source data directory is mapped on each user's network share, the MUMigrationAssistant.vbs must be run separately for each user. Each user logging in would then execute MUMigrationAssistant.vbs, which would have permission to read from each user's network share.
• MULTIUSERBASEDIR, MULTIUSERCOMMONDIR and MIGRATE_USERDATA_DIR are only available on Notes 8.5.1 and greater.
• MULTIUSERBASEDIR and MIGRATE_USERDATA_DIR can only be used with MULTIUSERCOMMONDIR.
• MIGRATE_USERDATA_DIR is for use when migrating a simulated multi-user installation to a true multi -user installation.
• Prior to Notes 8.5.1, the configurable data directory was not supported, thus MIGRATE_USERDATA_DIR = false is not available for those releases. If using the MIGRATE_USERDATA_DIR option on a Notes 8.5 or earlier release, user data will be migrated to the default user's data directory.
• For Notes 8.5.1 release and later, the MULTIUSERBASEDIR is available. If using MULTIUSERBASEDIR in combination with MIGRATE_USERDATA_DIR=false, the data directories of existing users will not be migrated to the default location however the data directories of users created after migration will be created in the user's default data directory.

Before the tool performs the migration it verifies the following checkpoints. If the NOTESPATH or CURRENTINIPATH are not valid, migration will stop. If the other settings are not specified or are incorrect, migration will continue.

Note: The MULTIUSERBASEDIR and MULTIUSERCOMMONDIR settings must either both be specified or not be specified at all.

• NOTESPATH -- Confirms that the setting points to a directory that contains a notes.exe
• CURRENTINIPATH -- Confirms that the setting points to a directory that contains NOTES.INI, and that the tool has permission to read the NOTES.INI
• Current® data directory -- The tool reads the Notes data directory path from NOTES.INI, and checks the migrate file list to confirm that each file exists in the data directory and that the tool has permission to operate on these files.
• MULTIUSERCOMMONDIR -- The tool confirms that all users have permissions to read this directory. If not using the default value, it checks that the value includes the %USERNAME% environment variable.
• MULTIUSERBASEDIR -- Confirms that the setting points to an existing directory and that it tool has read/write permission to that directory.
• Verifies read and write permissions to access the following registry keys.

  For versions prior to 9.0:

  • HKLM/SOFTWARE/Lotus/Notes/version/DataPath
  • HKLM/SOFTWARE/Lotus/Notes/version/MultiUser
  
  For version 9.0 and later:
  • HKLM/SOFTWARE/Lotus/Notes/DataPath
  • HKLM/SOFTWARE/Lotus/Notes/MultiUser
• MIGRATEFILELIST -- Verifies that the files or directories are valid and that it has permission to operate on those files
• Additional checks for simulated multi-user Notes installation -- If specified, confirms that the following option values are usable during migration: MIGRATE_REGISTRY, MIGRATE_USER_REGISTRY, MIGRATE_SHARED_DIR, MIGRATE_SHARED_FILES, MIGRATE_USERDATA_DIR, and IS_SIMULATED_MODE

If a multi-user kit (multi-user source installation) is detected on the system the tool exits with a message indicating that the installation is already multi-user.

Related tasks
Using the Notes single user to multi-user migration assistant tool

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Feedback on Help or Usability?

Help on Help