openGauss-third_party: openGauss third party libraries

openGauss-third_party

这个仓库用来编译openGauss依赖的所有开源三方软件。本库的一些大文件通过Git LFS扩展管理，Git clone这个库时，需要确保Git安装了此插件。

这些开源文件通过以下方式处理： 1. 直接引用代码，例如masstree 2. 生成动态或静态库。

有四个目录
a、 build目录包括可以构建我们所依赖的所有第三方的脚本。
b、 buildtools包括用于编译这些opensources和openGauss服务器的构建工具。
c、 dependency包括openGauss服务器的所有依赖的开源组件。
d、 platform包括openjdk等开源软件。

编译好的二进制

社区提供编译好的三方库二进制，可以直接使用，版本和三方库下载地址对应如下：

分支	tag	gcc版本	下载路径
1.0.0	v1.0.0	gcc7.3	https://opengauss.obs.cn-south-1.myhuaweicloud.com/1.0.0/openGauss-third_party_binarylibs.tar.gz
1.0.0	v1.0.1	gcc7.3
1.1.0	v1.1.0	gcc7.3	https://opengauss.obs.cn-south-1.myhuaweicloud.com/1.1.0/openGauss-third_party_binarylibs.tar.gz
2.0.0	v2.0.0	gcc7.3	https://opengauss.obs.cn-south-1.myhuaweicloud.com/2.0.0/openGauss-third_party_binarylibs.tar.gz
	v2.0.1
	v2.0.2
	v2.0.3
	v2.0.4
	v2.0.5
2.1.0	v2.1.0	gcc7.3	https://opengauss.obs.cn-south-1.myhuaweicloud.com/2.1.0/openGauss-third_party_binarylibs.tar.gz
3.0.0	v3.0.0	gcc7.3	https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.0.0/openGauss-third_party_binarylibs.tar.gz
	v3.0.1
	v3.0.2
	v3.0.3		openEuler_arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.0.0/binarylibs/openGauss-third_party_binarylibs_openEuler_arm-3.0.3.tar.gz openEuler_x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.0.0/binarylibs/openGauss-third_party_binarylibs_openEuler_x86_64-3.0.3.tar.gz Centos_x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.0.0/binarylibs/openGauss-third_party_binarylibs_Centos7.6_x86_64-3.0.3.tar.gz
3.1.0	v3.1.0	gcc7.3	openEuler_arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.1.0/binarylibs/openGauss-third_party_binarylibs_openEuler_arm.tar.gz openEuler_x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.1.0/binarylibs/openGauss-third_party_binarylibs_openEuler_x86_64.tar.gz Centos_x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/3.1.0/binarylibs/openGauss-third_party_binarylibs_Centos7.6_x86_64.tar.gz
3.1.0	v3.1.1	gcc7.3
5.0.0	v5.0.0	gcc7.3	openEuler 20.03 arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs/openGauss-third_party_binarylibs_openEuler_arm.tar.gz openEuler 20.03 x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs/openGauss-third_party_binarylibs_openEuler_x86_64.tar.gz Centos_x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs/openGauss-third_party_binarylibs_Centos7.6_x86_64.tar.gz openEuler 22.03 arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs_2203/openGauss-third_party_binarylibs_openEuler_2203_arm.tar.gz openEuler 22.03 x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs_2203/openGauss-third_party_binarylibs_openEuler_2203_x86_64.tar.gz
5.1.0	v5.1.0	gcc7.3	openEuler 20.03 arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.1.0/binarylibs/gcc7.3/openGauss-third_party_binarylibs_openEuler_arm.tar.gz openEuler 20.03 x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.1.0/binarylibs/gcc7.3/openGauss-third_party_binarylibs_openEuler_x86_64.tar.gz Centos_x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.1.0/binarylibs/gcc7.3/openGauss-third_party_binarylibs_Centos7.6_x86_64.tar.gz openEuler 22.03 arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.1.0/binarylibs/gcc7.3/openGauss-third_party_binarylibs_openEuler_2203_arm.tar.gz openEuler 22.03 x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.1.0/binarylibs/gcc7.3/openGauss-third_party_binarylibs_openEuler_2203_x86_64.tar.gz
5.1.0	v5.1.0	gcc10.3	openEuler 20.03 arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.1.0/binarylibs/gcc10.3/openGauss-third_party_binarylibs_openEuler_arm.tar.gz openEuler 20.03 x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.1.0/binarylibs/gcc10.3/openGauss-third_party_binarylibs_openEuler_x86_64.tar.gz Centos_x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.1.0/binarylibs/gcc10.3/openGauss-third_party_binarylibs_Centos7.6_x86_64.tar.gz openEuler 22.03 arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.1.0/binarylibs/gcc10.3/openGauss-third_party_binarylibs_openEuler_2203_arm.tar.gz openEuler 22.03 x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.1.0/binarylibs/gcc10.3/openGauss-third_party_binarylibs_openEuler_2203_x86_64.tar.gz
master		gcc7.3	openEuler_arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/binarylibs/gcc7.3/openGauss-third_party_binarylibs_openEuler_arm.tar.gz openEuler_x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/binarylibs/gcc7.3/openGauss-third_party_binarylibs_openEuler_x86_64.tar.gz Centos_x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/binarylibs/gcc7.3/openGauss-third_party_binarylibs_Centos7.6_x86_64.tar.gz openEuler 22.03 arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/binarylibs/gcc7.3/openGauss-third_party_binarylibs_openEuler_arm.tar.gz openEuler 22.03 x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/binarylibs/gcc7.3/openGauss-third_party_binarylibs_openEuler_2203_x86_64.tar.gz
master		gcc10.3	openEuler_arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/binarylibs/gcc10.3/openGauss-third_party_binarylibs_openEuler_arm.tar.gz openEuler_x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/binarylibs/gcc10.3/openGauss-third_party_binarylibs_openEuler_x86_64.tar.gz Centos_x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/binarylibs/gcc10.3/openGauss-third_party_binarylibs_Centos7.6_x86_64.tar.gz openEuler 22.03 arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/binarylibs/gcc10.3/openGauss-third_party_binarylibs_openEuler_2203_arm.tar.gz openEuler 22.03 x86: https://opengauss.obs.cn-south-1.myhuaweicloud.com/latest/binarylibs/gcc10.3/openGauss-third_party_binarylibs_openEuler_2203_x86_64.tar.gz

