30.12.2007
SnTT: Installing and running Notes R5, 6, 7 and 8 concurrently
>>Author: Thomas Bahn
>>Ort: Raisdorf
URL: http://www.assono.de/blog/d6plinks/Running-Notes-R5-6-7-8-concurrentlyCategory: Show-n-Tell Thursday, Lotus Notes, Administration

There is a saying here: A picture tells more than 1000 words:
What do you see? It's Notes R5, 6, 7 and 8 Standard running concurrently on one Windows machine, and side by side the Notes Client, Domino Designer and Administrator of each version - no image manipulation (besides scaling), no VMs, no tricks...
Here is another image, a screenshot of the Process Explorer (a world class, free to use Task Manager replacement) showing the processes:
By the way, notice that there aren't separate processes for the 3 clients (Client, Designer, Administrator) of the 4 versions! And look at the memory usage just after I have started the clients, but haven't worked with them.
But this post is about installing and running different versions of Notes concurrently on one Windows XP machine.
There are two main point to consider, when you want to install different version of Notes:
- File system: Where is your program folder? Where is your data folder?
- Windows registry.
File system
Over time, depending on the kind of Notes client (Notes client only or with Admin & Designer), if it's a multi-user installation or not, there are different defaults for the program folder of the Notes client. I decided to use a different and consistent schema for their naming on my notebook:
%ProgramFiles%\Notes5,
%ProgramFiles%\Notes6,
%ProgramFiles%\Notes7 and
%ProgramFiles%\Notes8
(The content of %ProgramFiles% depends on the language version of Windows XP and the boot drive. In German Windows it's normally C:\Programme.)
Then I have a separate partition for my data, therefore I don't store the data folders under the program folder, but in
D:\Notes\Notes5,
D:\Notes\Notes6,
D:\Notes\Notes7 and
D:\Notes\Notes8
This naming schema isn't mandatory at all, but it helps me organizing all clients and folders.
Windows registry
IBM decided to store user independent settings of the Notes client under the following key in the Windows registry: HKEY_LOCAL_MACHINE\Software\Lotus\Notes. In fact, this is no real decision, but just the standard Microsoft has set.
There are some setting directly beneath the Notes key: DataPath, Description, MultiUser, Name and Path. Their values are determined by the last Notes installation: they just get overwritten by each installation.
Below Notes is normally only one subkey, with the major version number (e.g. 6.0) of the installed Notes client (e.g. 6.5.6).
In HKEY_CURRENT_USER\Software\Lotus\Notes is one subkey: Installer - and in it are a lot of settings, like DATADIR, ISMUI, NOTESDATAPATH, NOTESPATH, PROGDIR etc.
Observant readers might have seen, that there are more registry keys like Notes 5 or Notes 8 in the screen shots. They are my "invention" to store the original subkey for each version installed.
First installation: Notes R5
Lets say, we have a newly installed Windows XP, on which Notes wasn't installed anytime before. And lets begin to install the versions of Notes in ascending (i. e. historical) order, that is Notes R5 in my case.
I always install the "Notes Client, Domino Designer & Admin" version of the client. This is never a multi-user install, and thus there is only one program and one data folder, you can place anywhere you want. In my case I set C:\Programme\Notes5 as program folder and D:\Notes\Notes5 as data folder. After the installer has completed its work, I open the Registry Editor, jump to HKEY_LOCAL_MACHINE\Software\Lotus\Notes, export the complete registry subtree to D:\Notes\HKLM-Software-Lotus-Notes(5).reg and rename it to HKEY_LOCAL_MACHINE\Software\Lotus\Notes 5. After that, I reimport the registry file. As result I have two identical subtrees HKEY_LOCAL_MACHINE\Software\Lotus\Notes and HKEY_LOCAL_MACHINE\Software\Lotus\Notes 5. Now I can setup the client, run and use it.
Next installation: Notes 6
Before installing another version of Notes, I hide the current installation of Notes R5:
- I rename C:\Programme\Notes5 to C:\Programme\Notes5x,
- rename D:\Notes\Notes5 to D:\Notes\Notes5x and
- delete HKEY_LOCAL_MACHINE\Software\Lotus\Notes in the registry.
The started Notes 6 installer doesn't see anything from Notes R5 and thus doesn't change anything, like the notes.ini. It just installs Notes 6 into C:\Programme\Notes6 and D:\Notes\Notes6 as I told it to. Afterwards I do the same as before: export HKEY_LOCAL_MACHINE\Software\Lotus\Notes to D:\Notes\HKLM-Software-Lotus-Notes(6).reg and rename it to HKEY_LOCAL_MACHINE\Software\Lotus\Notes 6. After that, I reimport the registry file for Notes R5 (D:\Notes\HKLM-Software-Lotus-Notes(5).reg) and 6 (D:\Notes\HKLM-Software-Lotus-Notes(6).reg) one after another.
Since Notes 6, the installer itself uses the registry to store some information. Therefore I additionally rename HKEY_CURRENT_USER\Software\Lotus\Notes to HKEY_CURRENT_USER\Software\Lotus\Notes 6.
Now I can setup and work with Notes 6 and still with Notes R5 - at least when I remember to rename the program and the data folder back to their original names.
Next installation: Notes 7
Before installing Notes 7, again I make "tabula rasa" by appending an x to the two program and to the to data folders and deleting the HKEY_LOCAL_MACHINE\Software\Lotus\Notes registry key. The registry key for the Notes 6 installer is still renamed and therefore "invisible".
After the installation of Notes 7 into its planned destination, the export of HKEY_LOCAL_MACHINE\Software\Lotus\Notes into D:\Notes\HKLM-Software-Lotus-Notes(7).reg and renaming it to HKEY_LOCAL_MACHINE\Software\Lotus\Notes 7, the renaming of HKEY_CURRENT_USER\Software\Lotus\Notes to HKEY_CURRENT_USER\Software\Lotus\Notes 7, the reimport of all three reg files, the setup of Notes 7 and taking back the renamings of the former Notes folders, I can run all 3 versions of Notes.
Next installation: Notes 8 Standard
Besides the installation of Notes 8 takes ages, it's not different from Notes 7, so I don't repeat every details, just in short:
- Rename folders,
- delete registry key,
- install Notes 8,
- export HKEY_LOCAL_MACHINE\Software\Lotus\Notes,
- rename registry keys to HKEY_LOCAL_MACHINE\Software\Lotus\Notes 8 and HKEY_CURRENT_USER\Software\Lotus\Notes 8 respectively,
- reimport all 4 reg files,
- setup Notes 8 and
- rename folders back.
Now you can run Notes R5, 6, 7 and 8 on one Windows machine!
There is still one word missing: concurrently.
But this is easy (and widely known): notes.exe checks when started, if another instance of Notes is running. In this case, a warning is displayed and the execution aborted. Instead of notes.exe use nlnotes.exe, which doesn't do this check. For your convenience, create a shortcut to nlnotes.exe, set the corresponding data folder as working directory, optionally set another icon and use this shortcut to start the Notes client. To start the Domino Designer or Domino Administrator, use the bookmark icon in the Notes client.
With Notes 8 this got more complicated: notes.exe starts the Notes Standard client, but nlnotes.exe starts the Notes Basic client. If you want to use the Notes 8 Standard client, you have to start it before any other clients.
Next issue: When you click on the bookmark icon for Domino Designer or Domino Administrator in the Notes 8 Standard client and another Notes client is running concurrently, its Designer or Administrator is started instead of version 8's.
Third-party products
Before installing a third-party product, which integrates into the Notes client, I usually delete the HKEY_LOCAL_MACHINE\Software\Lotus\Notes registry key and import only the one reg file for the version of Notes, I want to install the product into. After the installation, I reimport the other reg files, again.
Upgrades
For upgrades of an installed version of the Notes client, I do the same as for third-party products, but additionally rename the version dependent installer registry key back to HKEY_CURRENT_USER\Software\Lotus\Notes and rename the other program and data folders. After the upgrade, I export a new reg file and take the pre-installation actions back.
Conclusion
All in all, this is a quite simple and stable method to get all Notes client installed and running concurrently. In fact, it is so simple that it could be easily automated by batch or WSH scripts.
By the way, I haven't installed Notes R4 again the last time I reinstalled my notebook, since we don't have any customers anymore on this version. (Yes, we have customers sitting on R5. And they have problems getting the upgrade budget, because their parent company still runs Notes/Domino R4 and is happy with it!

Comments
Thanks for this great article, a very profound explanation on the subject! Just a question: is the order of installation important, or is it just the way you did it?
Unless I missed something ...
SO THANKS IBM FOR SCREWING UP MY WORK-ENVIRONMENT!
why can those people just not supply an installation-program where you can easily install multiple notes clients beside each other??!!
(anyway I am going to follow your guidelines cause I need the damn software installed)
you can ignore the first error. The installer wants to unregister a dll, which it cannot see, because the folder has been renamed. When it installs the new client, it registers the dll of the new version and overwrites the registry value.
The second error I had myself installing the 8.0.1 Standard client. I haven't investigated the issue in depth, but it didn't came, when the path to the setup program didn't contain any spaces. So
C:\Notes 8.0.1\...
is bad (error) and
C:\Notes8.0.1\...
is good (installation without any errors).
ATTENTION: I don't mean the path, to which the Notes Client is installed into, but from.
HTH
Thomas
Thanks for the great article. concurent running of different domino versions, is very vital in my current job. Your article helped to set it up the way it should be. Thanks again.
is there any chance to get the registry keys from V 5,6 &7 as a file from someone?
I did, for all the years I work with Notes/Domino, allways install Notes on a separate, clean machine (not the one I am working with) and then just copied the program files and data files to my working machine (with propperly named directories). That means I do not have ANY registry entry for Lotus Notes at all, from none of the Notes versions I used.
Getting a registry set from someone who "correctly" did the job as above, would help me to be able to use the discussed methodology from now on, because I could import the set, change it to my paths and export it again.
Othewise I would have to go the hard way and install all the stuff - what a waste of time ...
Thanks in advance
Juergen
Thank you for this great article.
Would this work on Vista?
Nahal
I haven't tested it (yet), but I assume, this will work on Vista, too.
Thomas
i'm using 4 versions of Notes, from 5 to 8.5, along last 2 years without registry editors :) be more simply.
i'm install notes at virtual machine (use virtual pс 2007), copy folder at my computer (usially c:\lotus\notes5, c:\lotus\notes6 etc), manually edit notes.ini and create shortcuts.
That's all! Notes clients works as usially. I can reinstall windows, use xp x86 and x64 and work in Notes with pleasure.
ps I'm lotus developer, certified lotus specialist from 2000 year, not lamer :)
pps sorry my english :)
thanks for your suggestion. Using VMs with WMware or Virtual PC is indeed a simple solution for this problem, but for quite some cost. In your example, you need at least 4 Windows client licences (assuming, you've installed one Notes client in the host system). And I don't know, if you need additional Windows-CALs, too.
Thomas
in my case at this time, I have a R8 and R8.5, and it seems that u will need to make small changes in your process, since R8 and R8.5 have the same entry in the registry, HKEY_LOCAL_MACHINE\Software\Lotus\Notes\8.0
I changed the reg entry of the R85 to 8.5, so far, they are running fine separated, I really dont need to run them concurrently
and there were 2 more entries under lotus that reference the installation folder (lotus\notesR85, before 8.5 was lotus\notes) I didnt touch them.
Thank u again.
Daniel.
also I'm getting some error messages and strange behaviours ... cheers !
Really cool....
I'm intersted to run two or more session of Notes 7, how can I do this?
Many thanks
However as a an added tip, I like to create the following folders:
D:\Notes\Data
D:\Notes\Data\Mail
D:\Notes\Data\Databases
D:\Notes\Data\Projects
..
..
In these folders I place all my common databases so for instance my mail file goes in
D:\Notes\Data\Mail\mikemail.nsf
Next I put a consistent set of directory link files in each installed data directory
mail.dir => D:\notes\data\mail
databases.dir => D:\notes\data\databases
projects.dir => D:\notes\data\projects
Now whichever client I run I have access to a common set of DBs and my mail file is specified in the location document relative to the data directory mail\mikemail.nsf
Saves loads of space as don't need duplicate replicas for each client.
thank you for your great tip.
You can use directory links (or even database links, i.e. text files with .nsf extension and the "real" file path of the database in the first line), but this limits your ability to open the different versions of the Notes clients concurrently. You'ld get an "database is in use" error.
Thomas
If you don't use design elements or features added after R5, you can simply use the database, opening it with the R5 Notes client on the 8.5 Domino server. You can even create a local replica or copy on your R5 Notes client and use it locally.
Why do you ask?
i have following this procedure in order to installa 7.0.2 and 8.5.
but now i have one problem:
Notes 8.5 Client not starting very well and notes2.exe task is alway on 50% of the CPU. any action performed in the client the CPU for notes2.exe works on 50% and not action is performed. Very Very slowing and impossible to work.
But Domino Designer 8.5 work very good.
Also the realease 7.0.2 work very good coexistence.
Actually for me it is impossible to use the 8.5 client.
I have a notebook with Windows XP Professional SP3, T7500 Centrino 2, 2GB RAM...a good notebook.
i have report this problem also in the 8.5 LN forum:
{ Link }
I haven't experienced this behavior. What happens, when you start the 8.5 standard client via nlnotes.exe in the 8.5 programs directory?
Thomas
i need runnig two notes same version (8.5.1 standart) to two different servers.
Maybe anybody do this?
thanks
First of all Thanks to Thomas for this great article.
(Sorry for my bad English)
I'm running R7 and R8.5 Servers on my Local machine(PC), i'm running R7 and R8.5 clients in the same machine. I'm able to run both R7 & R8.5 Clients concurrently but i'm unable to connect their respective servers at a time. Instead i need to quit one server(R7) and run other server(R8.5), the issue here is HTTP and SMTP servers shutdown if I run other server.
Is it possible to connect to both the servers respectively while i'm running two clients.
Thanks.
sunny
- when you use virtualization or
- when you use Microsoft's Loopback adapter to assign the machine different IP adresses and use notes.ini parameters to bind each server to a different IP address.
Independent of the operating system and the server software, only one process can bind itself to a given port for one specific IP address. HTTP uses port 80. When a browser sends a request to 80, only one program should be able to answer this request. Therefore you have to change either the port or have different IP addresses.
Can I use VMWare Workstation for virtualization?
Could you please provide me detialed information on virtualization, and how to install a server on VMware and access it.
You can find a instruction, how to install the virtualization software in the internet. Sorry, but this is out of bounds for a blog comment (and free consultancy).
Nice Article, could you explain the followinging.
How did you solve the problem to start the correct Designer, Administrator when another Notes client is running concurrently with R8.
Afterwards you can start Notes 6 and 7 through nlnotes.exe and from within the clients the Domino Administrator and the Domino Designer.
if i strat the file nlnotes from 8.5 directory the client WORKS CORRECTLY. VERY GOOD !
wath is the difference from LN 8.5 start link on desktop/Start program notes.exe and start from C:\Programs\lotus\Notes8\nlnotes.exe ?
[Quote]Hi Dadoo dd,
I haven't experienced this behavior. What happens, when you start the 8.5 standard client via nlnotes.exe in the 8.5 programs directory?
Thomas Gravatar Image
Gesendet von Thomas Bahn um 16:02:35 am 16.10.2009 | - Web-Seiten -[Quote]
In Notes starting from version 8, this is a little bit different. notes.exe still checks, if Notes is already running, but then starts the Eclipse-based client. nlnotes.exe still starts the "old" C++-based client, now called Basic client (without checking).
at today i have no idea what why the Eclipse client does not start on my pc !
follow your this article i have both 7.0.2 and 8.5. I wish to upgrade the 8.5 to 8.5.1 ... it possibile to launch the installation pack of 8.5.1 or i need to separate the installation with the registry in order to have both 7.0.2,8.5 and 8.5.1 ?
thank you
Dadoo dd
I had difficulties with the upgrade, so I deinstalled 8.5 (without deleting the notes.ini, nsf and other files) and installed 8.5.1 in the same directories as 8.5 before.
But my difficulties with the upgrade could be due to other products, I've installed (Noteshound, ezSuite, Designer Search, etc.)
i need runnig two notes same version (8.5.1 standart) to two different servers.
Maybe anybody do this?
thanks
[advertisment removed by article author] }
No chance to cross certify an ID?
I don't think, it's possible to run two Standard clients concurrently. Perhaps, running the Standard client and the Basic client concurrently will satisfy your requirments?
Then you could try this: Copy your data directory and the notes.ini (in the program directory). Modifiy the copy of the notes.ini to point to the copy of the data directory. Start nlnotes.exe with the notes.ini copy as command line argument.
I haven't tested this myself, but it could work...
Thomas
i didn't have the diskspace for different data paths (and double databases) so i used a tool called "LinkShellExtension" and created some junctions from Notes7\data\xxx to Notes6\data\ as a junction - which works fine.
Just want to let you know - maybe other users had also insuficent diskspace - specially by using big databases...
Thomas
this is very good info, but I had several problems. I installed Lotus Notes v8.5 and then added the 8.5.1 FP3 patch. First install no problem, runs well on Windows 7 ... but then, I try to follow the process and noticed that in the registry I cannot find: HKEY_LOCAL_MACHINE\Software\Lotus\Notes.
I did find HKEY_CURRENT_USER\Software\Lotus\Notes but this means I cannot do the 2nd install because it detects the previous one ... any ideas?
The reason I need to run two instances of Notes is because I got 2 IDs, in different servers and one needs a VPN connection to access the mail database.
Help please!
When you install 32 bit software like Notes on a 64 bit Windows 7 machine, the registry information is written to
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Lotus\Notes
instead of
HKEY_LOCAL_MACHINE\SOFTWARE\Lotus\Notes
BUT when a 32 bit application opens the registry, it "sees" everything under
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\...
in
HKEY_LOCAL_MACHINE\SOFTWARE\...
instead!
TIA - The Fonz
I just wondered that it worked for you starting Notes 8 Standard client after Notes R5. I always had to do it the other way round.
Just try to start the Notes 8.5.2 Standard client (notes.exe), from within the client start the Designer. Then start Notes R5 using the nlnotes.exe.
HTH
Thomas
What I did before was set the "Shortcut Links" to use the specific .exe path and specific .ini path. (ie C:\Lotus\Notes5\notes.exe "=C:\Lotus\Notes5\notes.ini") This worked until the current 8.5.2 release (maybe 8.5.1, but I skipped that one).
Thanks again - The Fonz