# 练习-2: 对集群进行改名

## 练习目的
在本次练习中，我们将集群名由 tidb-test 改为 tidb-prod，之后改回 tidb-test。

## 前提条件
+ 注意，您的实验环境（包括 IP，端口号，用户名，密码和目录）可能和手册不同。
+ 可以连接到实验用虚拟机。
+ TiDB 数据库之前部署完毕。

## 步骤
-----------------------------------------------
#### 1. 使用 tiup 进行集群名修改:
```
 $ tiup cluster rename tidb-test tidb-prod
```

-----------------------------------------------
#### 2. 查看集群状态，发现集群名已经改为 tidb-prod:
```
 $ tiup cluster display tidb-prod
```

-----------------------------------------------
#### 3.使用 tiup 进行集群名修改，改为 tidb-test:
```
 $ tiup cluster rename tidb-prod tidb-test
```

-----------------------------------------------
#### 4. 查看集群状态，发现集群名已经改为 tidb-test:
```
 $ tiup cluster display tidb-test
```


-----------------------------------------------
## 输出样例

-----------------------------------------------
#### 步骤 2 输出参考
```
 $ tiup cluster display tidb-prod
tiup is checking updates for component cluster ...
Starting component `cluster`: /root/.tiup/components/cluster/v1.10.2/tiup-cluster display tidb-prod
Cluster type:       tidb
Cluster name:       tidb-prod
Cluster version:    v6.1.0
Deploy user:        tidb
SSH type:           builtin
Dashboard URL:      http://172.31.0.112:2379/dashboard
Grafana URL:        http://172.31.0.250:3000
ID                  Role          Host          Ports                            OS/Arch       Status  Data Dir                      Deploy Dir
--                  ----          ----          -----                            -------       ------  --------                      ----------
172.31.0.250:9093   alertmanager  172.31.0.250  9093/9094                        linux/x86_64  Up      /tidb-data/alertmanager-9093  /tidb-deploy/alertmanager-9093
172.31.0.250:3000   grafana       172.31.0.250  3000                             linux/x86_64  Up      -                             /tidb-deploy/grafana-3000
172.31.0.112:2379   pd            172.31.0.112  2379/2380                        linux/x86_64  Up|UI   /tidb-data/pd-2379            /tidb-deploy/pd-2379
172.31.0.250:2379   pd            172.31.0.250  2379/2380                        linux/x86_64  Up|L    /tidb-data/pd-2379            /tidb-deploy/pd-2379
172.31.0.253:2379   pd            172.31.0.253  2379/2380                        linux/x86_64  Up      /tidb-data/pd-2379            /tidb-deploy/pd-2379
172.31.0.250:9090   prometheus    172.31.0.250  9090/12020                       linux/x86_64  Up      /tidb-data/prometheus-9090    /tidb-deploy/prometheus-9090
172.31.0.106:4000   tidb          172.31.0.106  4000/10080                       linux/x86_64  Up      -                             /tidb-deploy/tidb-4000
172.31.0.45:9000    tiflash       172.31.0.45   9000/8123/3930/20170/20292/8234  linux/x86_64  Up      /tidb-data/tiflash-9000       /tidb-deploy/tiflash-9000
172.31.0.215:20160  tikv          172.31.0.215  20160/20180                      linux/x86_64  Up      /tidb-data/tikv-20160         /tidb-deploy/tikv-20160
172.31.0.34:20160   tikv          172.31.0.34   20160/20180                      linux/x86_64  Up      /tidb-data/tikv-20160         /tidb-deploy/tikv-20160
172.31.0.85:20160   tikv          172.31.0.85   20160/20180                      linux/x86_64  Up      /tidb-data/tikv-20160         /tidb-deploy/tikv-20160
Total nodes: 11
```

-----------------------------------------------
#### 步骤 4 输出参考
```
  $ tiup cluster display tidb-test
tiup is checking updates for component cluster ...
Starting component `cluster`: /root/.tiup/components/cluster/v1.10.2/tiup-cluster display tidb-test
Cluster type:       tidb
Cluster name:       tidb-test
Cluster version:    v6.1.0
Deploy user:        tidb
SSH type:           builtin
Dashboard URL:      http://172.31.0.112:2379/dashboard
Grafana URL:        http://172.31.0.250:3000
ID                  Role          Host          Ports                            OS/Arch       Status  Data Dir                      Deploy Dir
--                  ----          ----          -----                            -------       ------  --------                      ----------
172.31.0.250:9093   alertmanager  172.31.0.250  9093/9094                        linux/x86_64  Up      /tidb-data/alertmanager-9093  /tidb-deploy/alertmanager-9093
172.31.0.250:3000   grafana       172.31.0.250  3000                             linux/x86_64  Up      -                             /tidb-deploy/grafana-3000
172.31.0.112:2379   pd            172.31.0.112  2379/2380                        linux/x86_64  Up|UI   /tidb-data/pd-2379            /tidb-deploy/pd-2379
172.31.0.250:2379   pd            172.31.0.250  2379/2380                        linux/x86_64  Up|L    /tidb-data/pd-2379            /tidb-deploy/pd-2379
172.31.0.253:2379   pd            172.31.0.253  2379/2380                        linux/x86_64  Up      /tidb-data/pd-2379            /tidb-deploy/pd-2379
172.31.0.250:9090   prometheus    172.31.0.250  9090/12020                       linux/x86_64  Up      /tidb-data/prometheus-9090    /tidb-deploy/prometheus-9090
172.31.0.106:4000   tidb          172.31.0.106  4000/10080                       linux/x86_64  Up      -                             /tidb-deploy/tidb-4000
172.31.0.45:9000    tiflash       172.31.0.45   9000/8123/3930/20170/20292/8234  linux/x86_64  Up      /tidb-data/tiflash-9000       /tidb-deploy/tiflash-9000
172.31.0.215:20160  tikv          172.31.0.215  20160/20180                      linux/x86_64  Up      /tidb-data/tikv-20160         /tidb-deploy/tikv-20160
172.31.0.34:20160   tikv          172.31.0.34   20160/20180                      linux/x86_64  Up      /tidb-data/tikv-20160         /tidb-deploy/tikv-20160
172.31.0.85:20160   tikv          172.31.0.85   20160/20180                      linux/x86_64  Up      /tidb-data/tikv-20160         /tidb-deploy/tikv-20160
Total nodes: 11
```