Skip to content

安装单机版 MatrixOne

作为一款开源数据库，MatrixOne 目前支持主流的 Linux 和 MacOS 系统。你可以通过以下三种方法安装单机版 MatrixOne：

推荐硬件规格：x86 CPU；4核；32GB 内存，支持 CentOS 7+ 操作系统。

更多关于硬件规格推荐，参见硬件与操作系统要求。

方法 1：使用源代码搭建

1. 安装部署 Go 语言环境

Go 语言需要升级到 1.19 版本。

2. 安装部署 MySQL 客户端

MySQL 客户端请使用 8.0.30 版本。

3. 获取 MatrixOne 源码完成搭建

根据您的需要，选择您所获取的代码永远保持最新，还是获得稳定版本的代码。

选项 1：MatrixOne(开发版本) 代码搭建

main 分支是默认分支，主分支上的代码总是最新的，但不够稳定。

  1. 获取 MatrixOne(开发版本，即 Pre0.6 版本) 代码方法如下：

    git clone https://github.com/matrixorigin/matrixone.git
cd matrixone

  2. 运行编译文件：你可以运行make debug与make clean或者其他任何Makefile支持的命令。

    make build

  3. 启动 MatrixOne 服务：

    Note

    注意，MatrixOne(开发版本) 的启动配置文件与 MatrixOne(稳定版本) 的启动配置文件不同，MatrixOne(开发版本) 的启动配置文件代码如下：

    ./mo-service -cfg ./etc/cn-standalone-test.toml

选项 2：获取 MatrixOne(稳定版本) 代码

  1. 如果您想获得 MatrixOne 发布的最新稳定版本代码，请先从 main 切换选择至 0.5.1 版本分支。

    git clone https://github.com/matrixorigin/matrixone.git
git checkout 0.5.1
cd matrixone

  2. 运行编译文件：你可以运行make debug与make clean或者其他任何Makefile支持的命令。

    make config
make build

  3. 启动 MatrixOne 服务：

    Note

    注意，MatrixOne(稳定版本) 的启动配置文件与 MatrixOne(开发版本) 的启动配置文件不同，MatrixOne(稳定版本) 的启动配置文件代码如下：

    ./mo-server system_vars_config.toml

4. 连接 MatrixOne 服务

当你完成安装 MatrixOne，你可以参考下面的章节，连接到 MatrixOne 服务器。

参见连接 MatrixOne 服务。

方法 2：下载二进制包

从 0.3.0 版本开始，您可以直接下载二进制包，然后在 X86_64 Linux 环境或者 X86_64 的 MacOS 环境中运行 MatrixOne。

1. 下载二进制包并解压

Linux 环境

  • 下载方式一：

    wget https://github.com/matrixorigin/matrixone/releases/download/v0.5.1/mo-server-v0.5.1-linux-amd64.zip
unzip mo-server-v0.5.1-linux-amd64.zip

  • 下载方式二：

    curl -OL https://github.com/matrixorigin/matrixone/releases/download/v0.5.1/mo-server-v0.5.1-linux-amd64.zip
unzip mo-server-v0.5.1-linux-amd64.zip

  • 下载方式三：

    进入版本 0.5.1，下拉找到 Assets 栏，点击安装包 mo-server-v0.5.1-linux-amd64.zip 下载即可。

MacOS 环境

  • 下载方式一：

    wget https://github.com/matrixorigin/matrixone/releases/download/v0.5.1/mo-server-v0.5.1-darwin-x86_64.zip
unzip mo-server-v0.5.1-darwin-x86_64.zip

  • 下载方式二：

    curl -OL https://github.com/matrixorigin/matrixone/releases/download/v0.5.1/mo-server-v0.5.1-darwin-x86_64.zip
unzip mo-server-v0.5.1-darwin-x86_64.zip

  • 下载方式三：

    进入版本 0.5.1，下拉找到 Assets 栏，点击安装包 mo-server-v0.5.1-darwin-x86_64.zip 下载即可。

Info

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

2. 安装部署 MySQL 客户端

MySQL 客户端请使用 8.0.30 版本。

3. 启动 MatrixOne 服务

./mo-server system_vars_config.toml

4. 连接 MatrixOne 服务

当你完成安装 MatrixOne，你可以参考下面的章节，连接到 MatrixOne 服务器。

参见连接 MatrixOne 服务。

方法 3：使用 Docker

1. 安装 Docker

请检查 Docker daemon 是否正在后台运行，并确认 Docker 版本：

docker --version

2. 创建并运行容器

使用以下命令将从 Docker Hub 中拉取 MatrixOne 镜像，你可以选择稳定版本镜像，或开发版本镜像。

  • 稳定版本的镜像（0.5.1）
docker run -d -p 6001:6001 --name matrixone matrixorigin/matrixone:0.5.1
  • 开发版本的镜像（Pre0.6)

获取最新开发版本的镜像，参见Docker Hub，找到最新Tag，拉取镜像。拉取镜像代码示例如下：

docker run -d -p 6001:6001 --name matrixone matrixorigin/matrixone:nightly-commitnumber

Info

如上面代码所示，nightly 为标识的 Tag 版本每天都进行更新，请注意获取最新的镜像。

运行 Docker Hub 时需要输入用户名和密码，获取用户名和密码可以参考下一步骤 - 连接 MatrixOne 服务

3. 挂载数据（选做）

如果你需要自定义配置文件或者数据目录，可以直接挂载存放在本地磁盘的自定义配置文件以及数据目录：

docker run -d -p 6001:6001 -v ${path_name}/system_vars_config.toml:/system_vars_config.toml:ro -v ${path_name}/store:/store:rw --name matrixone matrixorigin/matrixone:0.5.1
参数 描述
${path_name}/system_vars_config.toml 挂载配置文件 system_vars_config.toml 的本地磁盘目录
/system_vars_config.toml 容器内配置文件
${path_name}/store 备份 /store 的本地磁盘目录
/store 容器内 /store 目录

更多关于 Docker run 的指令释义，运行命令 docker run --help 进行查看。

4. 连接 MatrixOne 服务

当你完成安装 MatrixOne，你可以参考下面的章节，连接到 MatrixOne 服务器。

参见连接 MatrixOne 服务。

参考文档

升级版本，参见升级单机版 MatrixOne。 常见的安装和部署问题，参见安装和部署常见问题。