Ubuntu 20.04 操作系统下部署集群

  • 操作系统及平台要求
操作系统 支持的 CPU 架构
Ubuntu 20.04 LTS x86_64
aarch64
  • 示例集群信息

此文档以三个节点为例,主节点为 mdw,两个数据节点分别为 sdw1 和 sdw2。

服务端安装

服务端安装过程包括查看服务器基本信息、安装准备、数据库 DEB 包安装、数据库部署和安装后设置共 5 个环节。

1 查看服务器基本信息

在进行安装操作前,先查看服务器基本信息。无疑,这是一个好习惯,了解一台服务器有助于你更好地规划部署集群。

步骤 命令 用途
1 free -h 查看操作系统内存信息
2 df -h 查看磁盘空间
3 lscpu 查看 CPU 数量
4 lsb_release -a 查看操作系统版本
5 uname -a 以如下次序输出所有内核信息(其中若 -p 和 -i 的探测结果不可知则被省略):内核名称;网络节点上的主机名;内核发行号;内核版本;主机的硬件架构名称;处理器类型(不可移植);硬件平台(不可移植);操作系统名称
6 tail -11 /proc/cpuinfo 查看 CPU 信息

2 安装准备

注意!
2 安装准备、3 数据库 DEB 包安装的命令均需在所有节点上进行。

2.1 更新软件列表

本文档默认你已在 /etc/apt/sources.list 配置文件中完成了软件列表的配置。接下来,你需要在 root 用户下或使用 root 权限更新软件列表。

# apt update

APT(Advanced Package Tool)即高级包工具,其主要功能与获取安装软件包相关,可以进行下载软件包,安装软件包,分析软件包依赖,更新软件列表等工作。

2.2 区域语言设置(Locale)

在 root 用户下或使用 sudo 权限进行区域语言设置。

# apt install -y locales && sudo locale-gen "en_US.UTF-8" && sudo update-locale LC_ALL="en_US.UTF-8"

2.3 修改机器配置

确保所有节点上有持久不变的主机名,如果不存在,请用下述命令设置主机名,例如,在主节点可以这样设置:

# hostnamectl set-hostname mdw

两个子节点也分别设置对应的主机名:

# hostnamectl set-hostname sdw1
# hostnamectl set-hostname sdw2

确保集群中所有节点都可以相互通过主机名、IP 访问。首先安装 vim 工具。

# apt install vim

/etc/hosts 添加记录,将主机名映射为一个本地网卡地址。例如,三个节点的 /etc/hosts 都包含类似这样的内容:

# vim /etc/hosts
192.168.100.10 mdw
192.168.100.11 sdw1
192.168.100.12 sdw2

输入完毕,按 esc 退出,再输入 :wq 保存即可。

2.4 从本地复制 DEB 包到服务器

注意!
DEB 包下载链接从官方邮件中获取即可。

从本地将即将安装的 DEB 包复制到所有节点。

~ scp <本地文件路径> <用户名>@<服务器 IP 地址>:<服务器文件路径>

3 安装 YMatrix DEB 包

注意!
你需要在所有服务器节点上,通过 root 用户或使用 sudo 权限执行下述 apt 命令安装数据库 DEB 包,系统依赖库会一并自动安装。

# apt install -y /path/to/matrixdb5_5.1.0+enterprise-1_amd64.deb

注意!
在实际安装过程中,请将文件名替换成最新下载的 DEB 包名,/path/to/ 替换为正确的路径,如果是当前路径则为 ./

安装成功后,会自动启动 supervisord、MXUI 进程。这些后台进程用于提供图形化操作界面及进程管理服务。 如果你有配置端口的需求,在安装完 DEB 包后修改 /etc/matrixdb5/defaults.conf 文件进行配置。此操作只在 Master 上进行即可。

# vim /etc/matrixdb5/defaults.conf

4 安装 Python 依赖以及设置默认 Python 版本

所有节点上,使用 root 用户或 sudo 权限执行下述命令安装 YMatrix 所依赖的 Python 包,请注意,source greenplum_path.sh 必须执行,以便可以安装正确版本的依赖包。

# apt install -y \
   gcc \
   python3-dev \
   python3-pip \
   python3-psutil \
   python3-pygresql \
   python3-testresources
# update-alternatives --install /usr/bin/python python /usr/bin/python3 50

5 数据库部署

这里仍然使用 YMatrix 提供的图形化部署。远程图形化部署通过 8240 和 4617 端口可以访问。安装完成后,所有节点的这些端口会默认打开。图形化界面服务由 MXUI 进程提供。

注意!
无法使用图形化界面部署 YMatrix,请参照命令行部署

使用浏览器访问以下图形化安装向导 URL,此处填写 IP 地址的服务器将成为你集群的 Master (此示例中为 mdw)

http://<IP>:8240/

安装向导的第一个页面,需要填写超级用户密码,使用 sudo more /etc/matrixdb5/auth.conf 命令查看即可。

第二个页面选择“多节点部署”,然后点击下一步。


接下来开始多机部署的四步操作。

第一步,添加节点,点击“添加节点”按钮。

文本框里输入 sdw1 和 sdw2 的 IP 地址或主机名或 FQDN,点击“确定”,点击“下一步”。


第二步,配置集群参数,“数据镜像”决定了集群数据节点是否包含备份镜像,在生产环境中建议启用,这样集群才是高可用的。系统自动推荐空间最大的磁盘和与系统资源相匹配的 segment 数目,可根据具体使用场景调整。配置好的集群结构可以通过示意图查看。确认后点击“下一步”。


第三步,设置存储路径。


第四步,执行部署,该步骤会列出来之前的操作的完成配置参数,确认无误后,点击“执行部署”。

随后系统会自动进行集群部署,并列出详细步骤和执行进度。所有的步骤都成功执行后,表示部署完毕。

完成部署。

6 安装后设置

6.1 配置 sysstat

所有节点上,修改 sysstat 文件,将 ENABLED="false" 改成 ENABLED="true",然后点按 esc 键,输入 :wq 保存退出。

# sudo vi /etc/default/sysstat

重启服务。

# sudo service sysstat restart

6.2 远程连接数据库

YMatrix 缺省安装支持远程连接,如果在安装过程中没有勾选“允许远程连接至数据库”,请手工修改 $MASTER_DATA_DIRECTORY/pg_hba.conf 文件添加类似这样一行,表示允许来自任何 IP 的访问所有数据库的用户通过密码认证连接,可以根据实际需要限定 IP 范围或者数据库名称以减少安全风险:

# host  all       all   0.0.0.0/0  md5

完成这些修改后,需要切换到 mxadmin 用户,并执行下述命令让数据库重新加载 pg_hba.conf 配置文件:

# su - mxadmin
$ mxstop -u    

5.3 使用数据库管理工具

YMatrix 的启动、停止、重启、状态查看可以通过下述命令分别完成:

命令 用途
mxstop -a 停止集群。(此模式下,如果有会话链接,关闭数据库会卡住)
mxstop -af 快速关闭集群
mxstop -arf 重启集群。等待当前正在执行的 SQL 语句结束(此模式下,如果有会话链接,关闭数据库会卡住)
mxstate -s 查看集群状态