An exception occurs and the following error is returned when using the Surround SCM Java API on Linux to run the SSCMAPI.connect action:
'The sscmapi2010 library cannot be loaded. Copy the library into the library search path and then try again.’
The Surround SCM .jar file has a loadLibrary function call that is failing when trying to load the Surround SCM API C library. The function is using an incorrect library name and the path to the library is incorrect in the java.library.path value used by the Java VM.
- Create a correctly named symlink to the libsscmapi.so file in the same directory as the API library. The default directory is /var/lib/SurroundSCM/API/lib.
If you are using Surround SCM 2010, create a symlink named libsscmapi2010.so to the libsscmapi.2010.x.x library, where x indicates the Surround SCM version (e.g., 2010.0.1).
If you are using Surround SCM 2011 or later, create a symlink named libsscmapi.so to the libsscmapi.xxxx.x.x library, where x indicates the Surround SCM version (e.g., 2011.0.1).
- Set the correct java.library.path value using one of the following methods:
- Use the –Djava.library.path=/var/lib/SurroundSCM/API/lib option when you run the compiled .jar file. For example, java –Djava.library.path=/var/lib/SurroundSCM/API/lib –jar CompiledProgram.jar. Refer to your IDE documentation for information about setting Java VM runtime arguments.
- Append the path to the LD_LIBRARY_PATH system variable. For example, LD_LIBRARY_PATH=/var/lib/SurroundSCM/API/lib.