Visible to Intel only — GUID: GUID-04EBEEA3-2CCB-43E0-BA1B-B664AC357F96
Installation Guide
This page explains how to install and configure the Intel® oneAPI Collective Communications Library (oneCCL). oneCCL supports different installation scenarios using command line interface.
System Requirements
Visit Intel® oneAPI Collective Communications Library System Requirements to learn about hardware and software requirements for oneCCL.
Installation using Command Line Interface
To install oneCCL using command line interface (CLI), follow these steps:
Go to the ccl folder:
cd ccl
Create a new folder:
mkdir build
Go to the folder created:
cd build
Launch CMake:
cmake ..
Install the product:
make -j install
In order to have a clear build, create a new build directory and invoke cmake within the directory.
Custom Installation
You can customize CLI-based installation (for example, specify directory, compiler, and build type):
To specify installation directory, modify the cmake command:
cmake .. -DCMAKE_INSTALL_PREFIX=</path/to/installation/directory>
If no -DCMAKE_INSTALL_PREFIX is specified, oneCCL is installed into the _install subdirectory of the current build directory. For example, ccl/build/_install.
To specify compiler, modify the cmake command:
cmake .. -DCMAKE_C_COMPILER=<c_compiler> -DCMAKE_CXX_COMPILER=<cxx_compiler>
To enable SYCL devices communication support, specify SYCL compiler (only Intel® oneAPI DPC++/C++ Compiler is supported):
cmake .. -DCMAKE_C_COMPILER=icx -DCMAKE_CXX_COMPILER=icpx -DCOMPUTE_BACKEND=dpcpp
To specify the build type, modify the cmake command:
cmake .. -DCMAKE_BUILD_TYPE=[Debug|Release]
To enable make verbose output to see all parameters used by make during compilation and linkage, modify the make command as follows:
make -j VERBOSE=1 install
Environment Setup
Before you start using oneCCL, make sure to set up the library environment. There are two ways to set up the environment:
Using standalone oneCCL package installed into <ccl_install_dir>:
Using oneCCL from Intel® oneAPI Base Toolkit installed into <toolkit_install_dir> (/opt/intel/inteloneapi by default):