macOS 使用二进制包部署

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

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

前置依赖参考

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

依赖软件版本
MySQL Client8.0 及以上

步骤 1：安装依赖

安装 MySQL Client

  1. 点击 MySQL Community Downloads，进入到 MySQL 客户端下载安装页面，根据你的操作系统和硬件环境，下拉选择 Select Operating System > macOS，再下拉选择 Select OS Version，按需选择下载安装包进行安装。

  2. 配置 MySQL 客户端环境变量：

    1. 打开一个新的终端，输入如下命令：
    1. vim ~/.bash_profile
    1. 回车执行上面的命令后，即进入了 bash_profile，点击键盘上的 i 进入 insert 状态，即可在文件下方输入如下命令：
    1. export PATH=${PATH}:/usr/local/mysql/bin

  3. 输入完成后，点击键盘上的 esc 退出 insert 状态，并在最下方输入 :wq 保存退出。

  4. 执行命令 source ~/.bash_profile，回车执行，运行环境变量。

  5. 测试 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 是否安装成功可以使用如下命令行：

  1. wget -V

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

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

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

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

  1. curl --version

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

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

2. 下载二进制包并解压

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

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

x86 架构系统安装包：

  1. mkdir -p /User/username/mo/matrixone & cd /User/username/mo
  2. wget https://github.com/matrixorigin/matrixone/releases/download/v1.1.0/mo-v1.1.0-darwin-x86_64.zip
  3. unzip -d matrixone/ mo-v1.1.0-darwin-x86_64.zip

ARM 架构系统安装包：

  1. mkdir -p /User/username/mo/matrixone & cd /User/username/mo
  2. wget https://github.com/matrixorigin/matrixone/releases/download/v1.1.0/mo-v1.1.0-darwin-arm64.zip
  3. unzip -d matrixone/ mo-v1.1.0-darwin-arm64.zip

x86 架构系统安装包：

  1. mkdir -p /User/username/mo/matrixone & cd /User/username/mo
  2. curl -OL https://github.com/matrixorigin/matrixone/releases/download/v1.1.0/mo-v1.1.0-darwin-x86_64.zip
  3. unzip -d matrixone/ mo-v1.1.0-darwin-x86_64.zip

ARM 架构系统安装包：

  1. mkdir -p /User/username/mo/matrixone & cd /User/username/mo
  2. curl -OL https://github.com/matrixorigin/matrixone/releases/download/v1.1.0/mo-v1.1.0-darwin-arm64.zip
  3. unzip -d matrixone/ mo-v1.1.0-darwin-arm64.zip

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

步骤 3：安装 mo_ctl 工具

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

1. 一键安装 mo_ctl 工具

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

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

2. 设置 mo_ctl 的配置参数

通过以下命令将 MatrixOne 的二进制解压文件目录设置到 mo_ctl 的 MO_PATH 参数上。mo_ctl 会自动寻找位于 MO_PATH 中的 matrixone 文件夹。

  1. mo_ctl set_conf MO_PATH="/User/username/mo/"

步骤 4：启动 MatrixOne 服务

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

如果运行正常将出现以下日志。MatrixOne 的相关运行日志会在 /data/mo/logs/ 中。

  1. > mo_ctl start
  2. 2023-07-07_15:33:45    [INFO]    No mo-service is running
  3. 2023-07-07_15:33:45    [INFO]    Starting mo-service: cd /Users/username/mo/matrixone/matrixone/ && /Users/username/mo/matrixone/matrixone/mo-service -daemon -debug-http :9876 -launch /Users/username/mo/matrixone/matrixone/etc/launch/launch.toml >/Users/username/mo/matrixone/matrixone/logs/stdout-20230707_153345.log 2>/Users/username/mo/matrixone/matrixone/logs/stderr-20230707_153345.log
  4. 2023-07-07_15:33:45    [INFO]    Wait for 2 seconds
  5. 2023-07-07_15:33:48    [INFO]    At least one mo-service is running. Process info:
  6. 2023-07-07_15:33:48    [INFO]      501 66932     1   0  3:33PM ??         0:00.27 /Users/username/mo/matrixone/matrixone/mo-service -daemon -debug-http :9876 -launch /Users/username/mo/matrixone/matrixone/etc/launch/launch.toml
  7. 2023-07-07_15:33:48    [INFO]    Pids:
  8. 2023-07-07_15:33:48    [INFO]    66932
  9. 2023-07-07_15:33:48    [INFO]    Start succeeded

Note

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

步骤 5：连接 MatrixOne 服务

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

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

  1. > mo_ctl connect
  2. 2023-07-07_10:30:20    [INFO]    Checking connectivity
  3. 2023-07-07_10:30:20    [INFO]    Ok, connecting for user ...
  4. mysql: [Warning] Using a password on the command line interface can be insecure.
  5. Welcome to the MySQL monitor.  Commands end with ; or \g.
  6. Your MySQL connection id is 15
  7. Server version: 8.0.30-MatrixOne-v1.1.0 MatrixOne
  9. Copyright (c) 2000, 2023, Oracle and/or its affiliates.
  11. Oracle is a registered trademark of Oracle Corporation and/or its
  12. affiliates. Other names may be trademarks of their respective
  13. owners.
  15. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
  17. mysql>

Note

上述的连接和登录账号为初始账号 root 和密码 111，请在登录 MatrixOne 后及时修改初始密码，参见密码管理。修改登录用户名或密码后重新登录同样需要通过 mo_ctl set_conf 的方式设置新的用户名和密码，详情可以参考 mo_ctl 工具指南。