使用二进制包部署

本篇文档将指导你使用二进制包部署单机版 MatrixOne。

步骤 1：安装下载工具

我们提供下载二进制包的方式安装 MatrixOne，如果你喜欢通过命令行进行操作，那么你可以提前准备安装好 wget 或 curl。

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 工具下载二进制包**下载方式三：页面下载

  1. wget https://github.com/matrixorigin/matrixone/releases/download/v0.7.0/mo-v0.7.0-darwin-x86_64.zip
  2. unzip mo-v0.7.0-darwin-x86_64.zip
  1. curl -OL https://github.com/matrixorigin/matrixone/releases/download/v0.7.0/mo-v0.7.0-darwin-x86_64.zip
  2. unzip mo-v0.7.0-darwin-x86_64.zip

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

Info

ARM 芯片硬件配置下，MatrixOne 仅支持通过源代码方式进行安装部署；如果你使用的是 MacOS 系统 M1 及以上版本，请使用源代码构建的方式安装部署 MatrixOne。若果在 X86 硬件配置下使用二进制方式安装部署 MatrixOne 会导致未知问题。

步骤 3：启动 MatrixOne 服务

在终端的前台启动 MatrixOne 服务**推荐使用：在终端的后台启动 MatrixOne 服务**

该启动方式会在终端的前台运行 mo-service 进行，实时打印系统日志。如果你想停止 MatrixOne 服务器，只需按 CTRL+C 或关闭当前终端。

  1. # Start mo-service in the frontend
  2. ./mo-service -launch ./etc/quickstart/launch.toml

在前台启动模式下，产生很多日志，接下来你可以启动新的终端，连接 MatrixOne。

该启动方法会在后台运行 mo-service 进程，系统日志将重定向到 test.log 文件中。如果你想停止 MatrixOne 服务器，你需要通过以下命令查找出它的 PID 进程号并消除进程。下面是整个过程的完整示例。

  1. # Start mo-service in the backend
  2. ./mo-service --daemon --launch ./etc/quickstart/launch.toml &> test.log &
  4. # Find mo-service PID
  5. ps aux | grep mo-service
  7. [root@VM-0-10-centos ~]# ps aux | grep mo-service
  8. root       15277  2.8 16.6 8870276 5338016 ?     Sl   Nov25 156:59 ./mo-service -launch ./etc/quickstart/launch.toml
  9. root      836740  0.0  0.0  12136  1040 pts/0    S+   10:39   0:00 grep --color=auto mo-service
  11. # Kill the mo-service process
  12. kill -9 15277

Tips: 如上述示例所示，使用命令 ps aux | grep mo-service 首先查找出 MatrixOne 运行的进程号为 15277，kill -9 15277 即表示停止进程号为 15277 的 MatrixOne。

接下来你可以进行下一步 - 连接 MatrixOne。

Info

如果在某一分支上构建以后，需要切换分支再进行构建，运行后则出现 panic，需要清理数据文件目录。参见安装和部署常见问题进行解决。

步骤 4：连接 MatrixOne

安装并配置 MySQL 客户端

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

    Note: 建议 MySQL 客户端版本为 8.0.30 版本及以上。

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

    1. 打开一个新的终端，输入如下命令：

      1. cd ~
      2. sudo vim .bash_profile

    2. 回车执行上面的命令后，需要输入 root 用户密码，即你在安装 MySQL 客户端时，你在安装窗口设置的 root 密码；如果没有设置密码，则直接回车跳过即可。

    3. 输入/跳过 root 密码后，即进入了. bash_profile，点击键盘上的 i 进入 insert 状态，即可在文件下方输入如下命令：

      1. export PATH=${PATH}:/usr/local/mysql/bin

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

    5. 输入命令 source .bash_profile，回车执行，运行环境变量。

    6. 测试 MySQL 是否可用：

      • 方式一：输入命令 mysql -u root -p，回车执行，需要 root 用户密码，显示 mysql> 即表示 MySQL 客户端已开启。

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

    7. MySQL 如可用，关闭当前终端，继续浏览下一章节连接 MatrixOne 服务。

    Tips: 目前，MatrixOne 只兼容 Oracle MySQL 客户端，因此一些特性可能无法在 MariaDB、Percona 客户端下正常工作。

连接 MatrixOne

  • 你可以使用 MySQL 命令行客户端来连接 MatrixOne。打开一个新的终端，直接输入以下指令：

    1. mysql -h IP -P PORT -uUsername -p

    输入完成上述命令后，终端会提示你提供用户名和密码。你可以使用我们的内置帐号：

    1. · user: dump
    2. · password: 111

  • 你也可以使用 MySQL 客户端下述命令行，输入密码，来连接 MatrixOne 服务：

    1. mysql -h 127.0.0.1 -P 6001 -udump -p
    2. Enter password:

目前，MatrixOne 只支持 TCP 监听。