Domino & Notes error

java.lang.UnsatisfiedLinkError: no nlsxbe in java.library.path

Seen when a stand-alone Java program, servlet container or IDE uses Notes.jar for local calls.

What it means

Java could not load the Notes native library that the local Notes Java classes need.

Common causes

  • The Notes or Domino program directory is not on the PATH
  • Java and Notes are not the same bitness, such as 64-bit Java with 32-bit Notes
  • On Linux, the program directory is missing from LD_LIBRARY_PATH

Quick fixes

  1. Add the Notes or Domino program directory to the system PATH and restart the application
  2. Use a JVM that matches the bitness of the Notes or Domino install
  3. On Linux, set LD_LIBRARY_PATH as well, or use remote (DIIOP) sessions instead of local calls

Need a hand with this?

Paste your exact message into What's That Error? for a plain-English explanation, or get in touch. I've been supporting Domino and Notes for 28 years.

Disclaimer

The errors, causes and fixes on this site are carefully researched, drawing on HCL documentation and 28 years of hands-on Domino and Notes experience. Every environment is different, though, and a solution that works in one may not be right for yours. Exact wording can also vary between Domino and Notes versions.

This information is general guidance only and is provided without warranty of any kind. Always back up your data and test changes on a non-production system first. To the extent permitted by law, Bruinsma Services Pty Ltd accepts no responsibility or liability for any loss, damage, downtime or other consequence arising from use of this information. For advice specific to your environment, please contact me.