快速安装

本文档描述了在 单节点 上快速部署使用 YMatrix 的步骤。

注意！
如需部署多节点集群，请点击在线集群部署，离线集群部署。

YMatrix Redhat、CentOS、中标麒麟、银河麒麟等多个操作系统。清单如下：

操作系统及平台要求

操作系统	支持的 CPU 架构
CentOS 7	x86_64
CentOS 8	x86_64
Red Hat 7	x86_64
中标麒麟 V7	x86_64
中标麒麟 V7	ARM 64
银河麒麟 V10	ARM 64
银河麒麟 V10	飞腾版
银河麒麟 V10	鲲鹏版

注意！
本课程教学视频请参考 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

注意！
请勿在 /etc/hosts 中重复添加上述 <IP 地址> <主机名> 条目，否则在图形化界面初始化时会出现“主机间网络连接测试失败“报错。

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 用户执行下述命令安装 YMatrix 所依赖的 Python 包，请注意，source greenplum_path.sh 必须执行，以便可以安装正确版本的依赖包：

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

1.4 数据库部署

1.4.1 图形化部署

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

使用浏览器访问以下图形化安装向导 URL，IP 为 Master 服务器 IP：

http://<IP>:8240/

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

第二个页面自动选择“单节点部署”，请直接点击下一步：

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

第一步，设置实例数目、存储路径和管理员密码，确认后点击一键部署。

第二步，开始部署数据库。页面实时显示任务完成进展。

第三步，完成。部署成功后，可以点击“完成”按钮。

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 的新设置：

$ mxstop -u

1.6 数据库管理（可选）

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

$ sudo su - mxadmin

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

$ mxstart -a
$ mxstop -af
$ mxstop -arf 
$ mxstate -s   # YMatrix 5 开始的数据库新架构适用

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

1.7 附录：最小化安装

YMatrix 可以在低配设备上安装，具体如下：

最低配置
1GHZ 双核处理器
2GB 内存
2GB 磁盘空间
RAID 1（镜像）

如果在 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

祝你体验愉快！