Compilation

This topic is about how to compile Doris from source.

Compile With Docker Development Image (Recommended)

Use Off-the-Shelf Image

1. Download Docker image

   $ docker pull apache/doris:build-env-ldb-toolchain-latest

   Check if the download is completed

   $ docker images
   REPOSITORY               TAG                              IMAGE ID            CREATED             SIZE
   apache/doris   build-env-ldb-toolchain-latest   49f68cecbc1a        4 days ago          3.76GB

Note 1: For different versions of Doris, you need to download the corresponding image version. For Apache Doris 0.15 and above, the corresponding Docker image will have the same version number as Doris. For example, you can use apache/doris:build-env-for-0.15.0 to compile Apache Doris 0.15.0.

Note 2: apache/doris:build-env-ldb-toolchain-latest is used to compile the latest trunk code. It will keep up with the update of the trunk code. You may view the update time in docker/README.md.

Note:

1. Third-party libraries in images with “no-avx2” in their names can run on CPUs that do not support avx2 instructions. Doris can be compiled with the USE_AVX2=0 option.

2. Dev docker image ChangeLog

3. For Doris 0.14.0, use apache/incubator-doris:build-env-1.2 to compile; for Doris 0.14.x, use apache/incubator-doris:build-env-1.3.1 to compile.

4. The docker images of build-env-1.3.1 and above include both OpenJDK 8 and OpenJDK 11, please confirm the default JDK version with java -version. You can also switch versions as follows. (It is recommended to use JDK8.)

   Switch to JDK 8:

   alternatives --set java java-1.8.0-openjdk.x86_64
   alternatives --set javac java-1.8.0-openjdk.x86_64
   export JAVA_HOME=/usr/lib/jvm/java-1.8.0

   Switch to JDK 11:

   alternatives --set java java-11-openjdk.x86_64
   alternatives --set javac java-11-openjdk.x86_64
   export JAVA_HOME=/usr/lib/jvm/java-11

1. Run the image

   $ docker run -it apache/doris:build-env-ldb-toolchain-latest

   It is recommended to run the image by mounting the local Doris source directory, so that the compiled binary file will be stored in the host machine and will not disappear because of the exit of the image.

   Meanwhile, it is recommended to mount the maven .m2 directory in the image to the host directory to prevent repeated downloading of maven’s dependent libraries each time the compilation is started.

   $ docker run -it -v /your/local/.m2:/root/.m2 -v /your/local/doris-DORIS-x.x.x-release/:/root/doris-DORIS-x.x.x-release/ apache/doris:build-env-ldb-toolchain-latest

2. Download source code

   After starting the image, you should be in the container. You can download the Doris source code using the following command (If you have mounted the local Doris source directory, you don’t need do this):

   $ git clone https://github.com/apache/doris.git

3. Compile Doris

   Firstly, run the following command to check whether the compilation machine supports the avx2 instruction set.

   $ cat /proc/cpuinfo | grep avx2

   If it is not supported, use the following command to compile.

   $ USE_AVX2=0 sh build.sh

   If supported, use the following command to compile.

   $ sh build.sh

   After compilation, the output files will be in the output/ directory.

   Note:

   If you are using build-env-for-0.15.0 or the subsequent versions for the first time, use the following command when compiling:

   sh build.sh --clean --be --fe --ui

   This is we have upgraded the thrift (0.9 -> 0.13) for build-env-for-0.15.0 and the subsequent versions. That means you need to use the —clean command to force the use of the new version of thrift to generate code files, otherwise it will result in code incompatibility.

   After compilation, the output file will be in the output/ directory.

Self-Compile Development Environment Image

You can create a Doris development environment image yourself. Check docker/README.md for details.

Direct Compilation (Ubuntu)

You can compile Doris directly in your own Linux environment.

