GreatSQL用户手册

§ Ansible安装

本次介绍如何利用ansible快速安装GreatSQL并构建包含仲裁节点的MGR集群。

§ 1. 安装准备

§ 1.1 安装ansible

首先利用dnf/yum安装ansible：

$ yum install -y ansible
1

§ 1.2 配置ansible

修改 /etc/ansible/hosts 文件，把要安装GreatSQL的服务器IP加进去，例如：

[greatsql_dbs:children]
greatsql_mgr_primary
greatsql_mgr_secondary
greatsql_mgr_arbitrator

[greatsql_mgr_primary]
172.16.16.10
[greatsql_mgr_secondary]
172.16.16.11
[greatsql_mgr_arbitrator]
172.16.16.12
1
2
3
4
5
6
7
8
9
10
11

上面这个主机列表，分为两个组，一个是选择作为MGR PRIMARY节点（或在多主模式中第一个需要初始化引导的节点）的组 greatsql_mgr_primary，只有一个主机。另一组选择作为SECONDARY节点 greatsql_mgr_secondary，有两个主机。两个组也可以合并一起，成为一个新的组 greatsql_dbs。

提醒

  1. 请填内网IP地址，因为MGR初始化时，默认使用用内网IP地址。
  2. 如果同时还要安装到本机，也请填写内网IP地址。
  3. 如果是要采用多主模式，在上面的配置中，把第一个需要初始化引导的节点放在 greatsql_mgr_primary 组里，其他节点照常放在 greatsql_mgr_secondary 组里。

§ 1.3 建立ssh信任

为了简单起见，直接建立ssh信任，方便ansible一键安装。

首先生成ssh key

$ ssh-keygen
1

使用缺省值，提示输入passphrase时，敲回车使用空的passphrase。

将ssh key复制到目标服务器上：

$ ssh-copy-id root@172.16.16.10
1

按提示输入口令，完成后测试使用ssh登录不再提示输入口令。如果是在本机安装，那么ssh-copy-id也要对本机执行一遍。或者手动将ssh key复制到远程主机上，写到 ~/.ssh/authorized_keys 文件中（注意不要折行、断行）。

§ 1.4 测试ansible

随意执行一个指令，测试ansibile可连接远程主机：

$ ansible greatsql_dbs -a "uptime"
172.16.16.10 | CHANGED | rc=0 >>
 15:29:46 up 250 days, 19:40,  2 users,  load average: 0.04, 0.08, 0.07
172.16.16.11 | CHANGED | rc=0 >>
 15:29:46 up 303 days, 17:57,  3 users,  load average: 0.10, 0.13, 0.13
172.16.16.12 | CHANGED | rc=0 >>
 15:29:47 up 194 days, 18:08,  2 users,  load average: 0.07, 0.13, 0.10
1
2
3
4
5
6
7

这就表示可以正常运行了。

§ 1.5 下载GreatSQL-Ansible安装包

打开GreatSQL-Ansible项目主页：https://gitee.com/GreatSQL/GreatSQL-Ansible (opens new window)

找到页面右侧“发行版”，进入，选择 " GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal-ansible.tar.xz " 这个二进制包下载到服务器上：

$ cd /opt/greatsql/; wget -c "https://gitee.com/xxx/GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal-ansible.tar.xz"

$ tar -Jxvf GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal-ansible.tar.xz
1
2
3

解压缩后，能看到除了 GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal.tar.xz 安装包之外，还有GreatSQL-ansible一键安装相关文件：

$ cd /opt/greatsql/GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal-ansible
$ ls -la
-rw-r--r-- 1 root root      333 Aug  8 11:04 check_mysql.yml
-rw-r--r-- 1 root root 46324036 Aug  8 11:09 GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal.tar.xz
-rw-r--r-- 1 root root     8920 Aug  8 12:41 greatsql.yml
drwxr-xr-x 3 root root      103 Aug  8 11:07 mysql-support-files
-rw-r--r-- 1 root root      869 Aug  8 11:04 README.en.md
-rw-r--r-- 1 root root      795 Aug  8 11:04 README.md
-rw-r--r-- 1 root root      413 Aug  8 14:03 vars.yml
1
2
3
4
5
6
7
8
9

