macOS 使用二进制包部署

本篇文档将指导你使用二进制包在 macOS 环境中部署单机版 MatrixOne，这种安装方案无需安装前置依赖和编译源码包，可以直接通过 mo_ctl 工具帮助我们进行部署与管理 MatrixOne。

MatrixOne 支持 x86 及 ARM 两种架构的 macOS 系统，本文以 Macbook M1 ARM 版本为例展示整个部署过程。

前置依赖参考

通过二进制包部署和安装 MatrixOne，仅需安装 MySQL Client 工具。

依赖软件	版本
MySQL Client	8.0 及以上

步骤 1：安装依赖

安装 MySQL Client

点击 MySQL Community Downloads，进入到 MySQL 客户端下载安装页面，根据你的操作系统和硬件环境，下拉选择 Select Operating System > macOS，再下拉选择 Select OS Version，按需选择下载安装包进行安装。
配置 MySQL 客户端环境变量：
1. 打开一个新的终端，输入如下命令：
```
vim ~/.bash_profile
```
1. 回车执行上面的命令后，即进入了 bash_profile，点击键盘上的 i 进入 insert 状态，即可在文件下方输入如下命令：
```
export PATH=${PATH}:/usr/local/mysql/bin
```
输入完成后，点击键盘上的 esc 退出 insert 状态，并在最下方输入 :wq 保存退出。
执行命令 source ~/.bash_profile，回车执行，运行环境变量。
测试 MySQL 是否可用：

执行命令 mysql --version，安装成功提示：mysql Ver 8.0.31 for macos12 on arm64 (MySQL Community Server - GPL)。

步骤 2：下载二进制包并解压

1. 安装下载工具

Tips: 建议你下载安装这两个下载工具其中之一，方便后续通过命令行下载二进制包。

安装 wget安装 curl

wget 工具用来从指定的 URL 下载文件。wget 是专门的文件下载工具，它非常稳定，而且下载速度快。

进入到Homebrew页面按照步骤提示，先安装 Homebrew，再安装 wget。验证 wget 是否安装成功可以使用如下命令行：

wget -V

安装成功结果(仅展示一部分代码)如下：

GNU Wget 1.21.3 在 darwin21.3.0 上编译。
...
Copyright © 2015 Free Software Foundation, Inc.
...

curl 是一个利用 URL 规则在命令行下工作的文件传输工具。curl 是综合传输工具，支持文件的上传和下载。

进入到Curl官网按照官方指导安装 curl。验证 curl 是否安装成功可以使用如下命令行：

curl --version

安装成功结果(仅展示一部分代码)如下：

curl 7.84.0 (x86_64-apple-darwin22.0) libcurl/7.84.0 (SecureTransport) LibreSSL/3.3.6 zlib/1.2.21 nghttp2/1.47.0
Release-Date: 2022-06-27
...

2. 下载二进制包并解压

下载方式一和下载方式二需要先安装下载工具 wget 或 curl，如果你未安装，请先自行安装下载工具。

下载方式一：wget 工具下载安装二进制包下载方式二：curl 工具下载二进制包下载方式三：页面下载

x86 架构系统安装包：

wget https://github.com/matrixorigin/matrixone/releases/download/v1.2.3/mo-v1.2.3-darwin-x86_64.zip
unzip mo-v1.2.3-darwin-x86_64.zip

ARM 架构系统安装包：

wget https://github.com/matrixorigin/matrixone/releases/download/v1.2.3/mo-v1.2.3-darwin-arm64.zip
unzip mo-v1.2.3-darwin-arm64.zip

如 github 原地址下载过慢，您可尝试从以下地址下载镜像包：

wget https://githubfast.com/matrixorigin/matrixone/releases/download/v1.2.3/mo-v1.2.3-darwin-xxx.zip

x86 架构系统安装包：

curl -OL https://github.com/matrixorigin/matrixone/releases/download/v1.2.3/mo-v1.2.3-darwin-x86_64.zip
unzip mo-v1.2.3-darwin-x86_64.zip

ARM 架构系统安装包：

curl -OL https://github.com/matrixorigin/matrixone/releases/download/v1.2.3/mo-v1.2.3-darwin-arm64.zip
unzip mo-v1.2.3-darwin-arm64.zip

