Skip to content

Commit

Permalink
Deployed 9fa9554 to dev with MkDocs 1.5.2 and mike 1.1.2
Browse files Browse the repository at this point in the history
  • Loading branch information
sukki37 committed Sep 18, 2023
1 parent b3e6c8d commit 57e2684
Show file tree
Hide file tree
Showing 8 changed files with 9,957 additions and 48 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -9405,12 +9405,6 @@ <h2 id="mysql-client-matrixone">通过 MySQL Client 连接 MatrixOne 服务</h2>
<h2 id="navicat-matrixone">通过 Navicat 连接 MatrixOne 服务</h2>
<ol>
<li>
<p>打开一个新的终端窗口,输入以下命令,启动 MatrixOne:</p>
<div class="highlight"><pre><span></span><code>#Launch MatrixOne (Source code method)
./mo-service -launch ./etc/launch/launch.toml
</code></pre></div>
</li>
<li>
<p>下载安装 <a href="https://www.navicat.com/en/products">Navicat</a></p>
</li>
<li>
Expand Down
16 changes: 8 additions & 8 deletions dev/MatrixOne/FAQs/deployment-faqs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -9740,9 +9740,14 @@ <h3 id="pc-m1-ssb-ssb-dbgen"><strong>我的 PC 是 M1 芯片,当我进行 SSB
</li>
</ol>
<h3 id="main-matrixone-panic"><strong>我先在 main 分支构建了 MatrixOne,现在切换到其他版本再进行构建出现 panic</strong></h3>
<p>MatrixOne 版本 0.8.0 以及之前的版本之间的存储格式并不相互兼容。这意味着在执行 <code>make build</code> 后,系统会自动生成一个名为 <em>mo-data</em> 的数据目录文件,用于存放数据。</p>
<p>如果在未来你需要切换到其他分支并重新进行 <code>make build</code> 以构建 MatrixOne,可能会导致 panic 情况发生。在这种情况下,你需要先清理 <em>mo-data</em> 数据目录(即执行 <code>rm -rf mo-data</code> 命令),然后再重新构建 MatrixOne。</p>
<p>参考代码示例:</p>
<p>当 MatrixOne 版本切换涉及到 0.8.0 之前的版本并且使用 <code>make build</code> 命令的时候可能会出现这个问题,这是 MatrixOne 数据存储格式升级造成的不兼容问题,但自 0.8.0 的版本开始会持续兼容。</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>在这种情况下,我们强烈建议你重新<a href="../../Get-Started/install-standalone-matrixone/">安装最新稳定版的 MatrixOne 版本</a>以实现后续的数据兼容,同时推荐使用 mo_ctl 工具进行快速构建和启动。</p>
</div>
<p>具体来说,在 MatrixOne 版本 0.8.0 之前时,执行 <code>make build</code> 后,系统会自动生成一个名为 <em>mo-data</em> 的数据目录文件,用于存放数据。如果你再切换到其他分支上并重新进行 <code>make build</code> 的时候,系统并不会自动删除 <em>mo-data</em> 数据目录,此时由于数据格式不兼容,可能会导致 panic 情况发生。</p>
<p>为了解决这个问题,你需要先清理 <em>mo-data</em> 数据目录(即执行 <code>rm -rf mo-data</code> 命令),然后再重新构建 MatrixOne。</p>
<p>以下参考代码示例使用较早的构建流程:</p>
<div class="highlight"><pre><span></span><code>[root ~]# cd matrixone // 进入 matrixone 文件目录
[root ~]# git branch // 查看当前分支
* 0.8.0
Expand All @@ -9752,12 +9757,7 @@ <h3 id="main-matrixone-panic"><strong>我先在 main 分支构建了 MatrixOne
[root ~]# rm -rf mo-data // 清理数据目录
[root ~]# make build // 构建 matrixone
... // 此处省略构建过程代码
[root ~]# ./mo-service --daemon --launch ./etc/launch/launch.toml &amp;&gt; test.log &amp; // 在终端的后台启动 MatrixOne 服务
</code></pre></div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>MatrixOne 0.8.0 版本兼容旧版本存储格式。如果你使用的是 0.8.0 版本或更高版本,执行切换至其他分支并构建时,则无需再清理数据文件目录。</p>
</div>
<h3 id="cn-proxy-matrixone"><strong>我使用带 CN 标签的方式连 proxy,登录 MatrixOne 集群出现密码验证错误的提示</strong></h3>
<ul>
<li>
Expand Down
59 changes: 27 additions & 32 deletions dev/MatrixOne/Maintain/mount-data-by-docker/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -9328,24 +9328,18 @@