1. System Dependencies

   • System dependencies before commit ad67dd3 are as follows:

     GCC 7.3+, Oracle JDK 1.8+, Python 2.7+, Apache Maven 3.5+, CMake 3.11+ Bison 3.0+

     If you are using Ubuntu 16.04 or newer, you can use the following command to install the dependencies:

     sudo apt-get install build-essential openjdk-8-jdk maven byacc flex automake libtool-bin bison binutils-dev libiberty-dev zip unzip libncurses5-dev curl git ninja-build python autopoint pkg-config
     apt-add-repository 'deb https://apt.kitware.com/ubuntu/ focal main'
     apt-get update && apt-get install cmake

     If you are using CentOS, you can use the following command to install the dependencies:

     sudo yum groupinstall 'Development Tools' && sudo yum install maven cmake byacc flex automake libtool bison binutils-devel zip unzip ncurses-devel curl git wget python2 glibc-static libstdc++-static java-1.8.0-openjdk

   • System dependencies after commit ad67dd3 are as follows:

     GCC 10+, Oracle JDK 1.8+, Python 2.7+, Apache Maven 3.5+, CMake 3.19.2+ Bison 3.0+

     If you are using Ubuntu 16.04 or newer, you can use the following command to install the dependencies:

     sudo apt install build-essential openjdk-8-jdk maven cmake byacc flex automake libtool-bin bison binutils-dev libiberty-dev zip unzip libncurses5-dev curl git ninja-build python
     sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
     sudo apt update
     sudo apt install gcc-11 g++-11
     ln -s /usr/bin/g++-11 /usr/bin/g++
     ln -s /usr/bin/gcc-11 /usr/bin/gcc
     sudo apt-get install autoconf automake libtool autopoint

2. Compile Doris

   This is the same as compiling with the Docker development image. Before compiling, you need to check whether the avx2 instruction is supported.

   $ cat /proc/cpuinfo | grep avx2

   If it is supported, use the following command to compile:

   $ sh build.sh

   If not supported, use the following command to compile:

   $ USE_AVX2=0 sh build.sh

   After compilation, the output files will be in the output/ directory.

FAQ

1. Could not transfer artifact net.sourceforge.czt.dev:cup-maven-plugin:pom:1.6-cdh from/to xxx

   If you encounter the above error, please refer to PR #4769 and modify the cloudera-related repo configuration in fe/pom.xml.

2. Invalid download links of third-party dependencies

   The download links of the third-party libraries that Doris relies on are all in the thirdparty/vars.sh file. Over time, some download links may fail. If you encounter this situation. It can be solved in the following two ways:

   1. Manually modify the thirdparty/vars.sh file

      Manually modify the problematic download links and the corresponding MD5 value.

   2. Use a third-party download warehouse:

      export REPOSITORY_URL=https://doris-thirdparty-repo.bj.bcebos.com/thirdparty
      sh build-thirdparty.sh

      REPOSITORY_URL contains all third-party library source code packages and their historical versions.

3. fatal error: Killed signal terminated program ...

   If you encounter this error, the possible reason is not enough memory allocated to the image. (The default memory allocation for Docker is 2 GB, and the peak memory usage during the compilation might exceed that.)

   You can fix this by increasing the memory allocation for the image, 4 GB ~ 8 GB, for example.

Special Statement

Starting from version 0.13, the dependency on the two third-party libraries [1] and [2] will be removed in the default compiled output. These two third-party libraries are under GNU General Public License V3. This license is incompatible with Apache License 2.0, so it will not appear in the Apache release by default.

Remove library [1] will result in the inability to access MySQL external tables. The feature of accessing MySQL external tables will be implemented through UnixODBC in future release version.

Remove library [2] will cause some data written in earlier versions (before version 0.8) to be unable to read. Because the data in the earlier version was compressed using the LZO algorithm, in later versions, it has been changed to the LZ4 compression algorithm. We will provide tools to detect and convert this part of the data in the future.

If required, you can continue to use these two libraries by adding the following option when compiling:

WITH_MYSQL=1 WITH_LZO=1 sh build.sh

Note that if you use these two third-party libraries, that means you choose not to use Doris under the Apache License 2.0, and you might need to pay attention to the GPL-related agreements.

• [1] mysql-5.7.18
• [2] lzo-2.10