IBM NOTES ON MAC · * Lotus Notes Data for Notes 8.5.3 (and below) * IBM Notes Data for Notes 9 (and above). ... The install kit for Notes on Apple Mac OS X consists of the following:

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


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


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


IBM Notes on Windows counterparts in Mac OS.

Notes on MAC OS vs Windows

Install/UninstallIBM Notes on MAC


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


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.


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


CRITERIA for Mac OS X Installation & Upgrade on Notes (cont’d)

http://www-01.ibm.com/support/docview.wss?uid=swg21420461

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.


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)


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.


How To Install & Upgrade Notes on Mac OS X (cont’d)

5. Process the license agreement terms and click Continue.


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.


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.



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.



11. Read the Provisioning Result screen and click Continue.



12. Read the installation summary screen and click Close to exit the installation

wizard.



13. Start Notes by double clicking the new IBM Notes.app icon in the /Applications

directory.



Step-by-step instructions for installing Notes 8.5.x for Mac


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


Technotes for Mac OS X Installation & Upgrade on Notes


https://www-10.lotus.com/ldd/dominowiki.nsf/dx/Installing_IBM_Notes_9.0.1_on_MAC

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"


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.


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


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


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


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.



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:




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


Errors o Notes Supportability Limitations on MacNotes Supportability Limitations on Mac (cont’d)


Troubleshoot Crash, Hang &

Delay


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.


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.


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



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.


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


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:




• How to run NSD manually for Notes on Macintoshhttp://www-01.ibm.com/support/docview.wss?uid=swg21472694


Resources for Notes on Mac Troubleshooting





Known Issues


2017 IBM Corporation 37

1. Notes failed to launch on new MacBook with Touch Bar


2. IBM Notes is affected with Open Source Apache Struts Vulnerabilities CVE-2016-1181

& CVE-2016-1182


3. IBM Notes is affected by Open Source Apache Taglibs Vulnerability CVE-2015-0254


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?


Documents

IBM NOTES ON MAC · * Lotus Notes Data for Notes 8.5.3 (and below) * IBM Notes Data for Notes 9 (and above). ... The install kit for Notes on Apple Mac OS X consists of the following: