Build Troubleshooting

General

CMake problems

• CMake cannot find dependencies like flex, bison, boost, eigen3, qt5, fftw, sip, tbb, or openbabel?
  • Make sure your ball_contrib build was successful.
  • Make sure you have specified the CMake command line variable BALL_CONTRIB_PATH correctly.

Build problems

• BALL build breaks with linker errors concerning boost.
  • Check if you have conflicting boost versions installed.

Runtime problems

• Dynamic libraries not found?
  • Make sure you have set the environment variables correctly.

Linux

BALL_contrib problems

• If CMake or the build fail.
  • Have a look at official packages we install on our Linux build servers.

macOS

Build problems

• Quaternion class fails to build with error: no matching function for call to 'conditional_aligned_malloc'
  • This is a bug in eigen3 before version 3.3. Make sure to update the BALL_contrib or install a newer version of eigen3

Windows

BALL_contrib problems

• Build step for Qt5 fails and qt5-build-err.log contains something like: nmake fatal error u1077 return code '0x2'
  • This usually hints at disabled 'NTFS long path support' on Windows and is a bit annoying.
  • Check this and this.
  • Please note that this option is not available on all Windows versions.

Runtime problems

• BALLView startup fails with: '... procedure entry point XYZ could not be located in the dynamic link library XYZ.dll'
  • This has been observed for Qt5 library dlls.
  • Check if conflicting Qt5 libraries are listed in PATH before the correct ones.
  • This can happen for a CMake installation that has been added to your PATH (CMake brings Qt5 libs!).