IBM NOTES ON MAC
Tips, FAQ and Q&A about Notes and Mac
By Yasmin BarrientosMarch 28, 2017
Introduction to IBM Notes on MAC
Notes on MAC vs Notes on WINDOWS
Install/Uninstall of IBM Notes on MAC
Notes Supportability Limitation on MAC
Crash, Hang & Delay Performance Issues on MAC
Known Issues on MAC
Questions
© 2017 IBM Corporation 2
Agenda
© 2017 IBM Corporation 3
Facts about IBM Notes on MAC
Mac has a 32-bit and a 64-bit installer
Notes on MAC is always installed as a Multi-user.
The Data directory for Notes is called differently depending on the version of
Notes.
* Lotus Notes Data for Notes 8.5.3 (and below)
* IBM Notes Data for Notes 9 (and above).
There is no Domino Administrator and Domino Designer for Mac.
Introduction to IBM Notes on MAC
© 2017 IBM Corporation 4
Facts about IBM Notes on MAC
There is no Basic-only installer for Mac.
There is no Notes JVM for Notes on Mac.
* For Windows, Notes is shipped with its own JVM.
* For Mac, Notes depends on the system JVM installed on the
machine.
There is no Program Files folder in Mac and its applications can be found in
Applications folder (e.g. IBM Notes.app)
Introduction to IBM Notes on MAC (cont’d)
Comparing Notes on MAC OS and WINDOWS
WINDOWS MAC OS
Notes.ini Notes Preferences
Workspace Expeditor
Control Panel System Preferences
Windows Explorer Finder
Command Prompt Terminal
Ctrl + Break Command + [ . ]
C:\Users\Username \Users\Username
© 2017 IBM Corporation 5
IBM Notes on Windows counterparts in Mac OS.
Notes on MAC OS vs Windows
Install/UninstallIBM Notes on MAC
© 2017 IBM Corporation 6
Directory Description
/Applications/IBM Notes.app Notes product and binary files installation directory,
/Applications/IBM Notes.app/Contents/MacOS/ Notes Java code installation directory
~/Library/Application Support/IBM Notes
Data/ExpeditorNotes workspace directory
/Applications/IBM
Notes.app/Contents/Resources/English.lproj/DataShared data directory
~/Library/Application Support/IBM Notes Data Data files directory for each user
~/Library > Preferences Notes Preferences directory
© 2017 IBM Corporation 7
DEFAULT IBM Notes Installation & Upgrade Directories
Criteria for Notes on Mac OS X Installation & Upgrade
The install kit for Notes on Apple Mac OS X consists of the following:
Notes installation Meta-package (.mpkg)
Uninstaller application
The installation program will detect and upgrade an existing Notes
installation to the current Notes installation.
© 2017 IBM Corporation 8
CRITERIA for Mac OS X Installation & Upgrade on Notes
If you are upgrading Notes, turn off all options in the Application Sharing
tab of the Shared System Preferences page.
You can install Notes in a multi-user environment. Single user install is not supported.
*Technote: http://www-01.ibm.com/support/docview.wss?uid=swg21420461
Shut down all applications before installing or upgrading to this release of
Notes, including anti-virus software
© 2017 IBM Corporation 9
CRITERIA for Mac OS X Installation & Upgrade on Notes (cont’d)
Installation and use of Notes on a USB drive is not supported for Notes standard configuration.
Notes roaming user does not support switching a user ID, as noted in the user interface response.
The destination path is fixed as /Applications/IBM Notes.app, user can not change it
Users must have administrator-level privileges to install. For cases in which administrative rights are not available, grant a user administrator privileges.
© 2017 IBM Corporation 10
CRITERIA for Mac OS X Installation & Upgrade on Notes(cont’d)
CRITERIA for Mac OS X Installation & Upgrade on Notes (cont’d)CRITERIA for Mac OS X Installation & Upgrade on Notes (cont’d)
© 2017 IBM Corporation 11
How To Install & Upgrade Notes on Mac OS X
1. Obtain the Notes installation kit.
2. Locate and run the installation executable.
3. Read the Welcome screen and
click Continue.
4. Read the install information
and click Continue.
© 2017 IBM Corporation 12
How To Install & Upgrade Notes on Mac OS X (cont’d)
5. Process the license agreement terms and click Continue.
© 2017 IBM Corporation 13
How To Install & Upgrade Notes on Mac OS X (cont’d)
6. Accept the default install directory and
click Continue.
7. Select the features to install and click
Continue.
© 2017 IBM Corporation 14
Steps to Install & Upgrade Mac OS X on Notes (cont’d)How To Install & Upgrade Notes on Mac OS X (cont’d)
8. Accept Notes as the default mail, calendar, and contacts programs.
© 2017 IBM Corporation 15
Steps to Install & Upgrade Mac OS X on Notes (cont’d)How To Install & Upgrade Notes on Mac OS X (cont’d)
9. Read the installation screen and click
Install.
10. If prompted, enter your administrative
username and password and click OK.
Note: The installation process may take
several minutes.
© 2017 IBM Corporation 16
Steps to Install & Upgrade Mac OS X on Notes (cont’d)How To Install & Upgrade Notes on Mac OS X (cont’d)
11. Read the Provisioning Result screen and click Continue.
© 2017 IBM Corporation 17
Steps to Install & Upgrade Mac OS X on Notes (cont’d)How To Install & Upgrade Notes on Mac OS X (cont’d)
12. Read the installation summary screen and click Close to exit the installation
wizard.
© 2017 IBM Corporation 18
Steps to Install & Upgrade Mac OS X on Notes (cont’d)How To Install & Upgrade Notes on Mac OS X (cont’d)
13. Start Notes by double clicking the new IBM Notes.app icon in the /Applications
directory.
© 2017 IBM Corporation 19
Steps to Install & Upgrade Mac OS X on Notes (cont’d)How To Install & Upgrade Notes on Mac OS X (cont’d)
Step-by-step instructions for installing Notes 8.5.x for Mac
http://www-01.ibm.com/support/docview.wss?uid=swg21420461
Installing IBM Notes 9.0.1 on MAC
https://www-10.lotus.com/ldd/dominowiki.nsf/dx/Installing_IBM_Notes_9.0.1_on_MAC
© 2017 IBM Corporation 20
Technotes for Mac OS X Installation & Upgrade on Notes
1. Open the Terminal Application and Navigate to the Notes Install Kit directory.
2. Type the following command:
sudo Installer –pkg <package name> -target <destination volume>
<destination volume> is the root path of logic/physical volume name wherein the typical value is "/" which means current volume
If the value is set to "-target /", Notes will be installed as "/Applications/IBM Notes.app"
© 2017 IBM Corporation 21
How To SILENT Install Notes on Mac OS X
IBM highly recommends to uninstall Notes using the uninstaller application supplied with the Notes install media. Both methods preserve user data.
1. Using the out of the box uninstaller provided by IBM
2. Drag IBM Notes.app from /Applications to the trash.
© 2017 IBM Corporation 22
How To Uninstall Notes from Mac OS X
3. Drag the following items to the Apple Mac OS X trash bin:
• IBM Notes.app
• ~/Library/Application Support/IBM Notes Data folder
**(where ~ is the user's home directory)
• ~/Library/Preferences/Notes Preferences
© 2017 IBM Corporation 23
How To Uninstall Notes from Mac OS X (cont’d)
Note: To reinstall after uninstalling, you may also need to delete the following
items prior to reinstalling Notes:
/Library/Receipts/IBM Notes Installer.pkg
/Library/Receipts/IBM Notes Installer_English.pkg
/Library/Receipts/xpdcoreinstaller.pkg
© 2017 IBM Corporation 24
IBM Notes MAC OS
Notes 8.5.0 and 8.5.1 MAC OS 10.5 (Leopard)
Notes 8.5.1 FP1 and Notes 8.5.2 MAC OS 10.5 and 10.6 (Snow Leopard)
Notes 8.5.3 MAC OS 10.5 to 10.7 (Lion)
Notes 8.5.3 FP3 and 9.0.0 MAC OS 10.8 (Mountain Lion)
Notes 8.5.3 FP6 and 9.0.1 MAC OS 10.9 (Mavericks)
Notes 9.0.1 slipstream with 9.0.1 Fix
Pack 2 or above
MAC OS 10.10 (Yosemite)
Notes 9.0.1 64-bit Mac OS 10.10, 10.11 (El Capitan)
Notes 9.0.1 64-bit IF5 Mac OS 10.12 (Sierra)
Notes Supportability Limitations on Mac
Index of Supportability Q&A technotes for Notes and OS X and Windows
http://www.ibm.com/support/docview.wss?uid=swg21998488
© 2017 IBM Corporation 25
Technotes for Notes Supportability Limitations on Mac
A slipstream is a re-release of an existing package. In this instance, the 9.0.1
IBM Notes Mac installer was modified to function on Yosemite and the 9.0.1.
Technote: http://www-01.ibm.com/support/docview.wss?uid=swg21682510
Apply Notes 8.5.3 slipstream to avoid conflict with Apple's new app which is also
called “Notes”. The 8.5.3 slipstream will reinstall Notes as Applications/Lotus
Notes.
Technote: http://www-01.ibm.com/support/docview.wss?uid=swg21599884
© 2017 IBM Corporation 26
Notes Supportability Limitations on Mac (cont’d)
Notes 9.0.1 64-bit is supported on Mac OS 10.10, 10.11 (El Capitan) and 10.12 (Sierra) and Oracle JRE 1.8 or higher. Prior releases, including IBM Notes 9.0.1.x 32-bit and Notes 8.5.x, are not supported.
Technotes:
http://www-01.ibm.com/support/docview.wss?uid=swg21962311
http://www-01.ibm.com/support/docview.wss?uid=swg21971524
© 2017 IBM Corporation 27
Notes Supportability Limitations on Mac (cont’d)
Known issues with Notes and ICAA on MacBook Pro with Touch Bar and Touch ID:
• Intermittent failures when browsing for Notes ID
• Unable to close Notes or ICAA other than by issuing a Force Quit
• Notes or ICAA crashes when a server is selected in the File > Open Application dialog
• Setup/configuration of a fresh Notes installation fails
• Notes password prompt dialog disappears, resulting in the error message "Wrong Password (Passwords are case sensitive - be sure to use correct upper and lower case).“
Interim Fix 8 for Notes 901 64bitTechnote: http://www-01.ibm.com/support/docview.wss?uid=swg21995145
© 2017 IBM Corporation 28
Errors o Notes Supportability Limitations on MacNotes Supportability Limitations on Mac (cont’d)
Troubleshoot Crash, Hang &
Delay
© 2017 IBM Corporation 29
1. Identify if it’s a crash, hang or delay.
Crash – A legit crash has a pop up window and it generates an NSD automatically.
Hang – Screen is unresponsive.
Delay – A performance issue when an action is taking longer than it should to
respond.
2. Reproduce the issue in Basic mode by adding UseBasicNotes=1 in the Notes
preferences.
© 2017 IBM Corporation 30
How to Troubleshoot Performance Crash, Hang & Delay
3. If the issue is NOT reproducible in basic mode:
> cd /Applications/"IBM Notes.app"/Contents/MacOS/
> ./Notes -RPARAMS -RESETCONFIG -CLEAN
4. If the issue persists, you can try recreating the entire Expeditor folder.
© 2017 IBM Corporation 31
How to Troubleshoot Performance Crash, Hang & Delay (cont’d)
5. If the owner of the "Lotus Notes Data" or "IBM Notes Data" folder is not the user that is launching the client, the client will fail to launch.
To change the owner of this folder, use these commands:
>sudo chown -R USERNAME ~/Library/”Application Support”/Lotus\ Notes\ Dataor for Notes 9.0:
>sudo chown -R USERNAME ~/Library/”Application Support”/IBM\ Notes\ Data
6.If the user's name has a space in it, you can use the format First- Initial- Last Name for the USERNAME. Example: User Name = Test User
>sudo chown -R TUser ~/Library/”Application Support”/Lotus\ Notes\ Data
Technote: http://www-01.ibm.com/support/docview.wss?uid=swg21635517
© 2017 IBM Corporation 32
How to Troubleshoot Performance Crash, Hang & Delay (cont’d)
Collecting Crash Stack1. Navigate to the folder: /Users/<username>/Library/Logs/DiagnosticReports
The files are like “Eclipse_<date time>_<host name>.crash” or “Notes_<date time>_<host name>.crash”
Note: Unlike Notes on Windows, the crash stack of Mac Notes will not be included in NSD file. Mac OS handles the crash stack itself.
© 2017 IBM Corporation 33
How to Collect Crash Stack
Collecting Crash Stack For hang or other cases that Notes is running, use Sample function in Activity.
/Applications/Utilities/Activity Monitor.app
© 2017 IBM Corporation 34
How to Collect Crash Stack (cont’d)
For more presentation on troubleshooting Steps for Mac Crash, Hang & Delay,please go to the URL below and download the PowerPoint presentations:
http://www-01.ibm.com/support/docview.wss?uid=swg21386895
http://www-01.ibm.com/support/docview.wss?uid=swg21635517
http://www-01.ibm.com/support/docview.wss?uid=swg21504652
• How to run NSD manually for Notes on Macintoshhttp://www-01.ibm.com/support/docview.wss?uid=swg21472694
© 2017 IBM Corporation 35
Resources for Notes on Mac Troubleshooting
Known Issues
© 2017 IBM Corporation 36
2017 IBM Corporation 37
1. Notes failed to launch on new MacBook with Touch Bar
http://www-01.ibm.com/support/docview.wss?uid=swg21995145
2. IBM Notes is affected with Open Source Apache Struts Vulnerabilities CVE-2016-1181
& CVE-2016-1182
http://www-01.ibm.com/support/docview.wss?uid=swg21988182
3. IBM Notes is affected by Open Source Apache Taglibs Vulnerability CVE-2015-0254
http://www-01.ibm.com/support/docview.wss?uid=swg21989475
4. Notes crash when printing a calendar with “Print calendar to a document” option on Mac
http://www-01.ibm.com/support/docview.wss?uid=swg21991680c OS Sierra
Examples of Known Issues
Questions?
© 2017 IBM Corporation 38