Terminal Server/Citrix Multi-User Install Fix for v6.00/6.01

Notes on the Multi-User Install method

At this time, there appears to be a bug in the R6 client install that prevents the Multi-User Install from working properly “out of the box” in a Terminal Server environment. According to several unofficial reports, this may be corrected in R6.02? This document describes how to manually correct the Notes client installation’s failures in order to allow the Multi-User Install to function as IBM/Lotus apparently intended it to in a Terminal Services/MetaFrame environment.

One thing to consider however is if this method will work for your environment. Although this method works great for a single Terminal Server install, IBM/Lotus apparently did not take into consideration how this method would affect load balanced server farms. Common and Shared data amongst all users are stored in C:\Documents and Settings\All Users\Application Data\Lotus\Notes\Data. Some user-specific information is stored in the profile of each user at C:\Documents and Settings<username>\Local Settings\Application Data\Lotus\Notes\Data. As far as I have determined this user information store is not location-configurable which means that a user may not end up with the same data if the next time they log in they are routed to a different server in the farm. This of course could be remedied by a roaming profile but considering the content of the this information store, do you really want to push this data to each server every time a user logs into a server? Perhaps someone else with more knowledge of Lotus Notes can think of a workaround for this? Or perhaps even tell me if this really matters even…

Client Installation Procedure

  1. As an administrator, change the server to Install Mode (Change User /Install) and begin the install process by running X:\CLIENTS\W32INTEL\SETUP.EXE from the Lotus Notes client CD.

  2. Accept the license agreement.

  3. Use the company name in the Name field instead of a person’s name so that an individual’s name does not appear on every client run by various users.

  4. Choose the For all users of this computer (Multi-User Install) option.

  5. Install the Program Files in a local directory on the server.

  6. Leave the default components selected (unless additional components are necessary, i.e. administrative client install).

  7. After completing the installation click Finish. Change the server back to Execute mode. (Change User /Execute).

DO NOT launch the Notes Client at this time!

  1. Edit the NOTES.INI file in the %SystemRoot% directory to look like this:

[Notes]

KitType=1

SharedDataDirectory=C:\Documents and Settings\All Users\Application Data\Lotus\Notes\Data\Shared

InstallType=6

  1. Move (Cut/Paste) the edited %SystemRoot%\NOTES.INI to C:\Documents and Settings\All Users\Application Data\Lotus\Notes\Data. The actual destination here may vary depending on the server setup. To find the actual destination for your server, check the value of the VDIR_INI string at HKCU\Sotware\Lotus\Notes\Installer in the registry of the administrative usercode used to install the Notes client.

NOTE: Due to the manner in which the NOTES.INI is located, having a “blank” one present in the %SystemRoot% location (or any location that exists in the windows PATH statement) may cause the client to appear as if it has not been configured under certain circumstances (e.g. 3rd party integration via the C+ API).

  1. Enter the Registry Editor and go to HKLM\Software\Lotus\Notes. Delete any value present for the DataPath string. Change the MultiUser DWORD to 1. Repeat this for the same variables also found under HKLM\Software\Lotus\Notes\6.0. NOTE: Do not delete or modify the DataPath or MulitUser variables themselves, just their values.

Now when you log into Terminal Services/MetaFrame as a user, the client config will appear and work as if it were a Windows 2000 Professional station. The only issues remaining are how to distribute the Notes ID files and migrate the existing Lotus Notes user settings. However, being a standard Lotus Notes administration issue I’ll leave that to you the Lotus Notes Administrator.

Subject: Terminal Server/Citrix Multi-User Install Fix for v6.00/6.01

For what it’s worth, this still applies to Notes 7.01 on Windows Server 2003.

Subject: RE: Terminal Server/Citrix Multi-User Install Fix for v6.00/6.01

Great Reponse!

I just want to add a small update for those of you who will try to apply these settings in a x64 Windows environment with Terminal Services:

The key for 64 bit is this:

HKLM\SOFTWARE\WOW6432Node\Lotus\Notes\

Regards,

Gabriel Sirbu

Subject: Terminal Server/Citrix Multi-User Install Fix for v6.00/6.01

I use a different method that has worked fine for citrix farms for many years.

The idea is to install a standard non-roaming non-MultiUser Lotus Notes client on the servers and point the datadirectory to the users home directory.

Remember to move the notes.ini to the user directory and either put the path for the notes data dir in the environment settings.

Then the user can logout from one server and login on another server and get the same data with no delay. However this does create the need for high network bandwith. It is quite simple, but works all the times. Furthermore it enables you to install the PC’s the same way, program files on C: and data files on home users directory - and also move notes.ini.

When you first install notes on the server login as an install/admin account and create a share e.g. U: for that user (keep the drive the same as your normal users). Then move notes.ini to the data dir on the home directory and and then take a copy of your data dir.

When you need to add new users to the citrix server just copy this data dir to the users home dir and then login as the user - the user should then be asked to configure his notes client.

After this you can try to speed up this installation by moving static files away from from the data dir to the citrix servers and also the PC’s if you are using the same method for installing PC’s.

There is only one copy of notes.ini and user.id for any user in this setup and they are always backed up, because they reside on the users home dir.

Subject: Bravo…worked like a charm…gracias