社区提供了已编译好的centos7.6_x86_64, openeuler_aarch64, openeuler_x86_64 三种系统的二进制文件。从3.1.0版本开始，每个系统提供独立的二级制文件使用。各个系统分别需要下载对应的文件。对于其他系统，需要自行编译，可以按照下方的步骤执行：

安装依赖

使用下面的步骤来构建开源软件的二进制目录，用来编译openGauss数据库。
请确保在构建前，服务器已经安装了gcc gcc-c++
开始编译二进制前，还需要下面这些依赖，可以通过yum install进行安装。

libaio-devel
ncurses-devel
pam-devel
libffi-devel
python3-devel
libtool
libtool-devel 
libtool-ltdl
python-devel
openssl-devel
bison

编译gcc和cmake

编译gcc 三方库编译还需要依赖gcc10.3版本，如果是openEuler+ARM就用10.3.1版本，其他版本用10.3.0版本。

gcc10.3.0:

下载gcc-10.3.0.zip 或者 gcc-10.3.0.tar.gz，解压后进行编译安装。

gcc10.3.1:

通过git clone下载openEuler提供的gcc10.3.1的源码，并进行编译安装。
```
git clone https://gitee.com/openeuler/gcc.git
```
编译cmake 三方库编译依赖cmake(版本大于3.16.5)，cmake (https://cmake.org/download/#latest) 并解压后编译。

编译完成后，将gcc10.3和cmake导入到环境变量中（下一步的三方库编译依赖这两个），例如：

export CMAKEROOT=/usr/local/cmake3.18
export GCC_PATH=/opt/gcc/gcc10.3
export CC=$GCC_PATH/gcc/bin/gcc
export CXX=$GCC_PATH/gcc/bin/g++
export LD_LIBRARY_PATH=$GCC_PATH/gcc/lib64:$GCC_PATH/isl/lib:$GCC_PATH/mpc/lib/:$GCC_PATH/mpfr/lib/:$GCC_PATH/gmp/lib/:$CMAKEROOT/lib:$LD_LIBRARY_PATH
export PATH=$GCC_PATH/gcc/bin:$CMAKEROOT/bin:$PATH

编译三方库

进入到openGauss-third_party/build 目录下，执行sh build_all.sh，编译全量的三方组件。

build_all.sh中先编译了openssl，然后编译buildtools, platform, dependency 和 component，可以对这三个按顺序分别编译:

build tools

cd openGauss-third_party/build_tools
sh build_tools.sh

build platform

cd openGauss-third_party/platform/build/
sh build_platform.sh

build dependency

cd openGauss-third_party/dependency/build/
sh build_dependency.sh

build component

cd openGauss-third_party/component/build/
sh build_component.sh

openEuler系统编译Python3

由于openEuler系统上openssl版本与openGauss三方库中版本不一致导致的兼容性问题，在使用OM安装，建立互信时候会出现错误。在openEuler上编译三方库完成后还需要编译下Python3。操作如下：

cd openGauss-third_party/build_tools/python3
sh build.sh

编译完成

编译完成后，编译结果在openGauss-third_party/output目录下。
还需要在openGauss-third_party/output/buildtools/ 下，将编译好的gcc10.3拷贝到该目录下。
如：gcc10.3的路径为：output/buildtools/gcc10.3

以上步骤完成后，openGauss-third_party/output目录就是完整的三方库二进制。可以用来进行数据库编译。

Cross-罗 / openGauss-third_party