Using the Notes single user to multi-user migration assistant tool
Use this procedure to convert an existing Notes® single user installation or simulated multi-user installation to a true Notes multi-user installation within a single Notes release. After migration you can then upgrade the release level of the Notes multi-user client.
Before you begin
- Review the information in the topic Understanding the Notes single user to multi-user migration assistant tool,
- To run the tool you must be logged in to Windows™ as an administrator to ensure necessary permissions for copying and moving data.
- Before running the tool, consider backing up the Notes client. For details, see the article Backing up and restoring Notes client data, included in the links at the end of this topic.
- Verify that users have required read/write/delete permission for the new target directories.
About this task
Procedure
Results
Example
- The NOTES.INI file is H:\data\notes.ini.
- The Notes installer setup.exe file is located at C:\Program Files\IBM\Lotus\Notes.
- The user's data directory is H:\data.
- The shared data directory is C:\notes\common\Lotus\Notes\data.
- The migratefilelist.txt file, located in
the directory from which you run the migration tool, specifies that
the following additional files will be moved:
- H:\data\template1.ntf
- H:\data\template2.ntf
- H:\data\template3.ntf
Migrate users based on your applicable use case as follows:
Use case 1 - Simple single user to multi-user migration for all versions of Notes
In this use case, Notes 8.5.1 is installed in single user mode with Program Files installed to C:\Program Files\IBM\Lotus Notes and data files installed to C:\Program Files\IBM\Lotus\Notes\Data,
- Migrate the registry entries to make it a true multi-user installation.
- Migrate the common files to be used by all user to C:\Documents and Settings\AllUsers\Application Data\Lotus\Notes\Data.
- Migrate the user's data files and NOTES.INI to C:\Documents and Settings\username\Local Settings\Application Data\Lotus\Notes\Data.
The values specified in the MUMigrationAssistant.ini are as follows:
DRYRUN=true
CURRENTINIPATH=C:\Program Files\IBM\Lotus\Notes\Data\notes.ini
NOTESPROGRAM=C:\Program Files\IBM\Lotus\Notes
IS_SIMULATED_MODE=false
MIGRATE_REGISTRY=true
MIGRATE_USER_REGISTRY=true
MIGRATE_SHARED_DIR=true
MIGRATE_USERDATA_DIR=true
MULTIUSERCOMMONDIR=
MULTIUSERBASEDIR=
Use case 2 - Simulated multi-user to true multi-user migration - First run of the tool to move all the shared data
In this use case, Notes 8.5.1 is installed in single user mode but each user's data directory are mapped on a network drive. Program Files are installed to C:\Program Files\IBM\Lotus\Notes and data files are installed to H:\data. When the source data directory for all users is local or resides on a common network drive, you can run the tool to move data to the target data directory location for all the users of that Notes client instance.
- Convert the HKLM registry settings to specify a true multi-user installation.
- Creates a shared data directory, C:\notes\common\Data
- Migrates the common files for all users to the shared directory.
The values specified in the MUMigrationAssistant.ini are as follows:
DRYRUN=true
CURRENTINIPATH=H:\data\notes.ini
NOTESPROGRAM=C:\Program Files\IBM\Lotus\Notes
IS_SIMULATED_MODE=true
MIGRATE_REGISTRY=true
MIGRATE_USER_REGISTRY=false
MIGRATE_SHARED_DIR=true
MIGRATE_USERDATA_DIR=false
MULTIUSERCOMMONDIR=C:\notes\common
MULTIUSERBASEDIR=H:\data
Use case 3 - Simulated multi-user to true multi-user migration with subsequent running of the tool when each user logs in to move each user's data
In this use case, Notes 8.5.1 is installed in single-user mode, but each user's data directory is resides on a mapped drive. The administrator has migrated the single-user settings on the Notes client to a multi-user installation. (as per Use case 2). Each user now logs in to the system.
- Migrate the HKCU registry entries for that particular user.
- Move the user's data from the mapped drive to the default location C:\Documents and Settings\username\Local Settings\Application Data\Lotus\Notes\Data.
DRYRUN=true
CURRENTINIPATH=H:\data\notes.ini
NOTESPROGRAM=C:\Program Files\IBM\Lotus\Notes
IS_SIMULATED_MODE=true
MIGRATE_REGISTRY=false
MIGRATE_USER_REGISTRY=true
MIGRATE_SHARED_DIR=false
MIGRATE_USERDATA_DIR=true
MULTIUSERCOMMONDIR=C:\notes\common
MULTIUSERBASEDIR=