About this task

Review the tool as described in "Understanding the Notes single user to multi-user migration assistant tool" and run the tool as follows.

Note: Prior to running the tool consider backing up your Notes client. For details, see Backing up and restoring Notes client data in the Notes and Domino® wiki.

Procedure

1. Exit the Notes application; Notes cannot be running during the migration.

2. Locate MUMigrationAssistant.vbs and MUMigrationAssistant.ini in the Utility folder in the Notes install kit.

3. Open the MUMigrationAssistant.vbs script and review its embedded documentation.

4. Open MUMigrationAssistant.ini in a text editor and specify needed values as follows:

• CURRENTINIPATH -- Specifies the current NOTES.INI file location, The tool obtains the user's data directory location from their NOTES.INI file. This setting is required; all others are optional.
• NOTESPROGRAM -- Specifies where the user's notes.exe resides. If not specified, the tool obtains this value from registry HKLM/SOFTWARE/Lotus/Notes/version/Path first (for versions of Notes prior to 9.0) or from HKLM/SOFTWARE/Lotus/Notes/Path (for versions of Notes 9.0 or later), then from the user's NOTES.INI file.
• MULTIUSERBASEDIR -- Specifies where the user's data directory is located. The tool appends Lotus\Notes\Data for versions of Notes prior to 9.0, or appends IBM\Notes\Data for Notes 9.0 or later. When you set this value, you must include %USERNAME% in MULTIUSERBASEDIR. If you do not specify a value for MULTIUSERBASEDIR, the default value CSIDL_APPDATA is used.

  Important: If you set a value for MULTIUSERBASEDIR, then you must also set a value for MULTIUSERCOMMONDIR.

• MULTIUSERCOMMONDIR -- Specifies where the common shared data directory is located. The tool appends Lotus\Notes\Data for versions of Notes prior to 9.0, or appends IBM\Notes\Data on Notes 9.0 or later. If you do not specify a value for MULTIUSERCOMMONDIR, the default value CSIDL_COMMON_APPDATA is used.

  Important: If you set a value for MULTIUSERCOMMONDIR, then you must also set a value for MULTIUSERBASEDIR.

• DRYRUN -- If set to true (default) the tool does not actually run commands but instead generates a report indicating what the tool would have done had you actually run it. If set to false, migration occurs.

  Note: The following settings, denoted with an asterisk, are used only when migrating from a simulated multi-user Notes installation where the Notes client is installed in single user mode on one computer and multiple users are able to use Notes on that computer because their Notes data directory is mapped to H:\, which in turn is mapped to each user's private network share directory.

  Note: The following settings can be specified on the cscript command line. If a setting is specified on the command line and in the MUMigrationAssistant.ini file, the command line setting takes precedence.

  • *MIGRATE_REGISTRY= true/false -- If set to true, migrates HKLM registry settings and updates desktop shortcuts and start menu shortcuts for all users.

    Note: This applies to the AllUsers group on Windows™ and sets the machine registry settings to be multi-user. This is not the per user setting.

  • *MIGRATE_USER_REGISTRY=true/false -- If set to true, migrates registry settings and updates desktop shortcuts and start menu shortcuts only for the user running the tool.
  • *MIGRATE_SHARED_DIR=true/false -- If set to true, migrates the common data files to be shared among all users. This moves files that would have been installed to the common shared directory during a Notes multi-user installation.

    Note: If other files must also be moved, such as the user's templates, specify them in a file whose location is set to MIGRATE_SHARED_FILES.

    Note: Use the MULTIUSERCOMMONDIR option to specify the location at which to move the files or leave blank to accept the default.

  • *MIGRATE_SHARED_FILES = file_name_and_path -- Specifies a text file name and location that contains the names of additional user-defined templates or other files that were not installed by Notes, to move to the target common directory to be shared by all users.

    Note: Use with the MIGRATE_SHARED_DIR=true option.

  • *MIGRATE_USERDATA_DIR=true/false -- If set to true, migrates all of the user's personal data files (for example, user's ID file, templates, databases) to the directory specified by the MULTIUSERBASEDIR option.

    This can be configured using a command line to run for each user when they first log in to the computer.

    The option works with MULTIUSERBASEDIR to determine where to move the files. If no value is set for MULTIUSERBASEDIR, the default user data path is used. For exampl, the default of C:\Documents and Settings\username\Local Settings\Application Data\Lotus\Notes\Data is used for versions of Notes prior to 9.0, or C:\Documents and Settings\username\Local Settings\Application Data\IBM\Notes\Data for Notes 9.0 or later.

    Note: Set the value to false if you do not want the user's personal data to be moved.

    Note: This value should be set to true for every user. To run the script for every user when they first log in to the OS, create a batch file to run the script in the StartUp Group or the RunOnce registry key.