几个文件作用分别介绍下：

  • GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal.tar.xz，GreatSQL二进制minimal安装包。
  • greatsql.yml，ansible一键安装脚本。
  • check_mysql.yml，MySQL进程、端口预检查脚本。
  • vars.yml，定义一些变量的脚本，里面的变量名有些需要修改以适应各自不同的安装环境。

§ 2. 安装GreatSQL并构建MGR集群

§ 2.1 配置Ansible安装剧本

在开始安装前，要先修改 vars.yml 这个Ansbile安装剧本中的几个配置选项：

work_dir: /opt/greatsql/GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal-ansible
extract_dir: /usr/local
data_dir: /data/GreatSQL
file_name: GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal.tar.xz
base_dir: /usr/local/GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal
my_cnf: /etc/my.cnf
mysql_user: mysql
mysql_port: 3306
mgr_user: GreatSQL
mgr_user_pwd: GreatSQL@2023
mgr_seeds: '172.16.16.10:33061,172.16.16.11:33061,172.16.16.12:33061'
mgr_single_mode: 1
wait_for_start: 60
1
2
3
4
5
6
7
8
9
10
11
12
13

下面是关于这些参数的解释

参数名 默认值 用途
work_dir /opt/greatsql 工作目录，将下载的安装包放在本目录，可根据需要自行调整
extract_dir /usr/local GreatSQL二进制包解压缩后放在 /usr/local下，【不建议调整】
data_dir /data/GreatSQL GreatSQL运行时的datadir，【不建议调整】
file_name GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal.tar.xz GreatSQL二进制包文件名，【不建议调整】
base_dir /usr/local/GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal GreatSQL的basedir，【不建议调整】
my_cnf /etc/my.cnf my.cnf配置文件路径，【不建议调整】
mysql_user mysql 运行GreatSQL对应的user、group，【不建议调整】
mysql_port 3306 GreatSQL运行时的监听端口，【不建议调整】
mgr_user repl MGR账户
mgr_user_pwd repl4MGR MGR账户密码
mgr_seeds 172.16.16.10:33061,172.16.16.11:33061,172.16.16.12:33061 定义MGR运行时各节点的IP+端口列表，【需要自行调整】
mgr_single_mode 是否采用单主模式；0表示否，也就是采用多主模式；1表示是，也就是采用单主模式；默认值：1（即默认采用单主模式）
wait_for_start 60 初次启动时，要先进行一系列数据文件初始化等工作，后面的MGR初始化工作要等待前面的先完成，如果第一安装失败，可以将这个时间加长

提醒：

  1. 除了修改work_dir和mgr_seeds参数外，其他的都请谨慎修改，否则可能会提示找不到文件目录等错误。
  2. 如果是要采用多主模式，在/etc/ansible/hosts 文件中，把第一个需要初始化引导的节点放在 greatsql_mgr_primary 组里，其他节点照常放在 greatsql_mgr_secondary 组里。

§ 2.2 开始ansible安装

执行下面的命令一键完成GreatSQL的安装、初始化，加入systemd服务、以及MGR初始化等所有工作：

$ cd /opt/greatsql/GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal-ansible
$ ls -la
-rw-r--r-- 1 root root      333 Aug  8 11:04 check_mysql.yml
-rw-r--r-- 1 root root 46324036 Aug  8 11:09 GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal.tar.xz
-rw-r--r-- 1 root root     8920 Aug  8 12:41 greatsql.yml
drwxr-xr-x 3 root root      103 Aug  8 11:07 mysql-support-files
-rw-r--r-- 1 root root      869 Aug  8 11:04 README.en.md
-rw-r--r-- 1 root root      795 Aug  8 11:04 README.md -rw-r--r-- 1 root root      413 Aug  8 14:03 vars.yml

$ ansible-playbook ./greatsql.yml
1
2
3
4
5
6
7
8
9
10

