Skip to content
Percona Software for MongoDB Documentation

Build from source code

To build Percona Server for MongoDB, you need:

  • A modern C++ compiler capable of compiling C++17 like GCC 8.2 or newer
  • Amazon AWS Software Development Kit for C++ library
  • Python 3.6.x and Pip.
  • The set of dependencies for your operating system. The following table lists dependencies for Ubuntu 20.04, CentOS 7 and Red Hat Enterprise 8 and compatible derivatives:
Linux Distribution Dependencies
Debian/Ubuntu python3 python3-dev python3-pip scons gcc g++ cmake curl libssl-dev libldap2-dev libkrb5-dev libcurl4-openssl-dev libsasl2-dev liblz4-dev libpcap-dev libbz2-dev libsnappy-dev zlib1g-dev libzlcore-dev libsasl2-dev liblzma-dev libext2fs-dev e2fslibs-dev bear
CentOS / RedHat Enterprise Linux 7 centos-release-scl epel-release python3 python3-devel scons gcc gcc-c++ cmake3 openssl-devel cyrus-sasl-devel snappy-devel zlib-devel bzip2-devel libcurl-devel lz4-devel openldap-devel krb5-devel xz-devel e2fsprogs-devel expat-devel devtoolset-8-gcc devtoolset-8-gcc-c++
RedHat Enterprise Linux/CentOS 8 python36 python36-devel gcc-c++ gcc cmake3 wget openssl-devel zlib-devel cyrus-sasl-devel xz-devel bzip2-devel libcurl-devel lz4-devel e2fsprogs-devel krb5-devel openldap-devel expat-devel cmake

Build steps

Install Python and Python modules

  1. Clone Percona Server for MongoDB repository

    $ git clone https://github.com/percona/percona-server-mongodb.git

  2. Install the dependencies for your operating system.

    The following command installs the dependencies for Ubuntu 20.04: 

    $ sudo apt install -y python3 python3-dev python3-pip scons gcc g++ cmake curl libssl-dev libldap2-dev libkrb5-dev libcurl4-openssl-dev libsasl2-dev liblz4-dev libpcap-dev libbz2-dev libsnappy-dev zlib1g-dev libzlcore-dev libsasl2-dev liblzma-dev libext2fs-dev e2fslibs-dev bear

    1. The following command installs the dependencies for CentOS 7:

      $ sudo yum -y install centos-release-scl epel-release 
$ sudo yum -y install python3 python3-devel scons gcc gcc-c++ cmake3 openssl-devel cyrus-sasl-devel snappy-devel zlib-devel bzip2-devel libcurl-devel lz4-devel openldap-devel krb5-devel xz-devel e2fsprogs-devel expat-devel devtoolset-8-gcc devtoolset-8-gcc-c++

    2. Build a specific curl version

      • Fetch the package archive 

        $ wget https://curl.se/download/curl-7.66.0.tar.gz

      • Unzip the package 

        $ tar -xvzf curl-7.66.0.tar.gz && cd curl-7.66.0

      • Configure and build the package 

        $ ./configure
$ sudo make install

  3. Switch to the Percona Server for MongoDB branch that you are building and install Python3 modules

    $ cd percona-server-mongodb && git checkout v5.0
$ pip3 install --user -r etc/pip/dev-requirements.txt

  4. Define Percona Server for MongoDB version (5.0.2 for the time of writing this document)

    $ echo '{"version": "5.0.2"}' > version.json

Build the AWS Software Development Kit for C++ library

  1. Clone the AWS Software Development Kit for C++ repository

    $ git clone --recurse-submodules https://github.com/aws/aws-sdk-cpp.git

  2. Create a directory to store the AWS library 

    $ mkdir -p /tmp/lib/aws

  3. Declare an environment variable AWS_LIBS for this directory 

    $ export AWS_LIBS=/tmp/lib/aws

  4. Percona Server for MongoDB is built with AWS SDK CPP 1.9.379 version. Switch to this version 

    $ cd aws-sdk-cpp && git checkout 1.9.379

  5. It is recommended to keep build files outside the SDK directory. Create a build directory and navigate to it 

    $ mkdir build && cd build

  6. Generate build files using cmake 

    $ cmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_ONLY="s3;transfer" -DBUILD_SHARED_LIBS=OFF -DMINIMIZE_SIZE=ON -DCMAKE_INSTALL_PREFIX="${AWS_LIBS}"

    $ cmake3 .. -DCMAKE_C_COMPILER=/opt/rh/devtoolset-8/root/usr/bin/gcc  -DCMAKE_CXX_COMPILER=/opt/rh/devtoolset-8/root/usr/bin/g++ -DCMAKE_BUILD_TYPE=Release -DBUILD_ONLY="s3;transfer" -DBUILD_SHARED_LIBS=OFF -DMINIMIZE_SIZE=ON -DCMAKE_INSTALL_PREFIX="${AWS_LIBS}"

    $ cmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_ONLY="s3;transfer" -DBUILD_SHARED_LIBS=OFF -DMINIMIZE_SIZE=ON -DCMAKE_INSTALL_PREFIX="${AWS_LIBS}"

  7. Install the SDK 

    $ make install

Build Percona Server for MongoDB

  1. Change directory to percona-server-mongodb 

    $ cd percona-server-mongodb

  2. Build Percona Server for MongoDB from buildscripts/scons.py.

    $ buildscripts/scons.py -j$(nproc --all) --jlink=2 --disable-warnings-as-errors --ssl --opt=on --use-sasl-client --wiredtiger --audit --inmemory --hotbackup CPPPATH="${AWS_LIBS}/include" LIBPATH="${AWS_LIBS}/lib" install-mongod

    $ python3 buildscripts/scons.py CC=/opt/rh/devtoolset-8/root/usr/bin/gcc CXX=/opt/rh/devtoolset-8/root/usr/bin/g++ -j$(nproc --all) --jlink=2 --install-mode=legacy --disable-warnings-as-errors --ssl --opt=on --use-sasl-client --wiredtiger --audit --inmemory --hotbackup CPPPATH="${AWS_LIBS}/include" LIBPATH="${AWS_LIBS}/lib"  mongod

    $ buildscripts/scons.py -j$(nproc --all) --jlink=2 --install-mode=legacy --disable-warnings-as-errors --ssl --opt=on --use-sasl-client --wiredtiger --audit --inmemory --hotbackup CPPPATH="${AWS_LIBS}/include" LIBPATH="${AWS_LIBS}/lib64" mongod

This command builds only the database. Other available targets for the scons command are:

  • mongod
  • mongos
  • mongo
  • core (includes mongod, mongos, mongo)
  • all

The built binaries are in the percona-server-mongodb directory.

Next steps

Connect to MongoDB

Get expert help

If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.

Community Forum Get a Percona Expert