IBM Support

What Windows Registry settings are involved when upgrading Notes?

Technote (FAQ)


Question

When you install or upgrade a Lotus Notes® installation, what Microsoft Windows® Registry settings does Notes look for?

Answer

User independent settings for Notes are stored under the following key in the Registry:


    HKEY_LOCAL_MACHINE\Software\Lotus\Notes.

The following settings are directly beneath the Notes key: DataPath, Description, MultiUser, Name, and Path. These values are determined by the last Notes installation and are overwritten by succeeding installations. Below "Notes" is normally only one subkey with the major version number (7.0) of the installed Notes client (7.0.1).

In HKEY_CURRENT_USER\Software\Lotus\Notes, there is also one subkey: Installer. This contains the following settings: DATADIR, ISMUI, NOTESDATAPATH, NOTESPATH, PROGDIR, and so on.

Since Notes 6 and later releases, the Installer itself uses the Registry to store information.

Note: Manipulating the Registry is not supported by IBM/Lotus.

If part of the Registry key is missing or the key was not completely removed, there may be problems with installing or upgrading a Notes client and errors such as the following may display:
    MSI ERROR: "UpgradeUtils/RemoveExistingFiles (Line xxxx): Error - 'GetPropertyFromRegistry' for 'PATCHING' failed with return code '2' - The system cannot find the file specified."

    MSI ERROR: "UpgradeUtils/INTL_UpdateMUIDAT : Error - 'GetPropertyFromRegistry' for 'MUI_ISO' failed with return code '2' - The system cannot find the file specified."

    MSI ERROR: "UpgradeUtils/RemoveObsoleteFiles : Error - 'GetPropertyFromRegistry' for 'PATCHING' failed with return code '2' - The system cannot find the file specified."

    MSI ERROR: "UpgradeUtils/RemoveObsoleteFiles : Error - 'GetPropertyFromRegistry' for 'SHAREDINSTALL' failed with return code '2' - The system cannot find the file specified."

    MSI ERROR: "UpgradeUtils/RemoveObsoleteFiles : Error - 'FAILED to rename lotusnotes.sy2 to ' for 'C:\lotus\notes\lotusnotes.sym' failed with return code '2' - The system cannot find the file specified."

    MSI ERROR: "UpgradeUtils/RemoveObsoleteFiles : Error - 'FindFirstFile' for 'C:\lotus\notes\*.sym' failed with return code '2' - The system cannot find the file specified."

    ** MSI ERROR: "UpgradeUtils/INTL_RemoveUpdateMUIDAT (line 4766): Error - 'GetPropertyFromRegistry' for 'MUI_ISO' failed with return code '2' - The system cannot find the file specified."

    ** This error (above) is identified in Document #1212400, "Smart Upgrade returns what appears to be an error." In this case, Notes did not actually complete the upgrade. It was determined that the NOTESVERSION had been deleted from the Registry key, HKEY_CURRENT_USER\Software\Lotus\Notes\Installer. This issue was reported to Quality Engineering as SPR# SOSI6KJRHP and was fixed in the Notes/Domino 6.5.6, 7.0.3, and 8.0 releases.

*************************************************
The following errors (not necessarily in this order) indicate that the install is finding R6 installation Registry keys on the system that weren't removed and/or were applied as part of an upgrade to a higher version:
    MSI ERROR: "UpgradeUtils/uiInitialize : Error - 'GetPropertyFromRegistry' for 'NOTESVERSION' failed with return code '2' - The system cannot find the file specified."

    GetProperty Success: UpgradeUtils/INTL_IsMuiIns got 'NotesClient,NotesClient65,NotesClientUpgrade,MUINotesClient,MUINotesClient65,MUI,fr' for 'ISReleaseFlags' from MSI

    Function INTL_IsMuiIns: Release flags TRUE

    NotesClient,NotesClient65,NotesClientUpgrade,MUINotesClient,MUINotesClient65,MUI,fr
    UpgradeUtils/IsUninstall: Entered

    GetProperty Success: UpgradeUtils/IsUninstall got '' for 'REMOVE' from MSI
    UpgradeUtils/IsUninstall: This is NOT an uninstall
*************************************************
If there is no key, you have the following options:
    * Create a Kit Document for a full install in the Smart Upgrade database.

    * Run the Windows Installer cleanup (supported by Microsoft) to ensure the previous version was cleanly removed and the Notes-relevant Registry keys are all gone.

    * Address this issue on an individual basis by running a full install separately from the upgrade process.

Related information

Smart Upgrade returns what appears to be an error

Document information

More support for: IBM Notes
Install/Setup

Software version: 6.0, 6.5, 7.0, 8.0

Operating system(s): Windows

Reference #: 1297990

Modified date: 09 February 2009


Translate this page: