Troubleshooting

'libunwind.h' not found
- You might add CMake argument -DWITH_UNWIND=OFF, or install libunwind in your system.

CUDNN_STATUS_NOT_INITIALIZED

You might see error message like these:

I0729 22:37:45.483937439   56788 ev_epoll_linux.c:82]        Use of signals is disabled. Epoll enginll not be used
E0729 22:37:45.515343 56788 version.cpp:82] Failed to get cuda runtime version: CUDA driver version nsufficient for CUDA runtime version
F0729 22:38:31.209002 56788 improver.cpp:535] Check failed: mem_size > 0 (-524288000 vs. 0)

F0723 19:05:56.194067 40970 cuda_util.cpp:82] Check failed: error == CUDNN_STATUS_SUCCESS (1 vs. 0) CUDNN_STATUS_NOT_INITIALIZED

Please upgrade to Nvidia Linux x86_64 driver. Version >= 440.33 is recommended.
For more information, please refer to CUDA compatibility documentation.

Failed to compile .cu files
- Please refer to CUDA System Requirements . Make sure your linux distribution and libraries shipped with it meet the requirements.
- If you are using tools like conda, please make sure libraries you install doesn't shade the proper installation comes with linux distribution or package management like apt-get.
- Please build OneFlow with a newer version of CMake. You could download version 3.14 from here: https://github.com/Kitware/CMake/releases/download/v3.14.0/cmake-3.14.0-Linux-x86_64.tar.gz
How do I know what compilers and flags are used to compile OneFlow?
- run make clean && make VERBOSE=1 to get exact compile commands with compiler path and flags
How to compile OneFlow with RDMA support?
- add cmake flag -DBUILD_RDMA to compile OneFlow
Which version of g++ CMake is using to build OneFlow?
- You should find a line like this in CMake output:
```
-- CMAKE_CXX_COMPILER_VERSION: [YOUR G++ VERSION NUMBER]
```
Failed to compile NCCL
- Try use less threads when compiling OneFlow third party. For instance, use
```
cmake -DTHIRD_PARTY=ON .. && make
```
  instead of
```
cmake -DTHIRD_PARTY=ON .. && make -j$(nproc) `
```
"CUDA_VERSION" "VERSION_GREATER_EQUAL" "10.0"
- Please use a newer version of CMake
- Make sure cmake is correctly included in PATH
CUBLAS not found
- Usually it happens when using CUDA 10.1 or newer
- You should see error massage by CMake like this:
```
cuda lib not found: /usr/local/miniconda3/envs/dl/lib/libcublas_static.a or
/usr/local/cuda/lib64/libcublas_static.a
```
- Make sure libcublas_static.a is in one of the two directories.
When running OneFlow in gdb, there is no debug information for code location.
- add cmake flag -DCMAKE_BUILD_TYPE=RELWITHDEBINFO or -DCMAKE_BUILD_TYPE=DEBUG and recompile
libof_ccobj.a: File truncated
- You might see error message like this:
```
/usr/bin/ar: libof_ccobj.a: File truncated
make[2]: *** [libof_ccobj.a] Error 1
make[2]: *** Deleting file `libof_ccobj.a'
make[1]: *** [CMakeFiles/of_ccobj.dir/all] Error 2
make: *** [all] Error 2
```
- You should upgrade your GNU Binutils. Version 2.33.1 is recommended. If you are using conda, you could install it by running conda install -c conda-forge binutils
Failed to compile because C++ 17 is enabled
- In some cases, environment variable CXXFLAGS is not empty and contains --std c++17.
- Check if it is empty by running echo $CXXFLAGS and clear it with unset CXXFLAGS.
- If you are using conda, to make the changes on environment variables permanent, you can run:
```
conda env config vars set CXXFLAGS="-fPIC"
```
cmake outputs error No CMAKE_ASM_NASM_COMPILER could be found.
- Install nasm. For instance, run sudo yum install nasm if you are on centos.

No module named 'google.protobuf'

You might see error message like this:

Scanning dependencies of target generate_api
...
    from google.protobuf import descriptor as _descriptor
ModuleNotFoundError: No module named 'google.protobuf'
CMakeFiles/generate_api.dir/build.make:57: recipe for target 'CMakeFiles/generate_api' failed
make[2]: *** [CMakeFiles/generate_api] Error 1

Install development dependencies by running:
```
pip3 install -r dev-requirements.txt
```

Get gdb warning ptrace: Operation not permitted. and gdb command bt prints no backtrace
- You might get this warning when debugging OneFlow with gdb inside a docker container. Try add these flags when launching your container:
```
docker run --cap-add=SYS_PTRACE --security-opt seccomp=unconfined
```
- Please refer to https://stackoverflow.com/questions/19215177/how-to-solve-ptrace-operation-not-permitted-when-trying-to-attach-gdb-to-a-pro
It takes too long to download python packages when running make
- If you are in China, you could run this to have pip download packages from domestic mirror of pypi:
```
python3 -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
```
- For more information on this, please refer to pypi 镜像使用帮助

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!