Aufnahme: https://pan.news/20191105de Abstract: Notes auf Citrix. Sie wollten es haben um Ihr Leben und das Ihrer Endbenutzer einfacher zu machen. Aber wie so oft stellt sich heraus, dass alles seine Nachteile hat. Es gibt eine ganze Reihe von Fallstricken und Problemen beim Installieren und Konfigurieren des Clients. Im Betrieb zeigen sich dann lange Startzeiten und ein langsames UI als echte Produktivitätskiller - dank Datenverzeichnissen auf Netzlaufwerken scheint dies unvermeidbar. Kein Grund zur Verzweiflung! Sie können all diese Themen in den Griff bekommen! In diesem Webinar zeigen wir Ihnen Schritt für Schritt wie sie den perfekten Notesclient auf Citrix installieren und konfigurieren. Befehlszeileneinstellungen für die Installation, NotesShareClasses, jvm.properties/rcp-install.properties, stub-notes.ini, config-file und mehr - alles wird detailliert erklärt. Sie werden auch sehen, wie sie MarvelClient Roaming einsetzen können, um Startzeiten und UI-Performance drastisch verbessern. Es ist möglich: Zentrale Installation mit Datenverzeichnis auf Netzlaufwerken, aber so schnell wie ein lokal installierter Client! Wenn Sie fertig sind, haben Sie das ultimative Rezept für Notes auf Citrix in Ihren Händen. Worauf warten Sie noch?

1. From A to Z-itrix
Setting up the most stable and fastest HCL Notes client on Citrix (feat. MarvelClient)

2. Speakers
Daniel Klas
@panagenda
Inbound Marketing Coordinator
panagenda
Marc Thomas
@IAM_Mthomas
Senior Consultant
panagenda
Join the conversation using #MarvelClient & @panagenda

3. Stay on Top of Notes
Selected by IBM and HCL as the Standard in Notes Client Management
Webinar recordings (incl. MarvelClient introduction):
https://pan.news/2lzLeEv

4. Config
DB
Analyze
DB
Avg.
20-70 KB
Upload
Avg.
1-4 KB
Download
Two Server-side Databases
• MarvelClient Config
• MarvelClient Analyze
Single binary on the Notes Client
• Deployed to the Notes data directory
• Activated via EXTMGR_ADDINS in notes.ini
MarvelClient Architecture
Please don’t forget

5. Only Citrix or virtual infrastructure in general?
• VDI – Virtual Desktop Infrastructure
− VMWare Horizon View OR Citrix XenDesktop
• TS – Terminal Services/Server
− Citrix XenApp

6. What we typically see at customers
• Aged IBM Notes installations in virtual environments that are working “somehow”
− mostly Notes data directories on network drives which cause
o long startup times of IBM/HCL Notes (up to 60 sec)
o hangs and wait times due to interruptions and poor network latency
o high network traffic as IBM/HCL Notes is constantly reading / writing data
o frequently corrupted local applications
o permanently occupied disk space on file servers / SAN / NAS
▪ at least 120MB per user
▪ often because of old and outdated files, even templates

7. Roaming

8. HCL Notes + MarvelClient Roaming
Log on to
virtual session
Start
HCL Notes
Log on to
HCL Notes
Roam
data
(MarvelClient Roaming)
Roaming Rollback
Work with
HCL Notes
Shutdown
HCL Notes
Log off from
virtual session
Backup
data
(MarvelClient Roaming)
Roaming Backup
Clear data
Fileserver
Roaming
Set

9. Some Basic stuff
• Use HCL’s default paths
− Program directory
C:Program Files(x86)HCLNotes
− Shared data directory
C:ProgramDataHCLNotesDatashared
− Data directory
C:Users<USERNAME>AppDataLocalHCLNotesData
• MultiUser install only → please!
• Use Install parameter “CITRIX=1” (if TS involved)
• No need to make changes to MSI package (scripts can help here)

10. Command lines
• Uninstall & cleanup first
− IBM NICE (Notes Install Cleanup Executable):
https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0040768
"C:InstallNotesV11nice.exe" -rp –wipe –qn
− rd /S /Q "C:Program Files (x86)IBMNotes"
− rd /S /Q "C:Program Files (x86)IBMLotus"
− rd /S /Q "C:ProgramDataLotus"
− rd /S /Q "C:ProgramDataIBMNotes“
− rd /S /Q "C:ProgramDataIBMJVMPatcher“

11. Command lines (cont.)
• Install
− “C:InstallHCL_Notes_V11_Beta2_Win_Eng.exe" -s -a /s /v"SETMULTIUSER=1 CITRIX=1 /qn
/lime "c:Install msiinst_HCL_Notes_V11_Beta2_Win_Eng.log"

12. ODS53
• The difference between ODS 43 and 53 = up to 80% LESS FILE I/O
• Better performance
• More stability
• To upgrade the ODS of all shared templates in a virtual HCL Notes Multi-User installation you can
follow these steps (includes ODS 53 for new databases created by the user)
− Add the following line to the shared notes.ini in %ProgramData%HCLNotesData
o CREATE_R10_DATABASES=1

13. ODS53 (cont.)
• Make sure that the Administrator account used to log on to the virtual server does not have a
personal HCL Notes Data directory yet (in %LocalAppData%)
• From a command prompt type the following commands
− cd “%ProgramData%HCLNotesDataShared”
− “%ProgramFiles(x86)%HCLNotesncompact.exe” -C -ODS -*

14. Notes.ini
• A properly configured shared notes.ini can be essential for smooth running virtual HCL Notes
environments
• The shared notes.ini is used by every HCL Notes client session for which there’s no personal HCL
Notes data folder yet
• It is located in %ProgramData%HCLNotesData

15. Notes.ini (cont.)
• It is used as a template notes.ini out of which all parameters are transferred into a users personal
notes.ini upon the very first HCL Notes start
• Find some useful shared notes.ini parameters on the next slide
− additionally to the standard entries!

16. Notes.ini (cont.)
• Ports=TCPIP
• TCPIP=TCP,0,15,0,,12288,
− Note that this sets port compression to OFF, which is appropriate in virtual environments; Port compression
adds 5% CPU overhead and with 60 concurrent sessions this would result in needing 3 dedicated CPUs for
just port compression
• DISABLE_CLIENTRECORD=1
− This disables logging of client information back into the public address book as all virtual environment users
share the same servers in the farm anyway

17. Notes.ini (cont.)
• CREATE_R10_DATABASES=1
• Enables HCL Notes V11 Beta-2 to use the latest ODS version for newly created local applications. Make sure
to not use CREATE_R85_DATABASES (IBM Lotus Notes 8.5) or CREATE_R9_DATABASES (IBM Notes 9.0.1)
to avoid the use of an older ODS in HCL Notes V11 Beta-1
• Log=,1,0,7,40000
− This disables logging, which is optional but gains a slight performance improvement
− This could cause issues when applications needs an existing log.nsf (please check before) or in
Troubleshooting situations
• ConfigFile=C:ProgramDataHCLNotesDataconfig.txt
− For ConfigFile details see next topic

18. Notes.ini (cont.)
• All parameters for copy & paste
Ports=TCPIP
TCPIP=TCP,0,15,0
DISABLE_CLIENTRECORD=1
CREATE_R10_DATABASES=1
Log=,1,0,7,40000
ConfigFile=C:ProgramDataHCLNotesDataconfig.txt
[always keep a blank line at the bottom!]

19. Config File
• HCL Notes can be set up unattended by using a so called ConfigFile – often referred to as config.txt
or setup.txt
• The ConfigFile needs to be referenced in the shared notes.ini using the parameter ConfigFile=Drive: or
UNCfolderfilename.txt (see previous topic)
• For more details, the following HCL KnowledgeBase entry provides some very good examples on how
to create a ConfigFile as generic as possible
− https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0036482

20. Config File (cont.)
• Example ConfigFile for copy & paste
Username=%USERNAME%
Domino.Name=Hubserver/Acme
Domino.Address=servername.acme.com
Domino.Port=TCPIP
Domino.Server=1
AdditionalServices=-1

21. ShareClasses Improvement
• In HCL Notes the jvm.shareclasses file (*xpdplat_.jvm_G35) is stored in each users
Dataworkspace.configorg.eclipse.osgi folder and has a fixed size of 64MB
• To optimize file I/O, speed up the HCL Notes Client start and save storage (960MB per server ==
15users), this file can be shared across all users of the virtual environment server
1. Create the following folder “%ProgramData%HCLNotesDataShareClasses“
and set folder rights for “everyone” to read / write access
2. Change the value of this parameter “jvm.shareclasses.loc=“ in
%ProgramFiles(x86)%HCLNotesframeworkrcpdeployjvm.properties
− from “${rcp.data}/.config/org.eclipse.osgi“
− to “C:/ProgramData/HCL/Notes/Data/ShareClasses“→ it’s important to use “/” instead of “”

22. JVM memory allocation
To speed up the HCL Notes JVM it’s useful to optimize memory settings
• Open %ProgramFiles(x86)%HCLNotesframeworkrcpdeployjvm.properties
• Modify vmarg.Xmx from “-Xmx256m” to “-Xmx1024m”
• Modify vmarg.Xms from “-Xms64m” to “-Xms256m”
• Change vmarg.Xmca=-Xmca512k
• Remove from “SingleJVM” in vmarg.Dshare
• The implicit rules
• Do not change vmarg.Xmx to more than -Xmx1024m regardless of how much memory you have
• vmarg.Xms should always be ¼ of what you changed Xmx to

23. Workspace Improvement
• Every HCL Notes Client start in a virtual environment is a first (setup) start and takes at least 23 sec
on average
• ~65% - 70% of time during first starts is used to build the workspace folder (at least 15 sec)
• A typical new workspace folder (HCL Notes 11 Beta-2)
consists of
>400 files
>180 folders
>85 MB (including 64MB *xpdplat_.jvm_G35 file)
Building the workspace folder causes lots of file I/O

24. Workspace Improvement (cont.)
Accelerate the HCL Notes Client start to be >50% faster (with less file I/O)
1. With a non-admin user (Windows + HCL Notes) run an initial setup of HCL Notes
2. Start HCL Notes and wait for 1,5 minutes
3. Exit HCL Notes
4. Start HCL Notes again and wait for another 1,5 minutes
5. Exit HCL Notes
6. Create the following folder → %ProgramData%HCLNotesDataCommon
7. Copy the workspace folder from %LocalAppData%HCLNotesData to
%ProgramData%HCLNotesDataCommon

25. Workspace Improvement (cont.)
8. Delete the following files / folders in %ProgramData%HCLNotesDataCommonworkspace
a) UDM
b) Logs → all but .prov2install
c) .metadata.pluginscom.ibm.collaboration.*
d) .metadata.pluginscom.ibm.rcp.personality.framework
e) .metadata.pluginscom.ibm.rcp.security.auth
f) .metadata.pluginscom.ibm.rcp.managedsettings

26. Workspace Improvement (cont.)
Important:
• You must recreate the workspace folder when your Installation changes (another Notes version, Fix
Pack, Addons, etc.)
• If you want to include the workspace folder to your installation package, you also must include the
following file:
− C:Program Files (x86)HCLNotesframeworkrcprcplauncher.properties

27. Windows Registry
• If you change the Data Directory –
let’s say from “H:NotesData” to “%LocalAppData%HCLNotesData”
− Please ensure that the following Registry-Entry will be deleted during Windows-Logon (always)
HKEY_CURRENT_USERSoftwareLotus

28. DEP – Data Execution Prevention
• Default == enabled
• Exclude
− C:Program Files (x86)HCLNotesnotes.exe
− C:Program Files (x86)HCLNotesnlnotes.exe
− C:Program Files (x86)HCLNotesnsd.exe
− C:Program Files (x86)HCLNotesframeworkrcpeclipseplugins...win32x86notes2.exe

29. LIVE DEMO

30. Q & A
Daniel Klas
@panagenda
Inbound Marketing Coordinator
panagenda
Marc Thomas
@IAM_Mthomas
Senior Consultant
panagenda
Join the conversation using #MarvelClient & @panagenda

31. Thank you!
Daniel Klas
@panagenda
Inbound Marketing Coordinator
panagenda
Christoph Adler
@cadler80
Senior Consultant
panagenda
Join the conversation using #MarvelClient & @panagenda