openGauss 编译指南：版本编译（2）

软件安装编译

软件安装编译即将代码编译生成软件，并将软件安装到机器上。提供一键式编译脚本build.sh进行操作，也可以自己配置环境变量手动操作。两种方式将在本章节的一键式脚本编译操作步骤、手动编译操作步骤中进行讲解。

前提条件

• 已按照搭建编译环境的要求准备好相关软硬件，并且已参考代码下载下载了代码。
• 已完成开源软件编译构建，具体请参见开源软件编译构建。并将gcc7.3按已发布的编译好的第三方库目录结构放置在output目录中。
• 了解build.sh介绍脚本的参数选项和功能。
• 代码环境干净，没有以前编译生成的文件。具体请参见FAQ。

一键式脚本编译

1. 执行如下命令进入到软件代码编译脚本目录。

   [user@linux sda]$ cd /sda/openGauss-server
   

2. 执行如下命令，编译安装openGauss。

   [user@linux openGauss-server]$ sh build.sh -m [debug | release | memcheck] -3rd [binarylibs path]
   

   例如：

   sh build.sh        # 编译安装release版本的openGauss。需代码目录下有binarylibs或者其软链接，否则将会失败。
   sh build.sh -m debug -3rd /sdc/binarylibs            # 编译安装debug版本的openGauss
   

3. 显示如下内容，表示编译成功。

   make compile successfully!
   

   • 编译后软件安装路径为：/sda/openGauss-server/mppdb_temp_install
   • 编译后的二进制放置路径为：/sda/openGauss-server/mppdb_temp_install/bin
   • 编译日志为：./build/script/makemppdb_pkg.log

4. 导入环境变量，即可进行初始化和启动数据库。

   export CODE_BASE=________     # openGauss-server的路径
   export GAUSSHOME=$CODE_BASE/mppdb_temp_install/
   export LD_LIBRARY_PATH=$GAUSSHOME/lib::$LD_LIBRARY_PATH
   export PATH=$GAUSSHOME/bin:$PATH
   

手动编译

1. 执行如下命令进入到软件代码目录。

   [user@linux sda]$ cd /sda/openGauss-server
   

2. 获取对应平台的三方库二进制文件。

3. 配置环境变量，根据自己的代码下载位置补充两处“____”

   export CODE_BASE=________     # openGauss-server的路径
   export BINARYLIBS=________    # binarylibs的路径
   export GAUSSHOME=$CODE_BASE/dest/
   export GCC_PATH=$BINARYLIBS/buildtools/________    # gcc的版本，根据三方包中对应的gcc版本进行填写即可，一般由gcc7.3或gcc10.3两种
   export CC=$GCC_PATH/gcc/bin/gcc
   export CXX=$GCC_PATH/gcc/bin/g++
   export LD_LIBRARY_PATH=$GAUSSHOME/lib:$GCC_PATH/gcc/lib64:$GCC_PATH/isl/lib:$GCC_PATH/mpc/lib/:$GCC_PATH/mpfr/lib/:$GCC_PATH/gmp/lib/:$LD_LIBRARY_PATH
   export PATH=$GAUSSHOME/bin:$GCC_PATH/gcc/bin:$PATH
   

