Webinar Recording: https://www.panagenda.com/webinars/hcl-notes-and-nomad-troubleshooting-for-dummies/ The number of systems IT and support have to handle is growing faster and faster, while headcounts in those departments struggle to keep pace. This means less and less time to deal with any single system (like Notes), which leads to reduced operational efficiency. On top of that, newer personnel is often also unfamiliar with the HCL stack. Come and join Christoph Adler on April 18 who will condense their whopping 20+ years of field experience with HCL Notes and Nomad troubleshooting into a single webinar. Get an eye-opening boost in knowledge and skills – whether you are an inquiring beginner or a seasoned admin. Benefit from real uses cases we encountered in the wild to learn how you can quickly and easily deal with many common situations and find out what to do if you can’t solve it on your own. What you will learn - Learn how to react fast and what to do when things go wrong with Notes or Nomad, and how to isolate and/or reproduce the issue. - Understand where to look for information (logs, NSDs, etc.), how to easily collect it, and how to interpret what you find. - Accelerate time to resolution when escalating to HCL support by having all the right things in hand from the start.

1. Upgrade Your Time
HCL Notes and Nomad
Troubleshooting for Dummies
April 18th, 2023

2. Christoph Adler
Senior Solution Architect
christoph.adler@panagenda.com
Host & Speaker
Xaver Benz
Head of Marketing and Training
xaver.benz@panagenda.com

3. Before We Start
All attendee lines are muted
This is to prevent interruptions during the
presentation.
X
The webinar is being recorded
After the webinar, we will send you a mail to give
access to the recording and presentation slides.
Please submit questions via
the Chat or Q&A panel
Your questions will be addressed directly during
the webinar or in the Q&A section after the
presentation.
Share your feedback with us
Use the link provided at the end to let us know
what we can do better.

4. Agenda
 Overview of available Clients
 Where to find the troubleshooting/log files
 Analysis
 Bonus: FREE MarvelClient Support Helper

5. Upgrade Your Time
Overview of available clients

6. Overview of available Clients
Product Windows macOS Browsers
(Chrome,
Edge, Firefox)
iOS Android
Notes Basic
Notes Standard
Notes Admin / Designer
Nomad (mobile)
Nomad Web
MarvelClient
Current version
.
.
12.0.2 FP1
12.0.2 FP1
12.0.2 FP1
1.0.29 (iOS) , 1.0.40 (Android)
1.0.7
12.0.62 (Windows, iOS, Android,
Browsers), 12.0.63 (macOS)

7. ➢ Available on
https://hclsoftware.flexnetoperations.com/
➢ HCL Support Article
https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0104362
➢ HCL FixList
https://ds_infolib.hcltechsw.com/ldd/fixlist.nsf
➢ System Requirements
https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0101491
HCL Notes 12.0.2 FP1 is available since April 17th, 2023

8. 1. Windows
Notes Basic + Notes Standard + Notes Admin/Designer (+MarvelClient)
2. macOS
Notes Standard (+MarvelClient)
3. iOS/Android
Nomad (mobile) (+MarvelClient)
4. Browsers (Chrome, Edge & Firefox)
HCL Nomad Web (+MarvelClient)
Virtual packages

9. Upgrade Your Time
Where to find the troubleshooting/log files

10. ➢ Notes Basic (MultiUser default)
%localAppData%HCLNotesDataIBM_TECHNICAL_SUPPORT
%localAppData%HCLNotesDatanotes.ini
➢ Notes Standard (MultiUser default)
%localAppData%HCLNotesDataIBM_TECHNICAL_SUPPORT
%localAppData%HCLNotesDataworkspacelogs
%localAppData%HCLNotesDatanotes.ini
➢ Notes Admin/Designer (SingleUser default → 64-Bit)
C:Program FilesHCLNotesDataIBM_TECHNICAL_SUPPORT
C:Program FilesHCLNotesDataworkspacelogs
C:Program FilesHCLNotesnotes.ini
➢ MarvelClient (Essentials OR Licensed)
%LocalAppData%panagendapmc OR marvel
Troubleshooting/log files – 1. Windows

11. ➢ Notes Standard
~/Library/Application Support/HCL Notes Data/IBM_TECHNICAL_SUPPORT
~/Library/Application Support/HCL Notes Data/Expeditor/Applications/logs
~/Library/Preferences/Notes Preferences → notes.ini file
➢ MarvelClient (Essentials OR Licensed)
~/Library/Application Support/panagenda/pmc OR /marvel
Troubleshooting/log files – 2. macOS

12. ➢ Nomad (mobile)
Troubleshooting/log files – 3. iOS/Android

13. ➢ Chrome, Edge & Firefox (non-mobile)
Troubleshooting/log files – 4. Browsers

14. ➢ What if you can’t use “Generate Problem Report” (issue during start-up) ?
Troubleshooting/log files – 4. Browsers (cont.)

15. ➢ What if you can’t use “Generate Problem Report” (issue during start-up) ?
Troubleshooting/log files – 4. Browsers (cont.)

16. ➢ What if you can’t use “Generate Problem Report” (issue during start-up) ?
Troubleshooting/log files – 4. Browsers (cont.)

17. ➢ By the way: This issue is already fixed with Nomad Web 1.0.7
Troubleshooting/log files – 4. Browsers (cont.)

18. OPFS Explorer is a Chrome DevTools extension that allows you to explore the Origin
Private File System (OPFS) of a web application.
https://tinyurl.com/OPFSExplorer
OPFS Explorer – Browser plugin

19. Upgrade Your Time
Analysis

20. What‘s inside the Troubleshooting/log files?
➢ Notes.ini

21. What‘s inside the Troubleshooting/log files?
➢ Have you ever heard about the “Notes.ini Playbook”?
SCAN ME

22. What‘s inside the Troubleshooting/log files?
➢ IBM_TECHNICAL_SUPPORT → healthy

23. What‘s inside the Troubleshooting/log files?
➢ IBM_TECHNICAL_SUPPORT
− Before you run an NSD, check the available options in “DataHelpnsddoc.html” on
your Notes Admin/Designer client
− To get a better understanding, the C-API Documentation is important to be able to
read and understand NSD’s better – see here:
https://github.com/HCL-TECH-SOFTWARE/domino-c-api-docs

24. What‘s inside the Troubleshooting/log files?
➢ IBM_TECHNICAL_SUPPORT

25. What‘s inside the Troubleshooting/log files?
➢ IBM_TECHNICAL_SUPPORT
− If you ever have the need to manually run an NSD on macOS – follow the steps below:
For Notes 12.0.x
1. Command → /bin/bash "/Applications/HCL Notes.app/Contents/Resources/Support/nsd.sh“
2. Finder → ~/Library/Application Support/HCL Notes Data/IBM Technical Support
Hint:
If you need to force a shutdown of the Notes processes with the NSD command, add <space> -kill after
nsd.sh in the command line. Do this after running the full NSD (without -kill).
Source:
https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0080556

26. What‘s inside the Troubleshooting/log files?
➢ Workspacelogs → healthy

27. What‘s inside the Troubleshooting/log files?
➢ Workspacelogs

28. What‘s inside the Troubleshooting/log files?
➢ panagendapmc OR marvel

29. What‘s inside the Troubleshooting/log files?
➢ panagendapmc OR marvel

30. What‘s inside the Troubleshooting/log files?
➢ panagendapmc OR marvel → log.xml

31. What‘s inside the Troubleshooting/log files?
➢ panagendapmc OR marvel

32. Upgrade Your Time
Bonus:
FREE MarvelClient Support Helper

33. MarvelClient Support Helper for Windows - FREE

34. SupportHelper
FREE
SCAN ME

35. Your Feedback Matters to Us
THANK YOU!
THANK YOU!
Q & A

36. NEXT WEBINAR