Deployment

The user-mode library comes in two pieces, both of which must be deployed along with the application:

  1. A JAR file, named cbfssync.jar
  2. A platform-native dynamic library with JNI (Java Native Interface), named as follows:
    • Windows: jnicbfssync24.dll (available for 32-bit (x86) and 64-bit (x64) processors)
    • Linux: libjnicbfssync.24.0.so (available for 32-bit (x86) and 64-bit (x64) processors)
    • macOS: libjnicbfssync24.0.dylib (available for x64 and ARM64 processors)

When deploying the application, copy both the JAR and the native library to the target system and place them next to the application.

Alternatively, the native library may be placed into one of directories, the paths to which are contained in the

  • Windows: PATH environment variable, such as C:\Windows\System32 (or C:\Windows\SysWOW64 when deploying a 32-bit application on a 64-bit Windows system)
  • Linux: LD_LIBRARY_PATH environment variable
  • macOS: DYLD_LIBRARY_PATH environment variable

Note: A deploy.jar file also may be used instead of cbfssync.jar; it is smaller, and does not contain Intellisense data or Javadoc content.

Windows:

The native library may alternatively be installed to the Windows system directory. This approach allows deploying both the 32-bit and 64-bit versions of the native library simultaneously, because each gets placed into the system directory that corresponds to the appropriate processor architecture.