快速安装
本文档描述了在 单节点 上快速部署使用 MatrixDB 的步骤。
注意！
如需部署多节点集群，请点击MatrixDB 4集群部署，MatrixDB 4集群部署（离线）。
MatrixDB 支持 Redhat、CentOS、Ubuntu、中标麒麟、银河麒麟等多个操作系统。清单如下：
- 操作系统及平台要求
| 操作系统 | 支持的 CPU 架构 |
|---|---|
| CentOS 7 | x86_64 |
| CentOS 8 | x86_64 |
| Red Hat 7 | x86_64 |
| Ubuntu 20.04 | x86_64 |
| 中标麒麟 V7 | x86_64 |
| 中标麒麟 V7 | ARM 64 |
| 银河麒麟 V10 | ARM 64 |
| 银河麒麟 V10 | 飞腾版 |
| 银河麒麟 V10 | 鲲鹏版 |
注意！
本课程教学视频请参考MatrixDB 安装与部署，如果宿主机无法连接外网，请参考MatrixDB 4离线集群部署。
安装前，请先下载 MatrixDB安装文件。
1 服务端安装
服务端安装过程包括安装准备和数据库部署共两个环节，后续也讲述了可选的安装后设置和基本的数据库管理命令。
1.1 安装准备
所有准备操作需要在 root 用户下执行。
1.1.1 复制 RPM 包
将 RPM 包从本地复制到远程服务器。
~ scp <本地路径> <用户名>@<服务器 IP 地址>: <服务器路径>1.1.2 安装依赖
注意！
此步骤开始，以下所有操作需要在 root 用户下或使用 sudo 权限执行。
MatrixDB 需要 Python 3.6，请使用下列命令安装并将 Python 3.6 设为默认版本：
$ sudo yum install centos-release-scl
$ sudo yum install rh-python36
$ sudo scl enable rh-python36 bash1.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-4.8.0.enterprise-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 = 75001.3 安装 Python 依赖包
使用 root 用户执行下述命令安装 MatrixDB 所依赖的 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 图形化部署
MatrixDB 提供了简洁易用的数据库部署方式，包括图形化部署和命令行部署，推荐使用图形化部署。远程图形化部署需要服务器 8240 和 4617 端口可以访问。图形化界面服务由 MXUI 进程提供。
使用浏览器访问以下图形化安装向导 URL，IP 为 Master 服务器 IP：
http://<IP>:8240/安装向导的第一个页面，需要填写超级用户密码，使用 sudo more /etc/matrixdb/auth.conf 命令查看即可：
第二个页面自动选择“在本机初始化一个单节点数据库”，请直接点击下一步：
接下来开始单机部署的五步操作。
第一步，自动收集系统信息，请核对系统内核数和内存大小无误后，点击下一步：
第二步，选择数据库目录存储路径和数据节点（Segment）数量。系统自动推荐空间最大的磁盘和与系统资源相匹配的 Segment 数目，可根据具体使用场景调整，确认后点击下一步：
第三步，设置密码。MatrixDB 会建立 mxadmin 数据库管理员账户，并作为超级账户。在这个环节设置mxadmin账户的密码，然后点击“下一步”（此处设置的是数据库账户的密码，而非操作系统账户的密码）。另外，还有一个选项是“允许远程连接至数据库”，默认勾选：
第四步，开始部署数据库。页面会显示后台操作的任务，包括系统设置、创建用户和目录、初始化数据库、启动数据库以及清理和优化。点击“执行部署”后，开始部署操作并实时显示任务完成进展：
第五步，完成。部署操作完成后，可以点击“完成”按钮，显示测试连接和一些后续可选配置，包括允许远程连接、安装图形化客户端等。点击测试连接，会自动测试是否可以成功连接。
1.4.2 命令行部署
MatrixDB 也提供了命令行一键单机部署，命令如下，执行完成后数据库自动启动可立即使用：
source /usr/local/matrixdb/greenplum_path.sh
sudo env "PATH=$PATH" mxsetup1.5 安装后设置（可选）
SSH 登陆到服务器，切换到 MatrixDB 管理员用户 mxadmin：
$ sudo su - mxadminMatrixDB缺省安装支持远程连接，如果在安装过程中没有勾选“允许远程连接至数据库”，请手工修改 $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 -u1.6 数据库管理（可选）
SSH 登陆到服务器，切换到 MatrixDB 管理员用户 mxadmin：
$ sudo su - mxadminMatrixDB 的启动、停止、重启、状态查看可以通过下述命令分别完成，更多命令参数可以通过 --help 查看参数详解：
$ gpstart -a
$ gpstop -af
$ gpstop -arf
$ gpstate1.7 附录：最小化安装
MatrixDB 可以在低配设备上安装，具体如下：
| 最低配置 |
|---|
| 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 02 客户端安装
MatrixDB 兼容 PostgreSQL 12 协议，PostgreSQL 12 的许多商业和开源客户端工具都可以和 MatrixDB 搭配使用，你可以很方便地从笔记本等个人电脑远程访问 MatrixDB。
以开源工具 DBeaver 为例，在https://dbeaver.io/download/选择下载对应的操作系统安装包。安装后，在连接 MatrixDB 数据库时，选择 PostgreSQL 作为数据库类型，DBeaver 会自动检测你的系统中是否有正确的 JDBC 驱动，或提示下载。
MatrixD B的命令行工具 psql 也可以在 Windows 或者 Mac 系统远程使用。Mac 用户可以直接使用 brew 安装：
$ brew install libpq
$ brew link --force libpq ailWindows 用户请从这里下载安装：https://www.postgresql.org/download/windows/
psql 安装后，可以通过 -h 指定主机名、-p 指定端口连接 MatrixDB 服务器。psql 的其他常用参数如下：
$ psql -h [主机名或者IP] -p [端口] -U [用户名] -W -d [数据库名]例如：
$ psql -h 127.0.0.1 -p 5432 -U mxadmin -W -d mxdb