<h1 id="docker">挂载目录到 Docker 容器</h1>
<p>本篇文档将指导你在使用 Docker 启动 MatrixOne 的情况下,如何挂载<em>数据目录</em><em>自定义配置文件</em>到 Docker 容器。</p>
<p>需要注意的是,Docker 不能对已经启动过的容器进行挂载,若想要挂载数据目录则需要重新创建一个 Docker 容器。</p>
<h2 id="_1">挂载数据目录</h2>
<p>为了保证数据目录安全不丢失,参考以下详细步骤,挂载本地数据目录到 Docker 容器:</p>
<p>参考以下详细步骤,挂载本地数据目录到 Docker 容器:</p>
<ol>
<li>
<p>检查 Docker 内是否已经启动 MatrixOne</p>
<div class="highlight"><pre><span></span><code>docker ps -a
<p>在本地创建一个<strong>空目录</strong> <em>${local_data_path}/mo-data</em>,其中 <em>${local_data_path}</em> 为你的本地文件夹路径。命令示例如下</p>
<div class="highlight"><pre><span></span><code>mkdir<span class="w"> </span><span class="si">${</span><span class="nv">local_data_path</span><span class="si">}</span>/mo-data
</code></pre></div>
</li>
<li>
<p>如果 Docker 内有正在运行的 MatrixOne,需要先停止:</p>
<div class="highlight"><pre><span></span><code>docker stop &lt;containerID&gt;
docker rm &lt;containerID&gt;
</code></pre></div>
<p>如果没有正在运行的 MatrxiOne,请忽略这一步。</p>
</li>
<li>
<p>把本地<strong>空目录</strong>挂载到 Docker 容器目录 <em>/mo-data</em> 下,命令示例如下:</p>
<div class="highlight"><pre><span></span><code>sudo docker run --name &lt;name&gt; --privileged -d -p 6001:6001 -v ${local_data_path}/mo-data:/mo-data:rw matrixorigin/matrixone:1.0.0-rc1
<p>把本地<strong>空目录</strong> <em>${local_data_path}/mo-data</em> 挂载到 Docker 容器目录 <em>/mo-data</em> 下,命令示例如下:</p>
<div class="highlight"><pre><span></span><code>sudo<span class="w"> </span>docker<span class="w"> </span>run<span class="w"> </span>--name<span class="w"> </span>&lt;name&gt;<span class="w"> </span>-d<span class="w"> </span>-p<span class="w"> </span><span class="m">6001</span>:6001<span class="w"> </span>-v<span class="w"> </span><span class="si">${</span><span class="nv">local_data_path</span><span class="si">}</span>/mo-data:/mo-data:rw<span class="w"> </span>matrixorigin/matrixone:1.0.0-rc1
</code></pre></div>
<table>
<thead>
Expand All @@ -9367,33 +9361,28 @@ <h2 id="_2">挂载自定义配置文件</h2>
<p>如果你需要修改启动配置文件,建议你先将 Docker 内的启动配置文件拷贝到你本地目录,然后将存放配置文件的本地目录挂载到 Docker 容器目录下,参考以下详细步骤,挂载配置文件到 Docker 容器:</p>
<ol>
<li>
<p>检查 Docker 内是否已经启动 MatrixOne:</p>
<div class="highlight"><pre><span></span><code>docker ps -a
</code></pre></div>
</li>
<li>
<p>如果 Docker 内还没有正在运行的 MatrixOne,请先启动:</p>
<div class="highlight"><pre><span></span><code>docker run -d -p 6001:6001 --name matrixone --privileged=true matrixorigin/matrixone:1.0.0-rc1
<p>首先启动一个 MatrixOne 的容器实例,这个容器实例将提供一套标准的启动配置文件:</p>
<div class="highlight"><pre><span></span><code>docker<span class="w"> </span>run<span class="w"> </span>-d<span class="w"> </span>-p<span class="w"> </span><span class="m">6001</span>:6001<span class="w"> </span>--name<span class="w"> </span>matrixone<span class="w"> </span>matrixorigin/matrixone:1.0.0-rc1
</code></pre></div>
</li>
<li>
<p>查看 Docker 已经启动 MatrixOne 的 containerID,并将配置文件目录拷贝到本地目录内</p>
<div class="highlight"><pre><span></span><code>docker ps -a
docker cp &lt;containerID&gt;:/etc .
<p>查看 Docker 已经启动的 MatrixOne 的 containerID,并将配置文件目录拷贝到本地目录的 <em>${local_config_path}</em> 目录下</p>
<div class="highlight"><pre><span></span><code>docker<span class="w"> </span>ps
docker<span class="w"> </span>cp<span class="w"> </span>&lt;containerID&gt;:/etc/launch<span class="w"> </span><span class="si">${</span><span class="nv">local_config_path</span><span class="si">}</span>
</code></pre></div>
</li>
<li>
<p>拷贝完成后,关停当前的 MatrixOne:</p>
<div class="highlight"><pre><span></span><code>docker stop &lt;containerID&gt;
docker rm &lt;containerID&gt;
<p>拷贝完成后,关停并销毁当前的 MatrixOne:</p>
<div class="highlight"><pre><span></span><code>docker<span class="w"> </span>stop<span class="w"> </span>&lt;containerID&gt;
docker<span class="w"> </span>rm<span class="w"> </span>&lt;containerID&gt;
</code></pre></div>
</li>
<li>
<p>(选做)修改本地配置文件并保存</p>
<p>(选做)若需要修改启动配置文件,则修改本地目录 <em>${local_config_path}/launch</em> 下的配置文件并保存</p>
</li>
<li>
<p>挂载配置文件到 Docker 容器目录,同时启动 MatrixOne,挂载命令示例如下:</p>
<div class="highlight"><pre><span></span><code>sudo<span class="w"> </span>docker<span class="w"> </span>run<span class="w"> </span>--name<span class="w"> </span>&lt;name&gt;<span class="w"> </span>--privileged<span class="w"> </span>-d<span class="w"> </span>-p<span class="w"> </span><span class="m">6001</span>:6001<span class="w"> </span>-v<span class="w"> </span><span class="si">${</span><span class="nv">local_config_path</span><span class="si">}</span>/etc:/etc:rw<span class="w"> </span>--entrypoint<span class="w"> </span><span class="s2">&quot;/mo-service&quot;</span><span class="w"> </span>matrixorigin/matrixone:1.0.0-rc1<span class="w"> </span>-launch<span class="w"> </span>/etc/launch/launch.toml
<p>挂载配置文件到 Docker 容器目录,同时创建并启动 MatrixOne,挂载命令示例如下:</p>
<div class="highlight"><pre><span></span><code>sudo<span class="w"> </span>docker<span class="w"> </span>run<span class="w"> </span>--name<span class="w"> </span>&lt;name&gt;<span class="w"> </span>-d<span class="w"> </span>-p<span class="w"> </span><span class="m">6001</span>:6001<span class="w"> </span>-v<span class="w"> </span><span class="si">${</span><span class="nv">local_config_path</span><span class="si">}</span>/launch:/etc/launch:rw<span class="w"> </span>--entrypoint<span class="w"> </span><span class="s2">&quot;/mo-service&quot;</span><span class="w"> </span>matrixorigin/matrixone:1.0.0-rc1<span class="w"> </span>-launch<span class="w"> </span>/etc/launch/launch.toml
</code></pre></div>
<table>
<thead>
Expand All @@ -9404,21 +9393,27 @@ <h2 id="_2">挂载自定义配置文件</h2>
</thead>
<tbody>
<tr>
<td>${local_config_path}/etc:/etc</td>
<td>挂载本地配置文件目录 <em>${local_config_path}/etc</em> 到容器 <em>/etc</em> 文件夹</td>
<td>${local_config_path}/launch:/etc/launch</td>
<td>挂载本地配置文件目录 <em>${local_config_path}/launch</em> 到容器 <em>/etc/launch</em> 文件夹</td>
</tr>
<tr>
<td>--entrypoint "/mo-service"</td>
<td>指定容器启动 MatrixOne 服务</td>
<td>容器入口命令,即让容器启动 MatrixOne 服务</td>
</tr>
<tr>
<td>-launch /etc/launch/launch.toml</td>
<td>启动 <em>/etc/</em> 中的 MatrixOne 启动配置文件</td>
<td>容器入口命令对应的命令参数,即使用容器内 <em>/etc/launch/launch.toml</em> 启动配置文件启动 MatrixOne 服务</td>
</tr>
</tbody>
</table>
</li>
</ol>
<div class="admonition note">
<p class="admonition-title">Note<p>若 Docker 版本低于 20.10.18 或者 Docker client 和 Docker server 的版本不一致,推荐同时升级到 Docker 最新稳定版本后再尝试。若坚持使用,需要在 <code>docker run</code> 命令中加上参数 <code>--privileged=true</code>,如:</p>
<div class="highlight"><pre><span></span><code>docker<span class="w"> </span>run<span class="w"> </span>-d<span class="w"> </span>-p<span class="w"> </span><span class="m">6001</span>:6001<span class="w"> </span>--name<span class="w"> </span>matrixone<span class="w"> </span>--privileged<span class="o">=</span><span class="nb">true</span><span class="w"> </span>matrixorigin/matrixone:1.0.0-rc1
</code></pre></div>
</p>
</div>
<p>更多关于 <em>Docker run</em> 的指令释义,运行命令 <code>docker run --help</code> 进行查看。</p>


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9546,7 +9546,7 @@ <h4 id="_7">传统架构</h4>
</ul>
<h4 id="matrixone">MatrixOne 架构</h4>
<p>MatrixOne 的多租户能力带来了全新的架构方式。租户仍然共享一个 MatrixOne 集群,并且可以通过系统租户进行统一的租户运维和管理。另外,通过自带的多租户能力实现数据及资源的隔离,同时每个租户可以独立进行资源扩缩容,进一步降低运维难度。这种方式不仅满足对隔离性的需求,还能满足低资源和运维成本的需求。</p>
<p><img alt="MatrixOne Architecture" src="https://community-shared-data-1308875761.cos.ap-beijing.myqcloud.com/artwork/docs/overview/mo-account-arch.png" /></p>
<p><img width="1205" height="1686" style="max-width: min(100%, 16rem); display: block; margin: auto;" alt="mo-account-arch" src="https://community-shared-data-1308875761.cos.ap-beijing.myqcloud.com/artwork/docs/overview/mo-account-arch.png" ></p>
<table>
<thead>
<tr>
Expand Down
Loading

0 comments on commit 57e2684

Please sign in to comment.