快速安装

本课程教学视频请参考 YMatrix 安装与部署

YMatrix 可以安装在 Redhat 7、CentOS 7、银河麒麟 V10 操作系统 + ARM 平台支持等操作系统上。本文档描述了在 单节点 上快速部署使用 YMatrix 的步骤。(如果宿主机无法连接外网,请参考离线集群部署)

安装前,请先下载 YMatrix 安装文件。

1 服务端安装

服务端安装过程包括安装准备和数据库部署共两个环节,后续也讲述了可选的安装后设置和基本的数据库管理命令。

1.1 安装准备

1.1.1 复制 RPM 包

将 RPM 包从本地复制到远程服务器。

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

1.1.2 安装依赖

注意!
此步骤开始,以下所有操作需要在 root 用户下或使用 sudo 权限执行。

YMatrix 需要 Python 3.6,请使用下列命令安装并将 Python 3.6 设为默认版本:

$ sudo yum install centos-release-scl
$ sudo yum install rh-python36
$ sudo scl enable rh-python36 bash

1.1.3 修改机器配置

关闭防火墙:

$ sudo systemctl stop firewalld.service
$ sudo systemctl disable firewalld.service

关闭 SELinux, 编辑 /etc/selinux/config,将 SELINUX 的值设为 disabled:

$ sudo sed s/^SELINUX=.*$/SELINUX=disabled/ -i /etc/selinux/config
$ sudo setenforce 0

确保安装节点上有持久不变的主机名,如果不存在,请用下述命令设置主机名,示例中设置为 mdw:

$ sudo hostnamectl set-hostname mdw

修改 /etc/hosts 文件:

$ sudo vim /etc/hosts

将主机名映射为一个本地网卡地址,修改完成后点击 ESC 键,输入 :wq 保存退出

192.168.100.10 mdw

1.2 数据库 RPM 安装

使用 root 用户或 sudo 权限执行下述 yum 命令安装数据库 RPM 包时,系统依赖库会一并自动安装。缺省会安装在 /usr/local/matrixdb 目录下:

$ sudo yum install matrixdb-5.0.0.beta.2+community-1.el7.x86_64.rpm

注意!
在实际安装过程中,请将文件名替换成最新下载的 RPM 包名。

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

$ vim /etc/matrixdb/defaults.conf

添加以下内容,端口号按需修改。

MasterPortBase = 5438
StandbyPortBase = 5439
PrimaryPortBase = 6500
MirrorPortBase = 7500

1.3 安装 Python 依赖包

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

$ source /usr/local/matrixdb/greenplum_path.sh
$ sudo yum install gcc python3-devel
$ sudo pip3 install --upgrade setuptools
$ sudo pip3 install argparse psutil pygresql pyyaml 

1.4 数据库部署

1.4.1 图形化部署

YMatrix 提供了简洁易用的数据库部署方式,包括图形化部署和命令行部署,推荐使用图形化部署。远程图形化部署需要服务器 8240 和 4617 端口可以访问。图形化 UI 服务由 mxui 进程提供。

使用浏览器访问以下图形化安装向导 URL,IP 为 1.1 步骤中所述服务器 IP:

http://<IP>:8240/

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

第二个页面自动选择“在本机初始化一个单节点数据库”,请直接点击下一步: 选择初始化一个单节点数据库


接下来开始单机部署的五步操作。

第一步,自动收集系统信息,请核对系统内核数和内存大小无误后,点击下一步: 收集系统信息


第二步,选择数据库目录存储路径和 Segment 数量。系统自动推荐空间最大的磁盘和与系统资源相匹配的 Segment 数目,可根据具体使用场景调整,确认后点击下一步: 设置磁盘和 Segment 数目


第三步,设置密码。YMatrix 会建立 mxadmin 数据库管理员账户,并作为超级账户。在这个环节设置 mxadmin 账户的密码,然后点击“下一步”(此处设置的是数据库账户的密码,而非操作系统账户的密码)。另外,还有一个选项是“允许远程连接至数据库”,默认勾选: 设置密码


第四步,开始部署数据库。页面会显示后台操作的任务,包括系统设置、创建用户和目录、初始化数据库、启动数据库以及清理和优化。点击“执行部署”后,开始部署操作并实时显示任务完成进展: 执行部署 部署进度


第五步,完成。部署操作完成后,可以点击“完成”按钮,显示测试连接和一些后续可选配置,包括允许远程连接、安装图形化客户端等。点击测试连接,会自动测试是否可以成功连接。 部署完成

1.4.2 命令行部署

YMatrix 也提供了命令行一键单机部署,命令如下,执行完成后数据库自动启动可立即使用:

source /usr/local/matrixdb/greenplum_path.sh
sudo env "PATH=$PATH" mxsetup

完成部署后,会自动启动 Cylinder 进程,此进程会在指定时间自动触发函数执行某些定时任务。

1.5 安装后设置(可选)

SSH登陆到服务器,切换到 YMatrix 管理员用户mxadmin:

sudo su - mxadmin

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

host  all       all   0.0.0.0/0  md5

为方便远程连接同时也测试数据库是否初始化正常,请执行下列命令为数据库管理员用户 mxadmin 设置密码(请用您的密码替换 mxpass):

psql -c "alter role mxadmin with password 'mxpass'" -h localhost -p 5432 mxdb

完成这些修改后,需要执行下述命令让数据库重新加载 pg_hba.conf 的新设置:

gpstop -u

1.6 数据库管理(可选)

SSH 登陆到服务器,切换到 YMatrix 管理员用户 mxadmin:

sudo su - mxadmin

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

gpstart -a
gpstop -af
gpstop -arf
gpstate      # YMatrix 4 数据库老架构适用。YMatrix 5 也可部署老架构集群


#or

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

1.7 附录

YMatrix 可以在低配设备上安装,如果在 2G 以下内存设备上安装,在安装前可按照下述命令增加 swap,确保设备有不小于 2G 的 swap 空间。

创建和启用一个 2G 的 SWAP 区:

sudo dd if=/dev/zero of=/opt/swapfile count=2048 bs=1MiB
sudo chmod 600 /opt/swapfile

sudo mkswap /opt/swapfile
sudo swapon /opt/swapfile

swapon -s
free -m

编辑 /etc/fstab 添加如下一行,以持久化该 swap 区:

/opt/swapfile   swap    swap    sw  0   0

2 客户端安装

YMatrix 兼容 PostgreSQL 12 协议,支持 PostgreSQL 12 的许多商业和开源客户端工具都可以和YMatrix 搭配使用,方便您从笔记本等个人电脑远程访问 YMatrix。

以开源 DBeaver 为例,在https://dbeaver.io/download/选择下载您对应的操作系统安装包。安装后,在连接 YMatrix 数据库时,选择 PostgreSQL 作为数据库类型, DBeaver 会自动检测您的系统中是否有正确的 JDBC 驱动,或提示下载。

选择PostgreSQL

YMatrix 的命令行工具 psql 也可以在 Windows 或者 Mac 系统远程使用。Mac 用户可以直接使用 brew 安装:

brew install libpq
brew link --force libpq ail

Windows 用户请从这里下载安装:https://www.postgresql.org/download/windows/

psql 安装后,可以通过 -h 指定主机名、-p 指定端口连接 YMatrix 服务器。psql 的其他常用参数如下:

psql -h [主机名或者IP] -p [端口] -U [用户名] -W -d [数据库名]

例如:

psql -h 127.0.0.1 -p 5432 -U mxadmin -W -d mxdb