§ 2.3 检查ansible执行过程输出

安装时会先行检查是否已有mysqld进程在运行，或者3306端口上是否已有其他服务，如果是的话，则输出内容可能会是这样的：

PLAY [install GreatSQL] *****************************************************************************************************************************

TASK [Gathering Facts] ******************************************************************************************************************************
ok: [172.16.16.10]
ok: [172.16.16.11]
ok: [172.16.16.12]

TASK [check mysql port] *****************************************************************************************************************************
changed: [172.16.16.10]
changed: [172.16.16.11]
changed: [172.16.16.12]

TASK [check mysql processor] ************************************************************************************************************************
changed: [172.16.16.10]
changed: [172.16.16.11]
changed: [172.16.16.12]

TASK [modify selinux config file] *******************************************************************************************************************
skipping: [172.16.16.10]
skipping: [172.16.16.11]
skipping: [172.16.16.12]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

看到有 skipping 以及 skipped=N 字样。而如果是正常安装，则会输出类似下面的内容：

PLAY [install GreatSQL] *****************************************************************************************************************************

TASK [Gathering Facts] ******************************************************************************************************************************
ok: [172.16.16.10]
ok: [172.16.16.11]
ok: [172.16.16.12]

TASK [check mysql port] *****************************************************************************************************************************
changed: [172.16.16.10]
changed: [172.16.16.11]
changed: [172.16.16.12]
...
PLAY RECAP ******************************************************************************************************************************************
172.16.16.10               : ok=31   changed=20   unreachable=0    failed=0    skipped=0    rescued=0    ignored=2
172.16.16.11               : ok=31   changed=20   unreachable=0    failed=0    skipped=0    rescued=0    ignored=2
172.16.16.12               : ok=31   changed=20   unreachable=0    failed=0    skipped=0    rescued=0    ignored=2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

有 ok 以及 skipped=0 字样，这就表示都被正常被执行了，此时应该已经安装成功了，检查一下：

$ systemctl status greatsql
● greatsql.service - GreatSQL Server
   Loaded: loaded (/usr/lib/systemd/system/greatsql.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2023-08-08 12:26:08 CST; 1h 58min ago
     Docs: man:mysqld(8)
           http://dev.mysql.com/doc/refman/en/using-systemd.html
  Process: 77972 ExecStartPre=/usr/local/GreatSQL-8.0.32-24-Linux-glibc2.28-x86_64-minimal/bin/mysqld_pre_systemd (code=exited, status=0/SUCCESS)
 Main PID: 78043 (mysqld)
   Status: "Server is operational"
    Tasks: 38 (limit: 149064)
   Memory: 367.7M
   CGroup: /system.slice/greatsql.service
           └─78043 /usr/local/GreatSQL-8.0.32-24-Linux-glibc2.28-x86_64-minimal/bin/mysqld

Jul 13 15:46:17 GreatSQL-01 systemd[1]: Starting GreatSQL Server...
Jul 13 15:46:21 GreatSQL-01 systemd[1]: Started GreatSQL Server.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

检查MGR服务运行状态：

[root@GreatSQL][(none)]> select * from performance_schema.replication_group_members;
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
| CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST | MEMBER_PORT | MEMBER_STATE | MEMBER_ROLE | MEMBER_VERSION |
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
| group_replication_applier | ac24eab8-def4-11eb-a5e8-525400e802e2 | GreatSQL-03 |        3306 | ONLINE       | ARBITRATOR  | 8.0.32        |
| group_replication_applier | ac275d97-def4-11eb-9e49-525400fb993a | GreatSQL-02 |        3306 | ONLINE       | SECONDARY   | 8.0.32        |
| group_replication_applier | ac383458-def4-11eb-bf1a-5254002eb6d6 | GreatSQL-01 |        3306 | ONLINE       | PRIMARY     | 8.0.32        |
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
1
2
3
4
5
6
7
8

至此，安装完成。

§ 问题反馈

§ 联系我们

扫码关注微信公众号

greatsql-wx

← 编译源码安装 →