4. 选择版本进行configure。

   debug版：

   # gcc7.3.0版本
   ./configure --gcc-version=7.3.0 CC=g++ CFLAGS='-O0' --prefix=$GAUSSHOME --3rd=$BINARYLIBS --enable-debug --enable-cassert --enable-thread-safety --with-readline --without-zlib
   
   # gcc10.3.1版本（一般用于openEuler + ARM架构）
   ./configure --gcc-version=10.3.1 CC=g++ CFLAGS='-O0' --prefix=$GAUSSHOME --3rd=$BINARYLIBS --enable-debug --enable-cassert --enable-thread-safety --with-readline --without-zlib
   
   # gcc10.3.0版本
   ./configure --gcc-version=10.3.0 CC=g++ CFLAGS='-O0' --prefix=$GAUSSHOME --3rd=$BINARYLIBS --enable-debug --enable-cassert --enable-thread-safety --with-readline --without-zlib
   

   release版：

   # gcc7.3.0版本
   ./configure --gcc-version=7.3.0 CC=g++ CFLAGS="-O2 -g3" --prefix=$GAUSSHOME --3rd=$BINARYLIBS --enable-thread-safety --with-readline --without-zlib
   
   # gcc10.3.1版本（一般用于openEuler + ARM架构）
   ./configure --gcc-version=10.3.1 CC=g++ CFLAGS="-O2 -g3" --prefix=$GAUSSHOME --3rd=$BINARYLIBS --enable-thread-safety --with-readline --without-zlib
   
   # gcc10.3.0版本
   ./configure --gcc-version=10.3.0 CC=g++ CFLAGS="-O2 -g3" --prefix=$GAUSSHOME --3rd=$BINARYLIBS --enable-thread-safety --with-readline --without-zlib
   

   memcheck版：

   # gcc7.3.0版本
   ./configure --gcc-version=7.3.0 CC=g++ CFLAGS='-O0' --prefix=$GAUSSHOME --3rd=$BINARYLIBS --enable-debug --enable-cassert --enable-thread-safety --with-readline --without-zlib --enable-memory-check
   
   # gcc10.3.1版本（一般用于openEuler + ARM架构）
   ./configure --gcc-version=10.3.1 CC=g++ CFLAGS='-O0' --prefix=$GAUSSHOME --3rd=$BINARYLIBS --enable-debug --enable-cassert --enable-thread-safety --with-readline --without-zlib --enable-memory-check
   
   # gcc10.3.0版本
   ./configure --gcc-version=10.3.0 CC=g++ CFLAGS='-O0' --prefix=$GAUSSHOME --3rd=$BINARYLIBS --enable-debug --enable-cassert --enable-thread-safety --with-readline --without-zlib --enable-memory-check
   

   

    说明：

   • [debug | release | memcheck] 表示可选择三种目标版本，三种目标版本如下所示：

     • release：代表生成release版本的二进制程序，该版本编译时，配置GCC高级别优化选项，去除内核调试代码，通常用于生产环境或性能测试环境。

     • debug：代表生成debug版本的二进制程序，该版本编译时，增加内核代码调试功能，通常用于开发自测环境。

     • memcheck：代表生成memcheck版本的二进制程序。该版本编译时，实质上是在debug版本基础上增加了ASAN功能，此版本通常用于定位内存问题。

   • 在ARM平台上，CFLAGS需要添加-D__USE_NUMA。在ARMv8.1或者更高的平台上（例如鲲鹏920），CFLAGS需要添加-D__ARM_LSE。

   • 若将binarylibs移动到openGauss-server下，或在openGauss-server下创建了指向binarylibs的软链接，可不指定--3rd参数。但这样做的话需要注意其容易被git clean等操作删除。

   • 如需使用MOT，需要在命令中添加 --enable-mot。

5. 执行如下命令，编译安装。

   [user@linux openGauss-server]$ make -sj
   [user@linux openGauss-server]$ make install -sj
   

   说明：

   • -s参数是silent模式，有些编译信息不会打印出来。
   • 如果使用-j参数，make执行的时候会一直增加并发数，有时会遇到“cannot allicate memory”的错。一般-j参数后可指定数字为 cpu数 X 2。如编译环境是4 CPU，可使用make -j8的参数进行编译。

6. 显示如下内容，表示编译安装成功。

   openGauss InstallationGuide complete.
   

   • 编译后软件安装路径为：$GAUSSHOME
   • 编译后的二进制放置路径为：$GAUSSHOME/bin

openGauss-OM编译

源码编译完openGauss-server代码仓之后，并没有gs_om。如需使用gs_om，需单独编译openGauss-OM，并将编译好的openGauss-xxx-om.tar.gz的包拷贝到openGauss-server安装包所在的目录，再按照企业版的方式进行安装。

操作步骤

1. git clone OM代码仓：

   [user@linux sda]$ git clone https://gitee.com/opengauss/openGauss-OM.git
   

2. 执行编译：

   [user@linux sda]$ cd openGauss-OM
   [user@linux sda]$ chmod +x build.sh
   [user@linux sda]$ export BINARYLIBS_PATH=/root/binarylibs  (这里填写前面的第三方软件包解压后的目录)
   [user@linux sda]$ ./build.sh -3rd $BINARYLIBS_PATH
   

3. 显示以下内容，表示 Gauss-OM编译成功：

ROOT_DIR: /root/binarylibs
Everything is ready.
success!