Troubleshooting

libadaptystserv.so not found#

After installing Adaptyst/adaptyst-server, you may get an error like the one below when trying to run the tool on Linux:

adaptyst: error while loading shared libraries: libadaptystserv.so: cannot open shared object file: No such file or directory

If this happens, please add <your installation prefix>/lib (it’s /usr/local/lib by default) to /etc/ld.so.conf and run ldconfig afterwards. Alternatively, run Adaptyst with <your installation prefix>/lib appended to the LD_LIBRARY_PATH environment variable.

Profiler “…” (perf-record / perf-script) has returned non-zero exit code#

If you get an error message similar to the one in the title, please look at the logs in the temporary directory printed by Adaptyst.

If the logs mention “can’t access trace events”, permission denied issues, or problems with eBPF, please ensure that the requirements for running Adaptyst as non-root are met (see the “Running Adaptyst as non-root” box in Running Adaptyst) or run Adaptyst as root. If it doesn’t work or the logs specify a different problem (or don’t say anything), feel free to contact us.

One or more expected symbol maps haven’t been found#

If you get a warning message as in the title, you can check whether your profiled program can be configured to emit “perf” symbol maps as documented here.

You should note that the lack of symbol maps is not an error, it will just make some symbol names unresolved and point to the name of an expected map file instead. This does not cause broken stack traces.

“perf” compilation fails when installing Adaptyst#

The patched “perf” is an integral part of Adaptyst. When you get errors at the stage of setting up “perf” and they point to some dependency missing (e.g. Clang), please install it and try again. If you get complaints about a program/library missing which is not listed in the installation instructions, please install it as well and let us know!

If the solution above doesn’t help, you can contact us. Additionally, if you know what you’re doing, you can change the “perf” compilation and installation settings (e.g. disable it altogether) in CMake (see Advanced CMake options in the installation guide) and for example, try setting up the patched “perf” manually (the repository is at https://gitlab.cern.ch/adaptyst/linux, go inside tools/perf there).