IBM Support

Steps for installing Lotus Notes 8.0.x and 8.5 (only) on a Citrix Presentation Server (XenApp)

Technote (troubleshooting)


This technote describes the general steps for installing a Notes 8.0.x and 8.5 (only) clients on Citrix XenApp (formerly Presentation Server) version 4.5.

Resolving the problem

NOTE: The Notes 8.0 (Basic Configuration) client is the supported configuration for use with Citrix XenApp 4.5, on Windows 2003 and Windows 2003 64bit Edition servers, using ICA clients. For additional information, refer to the "Citrix support statement" in the Notes 8.0 Release Notes. Support for the Notes 8 client (Standard Configuration) is introduced as of Notes 8.0.1. For additional details about the Notes client configurations, refer to "What's new in Lotus Notes 8 client?" (# 1264877) and "What's new in Notes and Domino 8.0.1?" (1292420) .

This technique should NOT be used for 8.5.1 or later builds. If the single user install is used for 8.5.1 or later builds, then ALL users will share the SAME \workspace directory, which will be in the C:\r8clienttemplate\workspace folder.

The single user install is NOT supported in 8.5.1 or later builds.

Step #1 : Installation of the Notes client

a. Log on to the Citrix server (directly, not remotely) as Administrator.

b. From the Microsoft Windows Control Panel, select "Add/Remove Programs." Click Add New Programs, and select the Notes client CD-ROM.

c. During the installation, select the Single User Install. Set the Notes Directory to C:\Program Files\IBM\Lotus\Notes and the data directory to c:\r8clienttemplate, where "c:" represents a directory on the local Citrix machine.

d. If you are prompted to set Notes as your default Mail Program, select Yes.

NOTE: To store templates in only one location, and not in each user's data directory, refer to the "Additional steps to configure a Shared template directory" section at the end of this technote.

Step #2 : Move and modify the notes.ini file

a. The notes.ini file is placed in the default Windows directory (for example, c:\WINDOWS). Manually move this file from the Windows directory to the c:\r8clienttemplate directory.

Once you complete the initial installation process, each user that logs on to the Citrix server receives a copy of this notes.ini file.

b. After moving the file, modify it with Notepad to include the following lines: where "w:\" represents the standard user's home drive assignment. ("Additional steps to configure a Shared template directory" will require a different Directory= path)







NOTE: DEBUG_GLOBAL_NAMESPACE_DISABLE=1 will resolve the issue reported in SPR# TMDS7B5SCY where two administrators cannot launch the Notes client. This issue is fixed, without the need for the notes.ini parameter, in the 8.5 code stream.

Add any additional notes.ini parameters that you would like to distribute to all users to this file as well.

Step #3 : Set security permissions

Set security permissions on the c:\r8clienttemplate directory to allow all users Read access to this directory. This permission allows users to copy the files and folders from this directory to their individual home directory.

a. To do so, right-click the folder and select Security.

b. Add or Change the "Everyone" group to have reader access.

Step #4 : Configure Logon Scripts for the users

NOTE: The changes made in this step will apply to all users because these logon scripts are run for each user that logs on to the Citrix server. The virtual drive letter that maps to the user's home profile directory (C:\Documents and Settings\<username>) can be any letter you choose (W is used below), but the home profile directory has to be local to the Citrix Terminal Server. Any Lotus Notes client issues that arise from mapping the virtual drive letter to a directory on a remote file server, instead of to a directory on the local Citrix server, are not supported by IBM Lotus Support. Refer to technote 1086958 for more information on use of remote data directories.

Script A

a. Using Notepad, edit or create the file %systemroot%\Application Compatibility Scripts\RootDrv2.cmd

b. Add the following line, where W is the standard user's home drive assignment:

    Set RootDrive=W:

c. Save and close the file.

Script B

a. Using Notepad, edit or create the file %systemroot%\system32\usrlogn2.cmd

b. Add the following lines, where w is the standard user's home drive assignment:

    if not exist w:\notes md w:\notes

    if not exist w:\notes\data md w:\notes\data

    if not exist w:\notes\data\notes.ini xcopy /s c:\r8clienttemplate\*.* w:\notes\data

Step #5 : Modify Notes Desktop icon

Next, you modify the Notes Desktop icon to point to user's Home Directory.

a. Right-click the icon, and select Properties.

b. Edit the target field to include the following line, where w is the user's home drive assignment:

If using Lotus Notes 8.0.x (Standard Configuration)....

"C:\Program Files\IBM\Lotus\notes\notes.exe" =w:\notes\data\notes.ini

If using Basic Client Configuration....

"C:\Program Files\IBM\Lotus\notes\notes.exe" -sa =w:\notes\data\notes.ini

Note: The -sa switch launches the Notes 8 (Basic Configuration) client.

Final Step:

At this point, you should log off as the Administrator, and log on to the Citrix server with a user account. Then launch the Lotus Notes client using the Desktop icon.

Additional steps to configure a Shared template directory:

Create a directory called "sharedNotesData" where you would like the common shared data to reside.

1. In addition to adding the Directory line to the notes.ini as described in Step 2(b), add the following entry below:


The above path is given as an example; however, you may choose to locate the sharedNotesData directory in another location. If you choose to do so, you will need adjust the path accordingly.

2. From the Data directory that was created in the \r8clienttemplate  directory, cut and paste the following directories and files to the new " sharedNotesData" directory:
    Help Directory
    Modems Directory
    W32 Directory

Continue with the remaining steps of the technote starting with Step 2.

Additional information for setting up the shared data directory for languages other than English:
In the notes.ini use the ini parameter:

For the language version, the actual directory that has the templates etc in it should be:
"English shared data directory" + "MUI" + "lang"
e.g., for German Notes the files should be in:

Related information

Steps for Installing Notes 6 or 7 on Citrix
Knowledge Collection: Troubleshooting Lotus Notes on Ci
Steps for installing and configuring Notes 8.5.1 on Cit
A simplified Chinese translation is available

Document information

More support for: IBM Notes

Software version: 8.0, 8.0.1, 8.0.2

Operating system(s): Windows

Reference #: 1265898

Modified date: 2011-03-08