From f5160837fbb7ffd7bb6cdb8238c7395d3a1c9159 Mon Sep 17 00:00:00 2001 From: Chunzhu Li Date: Sat, 6 Jun 2020 13:53:21 +0800 Subject: [PATCH 1/7] add offline update tiup --- production-offline-deployment-using-tiup.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/production-offline-deployment-using-tiup.md b/production-offline-deployment-using-tiup.md index af72c908bd10..91b1cbc28617 100644 --- a/production-offline-deployment-using-tiup.md +++ b/production-offline-deployment-using-tiup.md @@ -264,3 +264,20 @@ tiup cluster start tidb-test 预期日志结尾输出会有 ```Deployed cluster `tidb-test` successfully``` 关键词，表示部署成功。 部署完成后，集群相关操作可参考 [cluster 命令](/tiup/tiup-cluster.md)。 + +## 6. 离线镜像升级本地集群 + +如果用户希望升级更新本地的 tiup 离线镜像，可以参考本文的步骤 1 与 步骤 2。在执行 `local_install.sh` 后，TiUP 会完成覆盖升级。 + +随后，需要按照 `local_install.sh` 执行结果的执行，重新声明全局环境变量，并将 TIUP_MIRRORS 指向执行 `local_install.sh` 命令时输出的离线镜像包的位置 `/path/to/mirror`。 + +{{< copyable "shell-regular" >}} + +```bash +source .bash_profile +export TIUP_MIRRORS=/path/to/mirror +``` + +此时离线镜像已经更新成功。如果发现覆盖后发现 TiUP 运行报错，可能是 manifest 未更新导致，可尝试 `rm -rf ~/.tiup/manifests` 后再次运行。 + +在更新本地镜像后，如果需要升级本地集群，可参考[使用 TiUP 升级 TiDB](/upgrade-tidb-using-tiup.md#使用-tiup-升级-tidb)。 \ No newline at end of file From 4bf253733fd18a4f3f22b33289f34caf5579855c Mon Sep 17 00:00:00 2001 From: Chunzhu Li Date: Sun, 7 Jun 2020 15:21:43 +0800 Subject: [PATCH 2/7] address comments --- production-offline-deployment-using-tiup.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/production-offline-deployment-using-tiup.md b/production-offline-deployment-using-tiup.md index 91b1cbc28617..bd672e52e278 100644 --- a/production-offline-deployment-using-tiup.md +++ b/production-offline-deployment-using-tiup.md @@ -265,11 +265,11 @@ tiup cluster start tidb-test 部署完成后，集群相关操作可参考 [cluster 命令](/tiup/tiup-cluster.md)。 -## 6. 离线镜像升级本地集群 +## 6. 更新 TiUP 离线镜像以升级本地集群 -如果用户希望升级更新本地的 tiup 离线镜像，可以参考本文的步骤 1 与 步骤 2。在执行 `local_install.sh` 后，TiUP 会完成覆盖升级。 +如果用户希望升级更新本地的 TiUP 离线镜像，可以参考本文的步骤 1 与步骤 2。在执行 `local_install.sh` 后，TiUP 会完成覆盖升级。 -随后，需要按照 `local_install.sh` 执行结果的执行，重新声明全局环境变量，并将 TIUP_MIRRORS 指向执行 `local_install.sh` 命令时输出的离线镜像包的位置 `/path/to/mirror`。 +随后，需要按照 `local_install.sh` 执行的结果，重新声明全局环境变量，并将 TIUP_MIRRORS 指向执行 `local_install.sh` 命令时输出的离线镜像包的位置 `/path/to/mirror`。 {{< copyable "shell-regular" >}} @@ -278,6 +278,6 @@ source .bash_profile export TIUP_MIRRORS=/path/to/mirror ``` -此时离线镜像已经更新成功。如果发现覆盖后发现 TiUP 运行报错，可能是 manifest 未更新导致，可尝试 `rm -rf ~/.tiup/manifests` 后再次运行。 +此时离线镜像已经更新成功。如果覆盖后发现 TiUP 运行报错，可能是 manifest 未更新导致，可尝试 `rm -rf ~/.tiup/manifests` 后再次运行以上命令。 在更新本地镜像后，如果需要升级本地集群，可参考[使用 TiUP 升级 TiDB](/upgrade-tidb-using-tiup.md#使用-tiup-升级-tidb)。 \ No newline at end of file From 506b4c7ba30b5f3667787c97fcdbc40ec977ba7a Mon Sep 17 00:00:00 2001 From: Chunzhu Li Date: Mon, 8 Jun 2020 13:19:45 +0800 Subject: [PATCH 3/7] split content to a new file --- TOC.md | 1 + production-offline-deployment-using-tiup.md | 17 ------------- quick-start-with-tidb.md | 2 +- upgrade-tidb-using-tiup-offline.md | 28 +++++++++++++++++++++ 4 files changed, 30 insertions(+), 18 deletions(-) create mode 100644 upgrade-tidb-using-tiup-offline.md diff --git a/TOC.md b/TOC.md index 01983e657a5c..5941c069a646 100644 --- a/TOC.md +++ b/TOC.md @@ -54,6 +54,7 @@ + 运维操作 + 升级 TiDB 版本 + [使用 TiUP（推荐）](/upgrade-tidb-using-tiup.md) + + [使用 TiUP 离线镜像（推荐）](/upgrade-tidb-using-tiup-offline.md) + [使用 TiDB Operator](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/upgrade-a-tidb-cluster/) + [使用 TiDB Ansible](/upgrade-tidb-using-ansible.md) + 扩缩容 diff --git a/production-offline-deployment-using-tiup.md b/production-offline-deployment-using-tiup.md index bd672e52e278..af72c908bd10 100644 --- a/production-offline-deployment-using-tiup.md +++ b/production-offline-deployment-using-tiup.md @@ -264,20 +264,3 @@ tiup cluster start tidb-test 预期日志结尾输出会有 ```Deployed cluster `tidb-test` successfully``` 关键词，表示部署成功。 部署完成后，集群相关操作可参考 [cluster 命令](/tiup/tiup-cluster.md)。 - -## 6. 更新 TiUP 离线镜像以升级本地集群 - -如果用户希望升级更新本地的 TiUP 离线镜像，可以参考本文的步骤 1 与步骤 2。在执行 `local_install.sh` 后，TiUP 会完成覆盖升级。 - -随后，需要按照 `local_install.sh` 执行的结果，重新声明全局环境变量，并将 TIUP_MIRRORS 指向执行 `local_install.sh` 命令时输出的离线镜像包的位置 `/path/to/mirror`。 - -{{< copyable "shell-regular" >}} - -```bash -source .bash_profile -export TIUP_MIRRORS=/path/to/mirror -``` - -此时离线镜像已经更新成功。如果覆盖后发现 TiUP 运行报错，可能是 manifest 未更新导致，可尝试 `rm -rf ~/.tiup/manifests` 后再次运行以上命令。 - -在更新本地镜像后，如果需要升级本地集群，可参考[使用 TiUP 升级 TiDB](/upgrade-tidb-using-tiup.md#使用-tiup-升级-tidb)。 \ No newline at end of file diff --git a/quick-start-with-tidb.md b/quick-start-with-tidb.md index 2a6c8e102f30..e796f8619512 100644 --- a/quick-start-with-tidb.md +++ b/quick-start-with-tidb.md @@ -246,7 +246,7 @@ TiDB-Wasm 是运行在浏览器中的 TiDB 数据库，打开网页即可使用 {{< copyable "shell-regular" >}} ```shell - tiup cluster deploy ./topo.yaml --user root + tiup cluster deploy ./topo.yaml --user root -p ``` - 参数 `` 表示设置集群名称 diff --git a/upgrade-tidb-using-tiup-offline.md b/upgrade-tidb-using-tiup-offline.md new file mode 100644 index 000000000000..02b70abdcdd9 --- /dev/null +++ b/upgrade-tidb-using-tiup-offline.md @@ -0,0 +1,28 @@ +--- +title: 使用 TiUP 离线镜像升级 TiDB +category: how-to +aliases: ['/docs-cn/dev/how-to/upgrade/using-tiup/'] +--- + +# 使用 TiUP 离线镜像升级 TiDB + +本文档适用于通过升级 TiUP 离线镜像升级 TiDB 集群。 + +## 1. 更新 TiUP 离线镜像 + +如果用户希望升级更新本地的 TiUP 离线镜像，可以参考[使用 TiUP 离线部署 TiDB 集群](/production-offline-deployment-using-tiup.md)的步骤 1 与步骤 2 下载部署新版本的 TiUP 离线镜像。在执行 `local_install.sh` 后，TiUP 会完成覆盖升级。 + +随后，需要按照 `local_install.sh` 执行的结果，重新声明全局环境变量，并将 TIUP_MIRRORS 指向执行 `local_install.sh` 命令时输出的离线镜像包的位置 `/path/to/mirror`。 + +{{< copyable "shell-regular" >}} + +```bash +source .bash_profile +export TIUP_MIRRORS=/path/to/mirror +``` + +此时离线镜像已经更新成功。如果覆盖后发现 TiUP 运行报错，可能是 manifest 未更新导致，可尝试 `rm -rf ~/.tiup/manifests` 后再使用 TiUP。 + +## 2. 升级 TiDB 集群 + +在更新本地镜像后，可参考[使用 TiUP 升级 TiDB](/upgrade-tidb-using-tiup.md#使用-tiup-升级-tidb)升级 TiDB 集群。 From c935c5a638774656cb07e466bae1ef4e0f57c4e4 Mon Sep 17 00:00:00 2001 From: Keke Yi <40977455+yikeke@users.noreply.github.com> Date: Mon, 8 Jun 2020 14:05:06 +0800 Subject: [PATCH 4/7] Update upgrade-tidb-using-tiup-offline.md --- upgrade-tidb-using-tiup-offline.md | 1 - 1 file changed, 1 deletion(-) diff --git a/upgrade-tidb-using-tiup-offline.md b/upgrade-tidb-using-tiup-offline.md index 02b70abdcdd9..98e4930e529d 100644 --- a/upgrade-tidb-using-tiup-offline.md +++ b/upgrade-tidb-using-tiup-offline.md @@ -1,7 +1,6 @@ --- title: 使用 TiUP 离线镜像升级 TiDB category: how-to -aliases: ['/docs-cn/dev/how-to/upgrade/using-tiup/'] --- # 使用 TiUP 离线镜像升级 TiDB From e7263afc755c149bf2827f1e8d1476281b1741e0 Mon Sep 17 00:00:00 2001 From: Chunzhu Li Date: Mon, 8 Jun 2020 14:11:13 +0800 Subject: [PATCH 5/7] address comments --- export-or-backup-using-dumpling.md | 2 +- upgrade-tidb-using-tiup-offline.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/export-or-backup-using-dumpling.md b/export-or-backup-using-dumpling.md index 6534d663ffd9..af2e8dc54355 100644 --- a/export-or-backup-using-dumpling.md +++ b/export-or-backup-using-dumpling.md @@ -92,7 +92,7 @@ Dumpling 可以通过 `--filter` 指定 table-filter 来筛选特定的库表。 -P 4000 \ -h 127.0.0.1 \ -o /tmp/test \ - --filter "employees.*" + --filter "employees.*" \ --filter "*.WorkOrder" ``` diff --git a/upgrade-tidb-using-tiup-offline.md b/upgrade-tidb-using-tiup-offline.md index 98e4930e529d..5d34d641460a 100644 --- a/upgrade-tidb-using-tiup-offline.md +++ b/upgrade-tidb-using-tiup-offline.md @@ -5,7 +5,7 @@ category: how-to # 使用 TiUP 离线镜像升级 TiDB -本文档适用于通过升级 TiUP 离线镜像升级 TiDB 集群。 +本文档适用于通过升级 TiUP 离线镜像升级 TiDB 集群，升级步骤如下。 ## 1. 更新 TiUP 离线镜像 From 6b50ef113e9aeebca2500e0e6b3c8a0a3cd236cf Mon Sep 17 00:00:00 2001 From: Chunzhu Li Date: Mon, 8 Jun 2020 14:21:12 +0800 Subject: [PATCH 6/7] address comments --- TOC.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TOC.md b/TOC.md index 20b05aef2364..62e64b921a2d 100644 --- a/TOC.md +++ b/TOC.md @@ -54,7 +54,7 @@ + 运维操作 + 升级 TiDB 版本 + [使用 TiUP（推荐）](/upgrade-tidb-using-tiup.md) - + [使用 TiUP 离线镜像（推荐）](/upgrade-tidb-using-tiup-offline.md) + + [使用 TiUP 离线升级（推荐）](/upgrade-tidb-using-tiup-offline.md) + [使用 TiDB Operator](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/upgrade-a-tidb-cluster/) + [使用 TiDB Ansible](/upgrade-tidb-using-ansible.md) + 扩缩容 From 537db93b2db478250bbb397455123659e337a76c Mon Sep 17 00:00:00 2001 From: Keke Yi <40977455+yikeke@users.noreply.github.com> Date: Mon, 8 Jun 2020 14:24:56 +0800 Subject: [PATCH 7/7] Update TOC.md Co-authored-by: kissmydb --- TOC.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TOC.md b/TOC.md index 62e64b921a2d..a4cf42d66550 100644 --- a/TOC.md +++ b/TOC.md @@ -53,7 +53,7 @@ + [从 SQL 文件迁移到 TiDB](/migrate-from-mysql-mydumper-files.md) + 运维操作 + 升级 TiDB 版本 - + [使用 TiUP（推荐）](/upgrade-tidb-using-tiup.md) + + [使用 TiUP 升级（推荐）](/upgrade-tidb-using-tiup.md) + [使用 TiUP 离线升级（推荐）](/upgrade-tidb-using-tiup-offline.md) + [使用 TiDB Operator](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/upgrade-a-tidb-cluster/) + [使用 TiDB Ansible](/upgrade-tidb-using-ansible.md)