Technote (troubleshooting)
Problem
This technote describes how to get better memory usage from Notes Standard clients on Citrix.
Resolving the problem
Enabling Notes Sharedclass cache for Citrix will allow multiple Notes users on a Citrix server to share some Java classes ensuring that each Notes instance does not load its own copy of the class files. This will in turn allow you to reduce memory usage for each Notes user.
To enable Notes Sharedclass cache:
1. Open the jvm.properties file
-
In Windows:
<install_dir>\framework\rcp\eclipse\plugins\com.ibm.rcp.j2se.win32.x86_1.6.0.20080416-200806200100
2. Find the following string and remove the singleJVM item
-
vmarg.Dshare=
-Xshareclasses:name=xpdplat,controlDir=${prop.jvm.shareclasses.loc},groupAccess,keep, <singleJVM> ,nonfatal
3. Find and change the following line:
From...
-
jvm.shareclasses.loc=${env.TEMP}/xpdplat (8.0.2)
jvm.shareclasses.loc=${rcp.data}/.config/org.eclipse.osgi (8.5)
To...
-
jvm.shareclasses.loc=c:/temp/xpdplat
4. Add the following line:
-
vmarg.Xnolinenumbers=-Xnolinenumbers
5. Close and save the file.
To verify Notes Sharedclass cache is being used:
1. Open a Command Prompt
2. Change (cd) to the NOTES_INSTALL\framework\rcp directory
3. Enter the following command:
rcplauncher -config notes -com.ibm.rcp.core.logger#dump java
4. In the NOTES_DATA\workspace\logs directory, you will find a javacore*.txt file (i.e. javacore.20090127.124445.1560.0001.txt)
5. Open this file in a text editor and search for 1SCLTEXTCSUM . This will show you the "Cache Summary", in particular the size, location, and percent used.
For additional Citrix tuning tips, refer to the following developerWorks article:
IBM Lotus Notes and Lotus iNotes 8.5.2 on Citrix XenApp 4.5/5.0: A scalability analysis
Related information
Knowledge Collection: Troubleshooting Lotus Notes on Ci
How to collect a Javadump or heap dump for Lotus Expedi
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.