准备软硬件安装环境
本章节描述安装前需要进行的环境准备。建议部署OpenTeleDB的各服务器具有等价的服务器配置。
硬件环境要求
表一硬件环境要求列出了OpenTeleDB服务器应具备的最低硬件要求,在实际产品中,硬件配置的规划需考虑数据规模及所期望的数据库响应速度。请根据实际情况进行规划。
表一:硬件环境要求
|
项目 |
配置描述 |
|
内存 |
功能调试建议8GB以上。 性能调试或商业部署建议16GB以上。 复杂的查询对内存的需求量比较高,在高并发场景下,可能出现内存不足。此时建议使用大内存的机器,或使用负载管理限制系统的并发。 |
|
CPU |
功能调试最小1*8核2.0GHz。 性能调试和商业部署建议1*16GHz。 说明: 个人开发者最低配置2核4G, 推荐配置4核8G。 |
|
硬盘 |
用于安装TeleDB的硬盘需满足如下要求: 建议至少10GB硬盘空间,具体需求取决于数据库的大小和增长预期。 |
软件环境要求
表2:软件环境要求
|
软件类型 |
配置描述 |
|
Linux操作系统 |
Linux 各主流发行版(CentOS, RedHat, Ubuntu, Debian)等 |
软件依赖要求
表3:软件依赖要求
|
所属软件 |
建议版本 |
|
gcc |
4.8 及以上 |
|
gcc-c++ |
4.8 及以上 |
|
make |
3.82 及以上 |
|
bison |
3.0 及以上 |
|
flex |
2.5.31 及以上 |
|
readline-devel |
6.0 及以上 |
|
zstd-devel |
1.4.0 及以上 |
|
lz4-devel |
1.8.0 及以上 |
|
openssl-devel |
1.1.1 及以上 |
安装软件包
获取安装包
您可参考如下步骤获取安装包。
操作步骤
- 从OpenTeleDB开源社区下载对应平台的安装包。
- 登录OpenTeleDB开源社区,选择对应平台最新安装包下载。
- 单击下载。
- 解压安装包。
- 执行如下命令解压安装包,检查安装目录及文件是否齐全。
- tar -zxvf xxxx.tar.gz
- 或者使用git clone拉取源代码。进入解压目录,解压安装包。
- 安装相关依赖
- 根据自己需要的增加依赖。以下列举部分依赖。
- yum install -y curl-devel libicu-devel pam-devel krb5-devel openldap-devel systemd-devel readline readline-devel zlib zlib-devel gettext gettext-devel openssl openssl-devel pam pam-devel libxml2 libxml2-devel libxslt libxslt-devel perl perl-devel tcl-devel uuid-devel gcc gcc-c++ make flex bison perl-ExtUtils* libcurl-devel asciidoc xmlto opensp mariadb-devel libtool libuuid-devel gflags-devel lcov libyaml-devel boost boost-devel libgsasl-devel cmake3 golang
- 编译安装
- 编译选项与PostgreSQL差别在于OpenTeleDB多了--with-xstore编译参数,加上此编译参数则会编译xstore模块代码。编译xraft编译选项需要:--with-zstd --with-lz4 --with-xraft --with-openssl。
- export codes_dir= 路径 #源码目录路径
- export pg_install_dir= 路径 #OpenTeleDB安装路径
- ./configure --prefix=${pg_install_dir} --with-libxml --with-uuid=ossp --with-openssl --with-xstore #在解压出来的源码目录下执行,配置编译选项
- make && make install
- 按需安装contrib插件工具
- 以xstore工具举例:
- cd ${codes_dir}/contrib/xstore
- make && make install
初始化数据库和启动
1. 数据库初始化,修改数据库配置文件。
${pg_install_dir}/bin/initdb -D ${pg_data_dir}
echo "shared_preload_libraries = 'xstore.so'" >> ${pg_data_dir}/postgresql.conf #使用xstore功能需要配置此项
echo "shared_preload_libraries = 'xraft.so'" >> ${pg_data_dir}/postgresql.conf #使用xraft功能需要配置此项
2. 启动数据库
export pg_data_dir=${pg_install_dir}/data
${pg_install_dir}/bin/pg_ctl -D ${pg_data_dir} start
显示server started则为启动成功。