6. Close the MUMigrationAssistant.vbs script.

7. Run the migration in "dry run" mode by enabling the DRYRUN option in the MUMigrationAssistant.ini file and then using the following command line statement:

cscript MUMigrationAssistant.vbs

9. Perform the actual migration by disabling the DRYRUN option in the MUMigrationAssistant.ini file and then using the following command line statement:

cscript MUMigrationAssistant.vbs

A NOTES.INI file will be generated in the shared data directory. The original NOTES.INI file will be moved to the directory specified by the MULTIUSERBASEDIR variable. The data directory will be that specified by the MULTIUSERBASEDIR variable and the shared directory will be that specified by the MULTIUSERCOMMONDIR variable.

Example: Simulated multi-user installation to (true) multi-user installation

In this scenario, several users are configured to work on a single computer using a simulated multi-user environment and a shared drive containing their common and user-specific data files.

• The NOTES.INI file is H:\data\notes.ini.
• The Notes installer setup.exe file is in 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 addition files to move are specified in migratefilelist.txt, which consists of the following:

  Note: The .txt file resides in the directory from which you run the migration utility.

  • H:\data\template1.ntf
  • H:\data\template2.ntf
  • H:\data\template3.ntf

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.

Run the MUMigrationAssistant to do the following:

• 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.

DRYRUN=trueCURRENTINIPATH=C:\Program Files\IBM\Lotus\Notes\Data\notes.iniNOTESPROGRAM=C:\Program Files\IBM\Lotus\NotesIS_SIMULATED_MODE=falseMIGRATE_REGISTRY=trueMIGRATE_USER_REGISTRY=trueMIGRATE_SHARED_DIR=trueMIGRATE_USERDATA_DIR=trueMULTIUSERCOMMONDIR= MULTIUSERBASEDIR=

Note: Leave MULTIUSERBASEDIR and MULTIUSERCOMMONDIR blank to use the default value.

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.

Run MUMigrationAssistant as an administrator to do the following:

• Migrate the HKLM registry entries to make it a true multi-user installation.
• Migrate the common files to be used by all user to C:\notes\common\Data.

DRYRUN=trueCURRENTINIPATH=H:\data\notes.iniNOTESPROGRAM=C:\Program Files\IBM\Lotus\NotesIS_SIMULATED_MODE=trueMIGRATE_REGISTRY=trueMIGRATE_USER_REGISTRY=falseMIGRATE_SHARED_DIR=trueMIGRATE_USERDATA_DIR=falseMULTIUSERCOMMONDIR=C:\notes\commonMULTIUSERBASEDIR=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 mapped on a network drive. The administrator has migrated the single user settings on the Notes client system to a multi-user mode. (as per Use case 2 above). Each user now logs in to the system.

Run MUMigrationAssistant when the user logs in to do the following:

• 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=trueCURRENTINIPATH=H:\data\notes.iniNOTESPROGRAM=C:\Program Files\IBM\Lotus\NotesIS_SIMULATED_MODE=trueMIGRATE_REGISTRY=falseMIGRATE_USER_REGISTRY=trueMIGRATE_SHARED_DIR=falseMIGRATE_USERDATA_DIR=trueMULTIUSERCOMMONDIR=C:\notes\commonMULTIUSERBASEDIR=

Note: Leave MULTIUSERBASEDIR blank to its default value.

Related concepts
Understanding the Notes single user to multi-user migration assistant tool

Related tasks
Installing and upgrading Notes on Windows for multi-user

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Feedback on Help or Usability?

Help on Help