一、搭建准备
openGauss开发需要使用linux环境,先下载远程连接工具Xshell/MobaXterm
1. 使用工具连接远程linux服务器,使用root账号远程登录,创建个人账号。
useradd -d home/xxx -m xxx
2. 设置密码
passwd xxx
3. 切换到个人账号,以后连接也使用个人账号进行登录。
su - xxx
二、编译openGauss-server
编译openGauss-server需要用到openGauss-server源码和其依赖的第三方软件仓库openGauss-third_party.
在根目录/data/下创建一个自己名字命名的文件夹作为工作目录,进入文件夹,拉取openGauss-server最新源码,建议先fork到自己的gitee仓库,再进行代码拉取,方便后续社区开发代码合入流程,修改代码,提交PR.
mkdir xxx
cd xxx
git clone https://gitee.com/opengauss/openGauss-server.git
openGauss的编译,需要提前把所依赖的开源第三方软件进行编译和构建。
第三方软件工具两种获取方式
1. 源码编译
这些开源的第三方软件存放在仓库openGauss-third_party中,用户拉取代码后可进行编译,通常只用编译一次。若开源软件版本更新,则需要重新构建。
git clone https://gitee.com/opengauss/openGauss-third_party.git
cd openGauss-third_party/build
sh build_all.sh
2.直接使用编译构建好的文件
由于开源软件编译构建耗时较长,社区提供了三个平台编译好的二进制文件给用户下载
openEuler_arm: https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs/openGauss-third_party_binarylibs_openEuler_arm.tar.gz
openEuler_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_arm版本的压缩包,使用Xftp工具传输到工作目录,再进行解压,重命名为固定的命名
tar -zxvf openGauss-third_party_binarylibs_openEuler_arm.tar.gz
mv openGauss-third_party_binarylibs_openEuler_arm binarylibs
源码准备好之后就可以进行代码编译了
两种编译方式
1. 一键脚本编译
使用内置脚本进行编译
cd openGauss-server
sh build.sh -m release -3rd data/meicheng/opengauss_src/install/binarylibs
#debug版将release换成debug
执行过程会持续5-10分钟无反应,自动输出log,最终显示如下内容,表示编译成功
make compile successfully!
导入环境变量,用于后续进行初始化和启动数据库
export CODE_BASE=_________ #openGauss-server的路径
export GAUSSHOME=$CODE_BASE/mppdb_temp_install/
export LD_LIBRARY_PATH=$GAUSSSHOME/lib:$LD_LIBRARY_PATH
export PATH=$GAUSSHOME/bin:$PATH
2. 手动编译
cd openGauss-server
配置的环境变量与一键脚本编译的环境变量略有不同
export CODE_BASE=_________ #openGauss-server的路径
export BINARYLIBS=_________ #binarylibs的路径
export GAUSSHOME=$CODE_BASE/dest/
export GCC_PATH=$BINARYLIBS/buildtools/gcc7.3/
export CC=$GCC_PATH/gcc/bin/gcc
export CXX=$GCC_PATH/gcc/bin/g++
export LD_LIBRARY_PATH=$GAUSSSHOME/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
选择版本进行configure
可选择三种目标版本
release:代表生成release版本的二进制程序,该版本编译时,配置GCC高级别优化选项,去除内核调试代码,通常用于生产环境或性能测试环境。
debug:代表生成debug版本的二进制程序,该版本编译时,增加内核代码调试功能,通常用于开发自测环境。
memcheck:代表生成memcheck版本的二进制程序,该版本编译时,实质上是在debug版本的基础上增加了ASAN功能,此版本通常用于定位内存问题。
debug版:
./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
release版:
./configure --gcc-version=7.3.0 CC=g++ CFLAGS='-O2
-g3' --prefix=$GAUSSHOME --3rd=$BINARYLIBS
--enable-cassert --enable-thread-safety
--with-readline --without-zlib
memcheck版:
./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
开始编译
make -sj4
make install -sj4
-s表示silent模式,有些编译信息不会打印出来
如果使用-j参数,make执行的时候会一直增加并发数,有时会遇到‘cannot allicate memory’的错。一般-j参数后可指定数字为cpu数X2。如编译环境是4CPU,可使用make -j8的参数进行编译
显示如下内容表示编译成功
openGauss InstallationGuide complete
三、openGauss-OM编译
openGauss-OM是运维管理模块(OperationManager),提供openGauss日常维护、配置管理的管理接口和工具。
源码编译完openGauss-server代码仓之后,并没有gs_om。需要单独编译openGauss-OM,并将编译好的openGauss-xxx-om.tar.gz的包拷贝到openGauss-server安装包所在的目录,再按照企业版的方式进行安装。
操作步骤
1. 下载代码仓
git clone https://gitee.com/opengauss/openGauss-OM.git
2. 执行编译
ocd openGauss-OM
chmod +x build.sh
export BINARYLIBS=/data/XXX/binarylibs #这里写你的第三方软件包的文件目录
./build.sh -3rd $BINARYLIBS
显示以下内容,表示gauss-OM编译成功
ROOT_DIR:XXXXX
Everything is ready.
success!
进入package目录,将编译好的openGauss-xxx-om.tar.gz的包拷贝到openGauss-server安装包所在的目录,再按照企业版的方式进行安装。
四、产品安装包编译
本步骤是制作openGauss软件安装包,安装包的编译打包过程也集成在build.sh中。
操作步骤
1. 进入openGauss-server目录
2. 执行命令编译出安装包,
osh build.sh -m [debug | release | memcheck] -3rd [binarylibs path] -pkg
3. 显示如下内容表示安装包编译完成
make server(all) package success!
4. 打包好的安装包存放在./output目录下
五、编译后验证
编译结束后,可按以下方式对编译后的openGauss进行验证
1. 建立数据目录和日志目录
mkdir ~/data
mkdir ~/log
2. 数据库初始化
gs_initdb -D ~/data --nodename=db1
3. 启动数据库服务器
gs_ctl start -D ~/data -Z single_node -l ~/log/opengauss.log
4. 进入数据库服务器
数据库安装完成后默认生成名称为postgres的数据库,可以连接到此数据库进行测试。
gsql -d postgres
连接成功后,会显示类似如下信息
gsql(一些版本时间信息)
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help
openGauss=#
5. 使用openGauss
5.1 创建数据库用户
CREATE USER XXX WITH PASSWORD "xxxxxxx";
5.2 设置用户为系统管理员
GRANT ALL PRIVILEGES TO xxx;
5.3 创建数据库
CREATE DATABASE db_tpcc OWNER XXX;
5.4 db_tpcc数据库创建完以后,就可以按如下方法退出postgres数据库,使用新用户连接到db_tpcc数据库执行创建表等操作。
q #退出当前数据库
gsql -d db_tpcc -U XXX #连接数据库db_tpcc
5.5 创建SCHEMA
CREATE SCHEMA test AUTHORIZATION XXX;
5.6 创建表
CREATE TABLE mytable (name varchar(16), age int);
5.7 向表中插入数据
INSERT INTO mytable values("XXX", 18);
5.8 查看表中数据
SELECT * FROM mytable;
◆ 往期推荐◆
解析 openGauss 的 AutoVacuum 机制及优化策略