diff --git a/product/en/docs-ptk/v2.0/toc.md b/product/en/docs-ptk/v2.0/toc.md index 1fdd6fa7c3982154b7f5354676d2723feff412f3..efe2df4e9795c231ae7e9a55d0c98b864b5e82e2 100644 --- a/product/en/docs-ptk/v2.0/toc.md +++ b/product/en/docs-ptk/v2.0/toc.md @@ -6,7 +6,7 @@ + [关于PTK](./about.md) + 快速入门 - + [安装PTK](./quick-start/install-ptk.md) + + [安装PTK](./quick-start/install.md) + [部署示例数据库](./quick-start/ptk-demo.md) + 使用指南 + [准备配置文件](./guide/guide-prepare-config.md) diff --git a/product/zh/docs-ptk/v2.0/faq.md b/product/zh/docs-ptk/v2.0/faq.md index 0d9d86e925bc37ed20aa7c3cb6e5a79f6dfecbee..2ada01c0f79f04a7359370bc1ff2f0810eab5598 100644 --- a/product/zh/docs-ptk/v2.0/faq.md +++ b/product/zh/docs-ptk/v2.0/faq.md @@ -71,6 +71,44 @@ PTK 本身提供完整通用的安装流程,默认情况下,PTK 会针对客 不是的。PTK 工具是中心化多集群管理工具,所以我们更推荐 PTK 独立在一个管理服务器上安装,数据库在数据库专用的服务器集群内节点上安装。 +### 如果通过复制虚机创建了一个新的集群,如何修改IP来使得PTK正常工作 + +对于这种场景,我们首先需要根据PTK的使用方式来进行不同的处理: + +**1. PTK和集群是一对一进行管控** + +``` +# 比如有两个集群,分别使用两个PTK进行管理 + +PTK(1) ---> Cluster1 + +PTK(2) ---> Cluster2 +``` + +对于这种情况的话,可以通过直接使用 PTK(2) 执行如下命令进行IP的变更即可: + +```bash +ptk cluster -n refresh --replace-ip = +``` + +**2. PTK集中管控多个集群** + +``` + ┌----> Cluster 1 +PTK--┤ + └----> Cluster 2 +``` + +对于这种情况,不能直接替换IP,如果直接执行 refresh 替换IP的话,会导致PTK由管控 `cluster 1` 变为管控 `cluster 2`, `ptk ls` 将看不到集群1。 + +此时需要通过复制 PTK 的元数据来进行创建集群2的元数据: + +```bash +cp -r `ptk env PTK_DATA_DIR`/ `ptk env PTK_DATA_DIR`/ +vim `ptk env PTK_DATA_DIR`//topology.yml 打开修改集群名称、 ip 信息 +ptk cluster -n refresh +``` + ## 常见报错 ### 安装时报错:cmd init: ssh: setenv failed diff --git a/product/zh/docs-ptk/v2.0/guide/manage-cluster/manage-cluster-scale-in.md b/product/zh/docs-ptk/v2.0/guide/manage-cluster/manage-cluster-scale-in.md index 69a55fd84ae0e416f1d03c1b70cd1d78806665c9..955f47bcdc6b636a4d03af0e6d80968c790c16e7 100644 --- a/product/zh/docs-ptk/v2.0/guide/manage-cluster/manage-cluster-scale-in.md +++ b/product/zh/docs-ptk/v2.0/guide/manage-cluster/manage-cluster-scale-in.md @@ -26,7 +26,7 @@ ptk cluster -n scale-in [-H|--host HOST] [-i|--id ID] [--skip-cle ```text standby1 -- cascade_standby1, cascade_standby2 - / + / primary \ standby2 -- cascade_standby3 @@ -66,7 +66,7 @@ primary standby cascade_standby ### 集群可以扩容吗? -可以。参考[扩容文档](./manager-cluster-scale-out.md) +可以。参考[扩容文档](./manage-cluster-scale-out.md) ### 一直执行缩容,可以将集群缩为空吗? diff --git a/product/zh/docs-ptk/v2.0/guide/manage-cluster/manage-cluster-scale-out.md b/product/zh/docs-ptk/v2.0/guide/manage-cluster/manage-cluster-scale-out.md index fd98ea3c00de8a181b23b88ce4c28837ed9f2f76..495499e758274607a1494011da1c8917cebfe668 100644 --- a/product/zh/docs-ptk/v2.0/guide/manage-cluster/manage-cluster-scale-out.md +++ b/product/zh/docs-ptk/v2.0/guide/manage-cluster/manage-cluster-scale-out.md @@ -57,7 +57,7 @@ cm_servers: 执行扩容命令: ```shell -ptk cluster -n scale-out -c CONFIG.yaml [--build-from BUILD_FROM_HOST] [--skip-create-user] [--skip-check-os] [--skip-check-distro] [--default-guc] [--skip-rollback] [--skip-gen-ptkc] [--cpu CPU_MODEL] [--not-limit-cm-nodes] +ptk cluster -n scale-out -c CONFIG.yaml [--build-from BUILD_FROM_HOST] [--skip-create-user] [--skip-check-os] [--skip-check-distro] [--default-guc] [--skip-rollback] [--skip-gen-ptkc] [--cpu CPU_MODEL] [--not-limit-cm-nodes] ``` 参数说明: @@ -80,8 +80,8 @@ ptk cluster -n scale-out -c CONFIG.yaml [--build-from BUILD_FROM_ |--------|-------|-------|------| |db1,db2 |db3 |支持 | | |db1+cm1,db2+cm2,db3+cm3|db4+cm4|支持|| -|db1+cm1,db2+cm2,db3+cm3|db4|支持|| -|db1+cm1,db2+cm2,db3+cm3|cm4|支持|| +|db1+cm1,db2+cm2,db3+cm3|db4|支持|| +|db1+cm1,db2+cm2,db3+cm3|cm4|支持|| |db1+cm1,db2+cm2,db3|cm3|不支持|缩容 db3, 扩容 db3+cm3| |db1+cm1,db2+cm2,cm3|db3|不支持|缩容 cm3, 扩容 db3+cm3| @@ -89,7 +89,7 @@ ptk cluster -n scale-out -c CONFIG.yaml [--build-from BUILD_FROM_ ### 集群可以缩容吗? -可以。参考[缩容文档](./manager-cluster-scale-in.md) +可以。参考[缩容文档](./manage-cluster-scale-in.md) ### 扩容最高上限是什么? diff --git a/product/zh/docs-ptk/v2.0/quick-start/install-ptk.md b/product/zh/docs-ptk/v2.0/quick-start/install.md similarity index 100% rename from product/zh/docs-ptk/v2.0/quick-start/install-ptk.md rename to product/zh/docs-ptk/v2.0/quick-start/install.md diff --git a/product/zh/docs-ptk/v2.0/reference/ref-config.md b/product/zh/docs-ptk/v2.0/reference/ref-config.md index df512b74356c5f7946f043a974a98638f4bd4626..0de399088d445bd805e11e5368a2150cabe56072 100644 --- a/product/zh/docs-ptk/v2.0/reference/ref-config.md +++ b/product/zh/docs-ptk/v2.0/reference/ref-config.md @@ -6,7 +6,7 @@ date: 2024-06-01 # 配置文件 -PTK 的拓扑配置文件采用 [YAML格式](../yaml-grammar.md)。 +PTK 的拓扑配置文件采用 [YAML格式](../appendix/yaml-grammar.md)。 该文件介绍了拓扑配置文件的所有参数。 diff --git a/product/zh/docs-ptk/v2.0/toc.md b/product/zh/docs-ptk/v2.0/toc.md index d601668f3e220153ed9a46e60412160cfba3f225..3b7ee8a00a6a035228e7e105df0cfe62039bd1d2 100644 --- a/product/zh/docs-ptk/v2.0/toc.md +++ b/product/zh/docs-ptk/v2.0/toc.md @@ -6,7 +6,7 @@ + [关于PTK](./overview.md) + 快速入门 - + [安装PTK](./quick-start/install-ptk.md) + + [安装PTK](./quick-start/install.md) + [部署示例数据库](./quick-start/demo-db.md) + 使用指南 + [准备配置文件](./guide/guide-prepare-config.md) @@ -58,7 +58,7 @@ + [数据库推荐参数](./reference/ref-recommend-guc.md) + [对MogDB版本的支持](./reference/ref-support-mogdb.md) + [配置文件示例](./samples/samples-index.md) - + [本地单实例](./samples/samples-local.md) + + [本地单实例](./samples/samples-local-single.md) + [远程单实例](./samples/samples-remote-single.md) + [主备集群](./samples/samples-db-cluster.md) + [双网段](./samples/samples-double-ip.md)