快速安装

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

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

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

操作系统及平台支持

企业特性	操作系统	CPU 架构
否	CentOS 7 Red Hat Enterprise Linux 7	x86_64： ࠾ 海光 ࠾ 兆芯开胜® KH-40000 系列 ࠾ 兆芯开胜® KH-20000 系列 ࠾ 兆芯开胜® ZX-C+FC-1080/1081 系列 ࠾ 兆芯开先® KX-5000 系列 ࠾ 兆芯开先® ZX-C+ 系列 AArch64： ࠾ 飞腾 FT-1500A ࠾ 飞腾 FT-2000 ࠾ 飞腾 FT-2000+ ࠾ 鲲鹏 Kunpeng 920
是	麒麟信安 V3.3 中标麒麟 V7
否	CentOS 8 - 8.5 Red Hat Enterprise Linux 8
是	龙蜥（Anolis）OS 8 统信（UOS） V20（1060a）
否	Ubuntu 20.04 LTS
是	银河麒麟 V10 银河麒麟 V10 SP1 银河麒麟 V10 SP2 银河麒麟 V10 SP3 OpenEuler 20.03 LTS OpenEuler 20.03 LTS SP1 OpenEuler 20.03 LTS SP2 OpenEuler 20.03 LTS SP3 超聚变（Fusion）OS 22 麒麟信安 V3.4 统信（UOS） V20（1060e）
是	OpenEuler 22.03 LTS OpenEuler 22.03 LTS SP1 超聚变（Fusion）OS 23 麒麟信安 V3.5

注意！
快速安装只适用于 CentOS 7、RedHat 7 等操作系统的安装。Ubuntu 20.04 部署步骤请点击这里；CentOS 8、RedHat 8 部署步骤请点击这里。

注意！
本课程教学视频请参考 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 文件，如果第一次使用 vim 工具，可使用 sudo yum install vim 命令安装：

$ sudo vim /etc/hosts

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

192.168.100.10 mdw

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

1.2 数据库 RPM 安装

使用 root 用户或 sudo 权限执行下述 yum 命令安装数据库 RPM 包时，系统依赖库会一并自动安装。缺省会安装在 /opt/ymatrix/matrixdb5 目录下：

$ sudo yum install matrixdb5-5.1.0+enterprise_5.1.0-1.el7.x86_64.rpm

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

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

$ vim /etc/matrixdb5/defaults.conf

1.3 数据库部署

1.3.1 图形化部署

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

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

http://<IP>:8240/

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

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

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

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

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

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

1.3.2 命令行部署

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

source /opt/ymatrix/matrixdb5/greenplum_path.sh
sudo env "PATH=$PATH" mxsetup

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

1.4 安装后设置（可选）

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.5 数据库管理（可选）

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

$ sudo su - mxadmin

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

$ mxstart -a
$ mxstop -af
$ mxstop -arf 
$ mxstate -s

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

2 最小化安装

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

3 客户端安装

YMatrix 兼容 PostgreSQL 12 协议，PostgreSQL 12 的许多商业和开源客户端工具（如 DBeaver、pgAdmin等）都可以和 YMatrix 搭配使用，你可以很方便地从笔记本等个人电脑远程访问 YMatrix。详见客户端接入。

选择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

祝你体验愉快！