如 github 原地址下载过慢，您可尝试从以下地址下载镜像包：

curl -OL https://githubfast.com/matrixorigin/matrixone/releases/download/v1.2.3/mo-v1.2.3-darwin-xxx.zip

如果你想通过更直观的页面下载的方式下载，直接点击进入版本 1.2.3，下拉找到 Assets 栏，点击安装包 mo-v1.2.3-darwin-x86_64.zip 或 mo-v1.2.3-darwin-arm64.zip 下载即可。

步骤 3：安装 mo_ctl 工具

mo_ctl 是一个部署安装和管理 MatrixOne 的命令行工具，使用它可以非常方便的对 MatrixOne 进行各类操作。如需获取完整的使用细节可以参考 mo_ctl 工具指南。

一键安装 mo_ctl 工具

通过以下命令可以一键安装 mo_ctl 工具。

wget https://raw.githubusercontent.com/matrixorigin/mo_ctl_standalone/main/install.sh && sudo -u $(whoami) bash +x ./install.sh

设置 mo_ctl 的配置参数

通过以下命令调整参数：

mo_ctl set_conf MO_PATH="/yourpath/mo-v1.2.3-xx-xx" #设置MatrixOne路径为二进制解压文件目录
mo_ctl set_conf MO_CONF_FILE="/yourpath/mo-v1.2.3-xx-xx/etc/launch/launch.toml" #设置MatrixOne配置文件路径
mo_ctl set_conf MO_DEPLOY_MODE=binary #设置MatrixOne部署方式，此为二进制部署方式

步骤 4：启动 MatrixOne 服务

通过 mo_ctl start 命令一键启动 MatrixOne 服务。

如果运行正常将出现以下日志。MatrixOne 的相关运行日志会在 /yourpath/mo-v1.2.3-xx-xx/matrixone/logs/ 中。

> mo_ctl start
2024-03-07 14:34:04.942 UTC+0800    [INFO]    No mo-service is running
2024-03-07 14:34:04.998 UTC+0800    [INFO]    Get conf succeeded: MO_DEPLOY_MODE="binary"
2024-03-07 14:34:05.024 UTC+0800    [INFO]    GO memory limit(Mi): 14745
2024-03-07 14:34:05.072 UTC+0800    [INFO]    Starting mo-service: cd /Users/admin/mo-v1.2.3-darwin-arm64/ && GOMEMLIMIT=14745MiB /Users/admin/mo-v1.2.3-darwin-arm64/mo-service -daemon -debug-http :9876 -launch /Users/admin/mo-v1.2.3-darwin-arm64/etc/launch/launch.toml >/Users/admin/mo-v1.2.3-darwin-arm64/matrixone/logs/stdout-20240307_143405.log 2>/Users/admin/mo-v1.2.3-darwin-arm64/matrixone/logs/stderr-20240307_143405.log
2024-03-07 14:34:05.137 UTC+0800    [INFO]    Wait for 2 seconds
2024-03-07 14:34:07.261 UTC+0800    [INFO]    At least one mo-service is running. Process info: 
  501 27145     1   0  2:34下午 ??         0:00.18 /Users/admin/mo-v1.2.3-darwin-arm64/mo-service -daemon -debug-http :9876 -launch /Users/admin/mo-v1.2.3-darwin-arm64/etc/launch/launch.toml
2024-03-07 14:34:07.284 UTC+0800    [INFO]    List of pid(s): 
27145
2024-03-07 14:34:07.308 UTC+0800    [INFO]    Start succeeded

Note

首次启动 MatrixOne 大致需要花费 20 至 30 秒的时间，在稍作等待后，你便可以使用 MySQL 客户端连接至 MatrixOne。

步骤 5：连接 MatrixOne 服务

通过 `mo_ctl connect` 命令一键连接 MatrixOne 服务

这条命令将调用 MySQL Client 工具自动连接到 MatrixOne 服务。

> mo_ctl connect
2024-03-07 14:34:59.902 UTC+0800    [INFO]    Checking connectivity
2024-03-07 14:34:59.942 UTC+0800    [INFO]    Ok, connecting for user ... 
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 426
Server version: 8.0.30-MatrixOne-v1.2.3 MatrixOne

Copyright (c) 2000, 2018, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql>