IZ86730: LD_LIBRARY_PATH NOT DOCUMENTED

APAR status

• Closed as documentation error.

Error description

• Error Message: JVM: JVMJ9VM011W Unable to load jdwp:
  libjdwp.so: cannot open shared object file: No such file or
  directory
  .
  Stack Trace: N/A
  .
  The JVM requires LD_LIBRARY_PATH to be set to the library
  folders when:
  You are using other shared libraries (including JNI native
  libraries you use or develop). Set the LIBPATH to include the
  directory or directories that contain your libraries.
  You are using the JNI Invocation API to call Java code from you
  C/C++ application. Set the LIBPATH to include the directories
  that contain the JVM libraries in addition to those that contain
  your own libraries.
  

Local fix

• The LD_LIBRARY_PATH environment variable should be modified to
  include
  the following:
  LD_LIBRARY_PATH=/lib:/usr/lib:"${JAVA_HOME}"/bin
  LD_LIBRARY_PATH="$LD_LIBRARY_PATH":"${JAVA_HOME}"/lib/<arch>
  LD_LIBRARY_PATH="$LD_LIBRARY_PATH":"${JAVA_HOME}"/lib/<arch>/j9v
  m
  LD_LIBRARY_PATH="$LD_LIBRARY_PATH":"${JAVA_HOME}"/bin/classic
  export LD_LIBRARY_PATH="$LD_LIBRARY_PATH":
  The structure and location of libjvm.so was changed from Java5
  to Java6. In Java5, for the purposes of finding libjvm.so, it
  was sufficient to limit LIBPATH to including
  "${JAVA_HOME}"/bin/j9vm and "${JAVA_HOME}"/bin. However, the
  Java6 change to the newly structured binaries requires that
  "${JAVA_HOME}"/lib/<arch> and "${JAVA_HOME}"/lib/<arch>/j9vm be
  added to LIBPATH.
  Substitute <arch> for the platform sdk that you are using :
  Linux PPC 32 bit : ppc,
  Linux PPC 64 bit : ppc64,
  Linux 390 32 bit : s390,
  Linux 390 : s390x,
  Linux 32 bit : i386,
  Linux 64 bit : amd64
  

Problem summary

• This defect will be fixed in:
  6.0.0 SR9
  .
  The problem is caused because the LD_LIBRARY_PATH environment
  variable is not set by java when jvm.dll is used.
  

Problem conclusion

• The documentation for IBM Java has been updated. Doc change is
  in the Diagnostics Guide from SR9.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels