# Renaming a `TiDB` Cluster (On-premises)

__*zz-BGL*__

+ Use `cluster rename` to rename an existing cluster to a new name:

```
$ tiup cluster rename {old_name} {new_name}

~!@// Example@!~
$ tiup cluster rename test-asi test-asi2
tiup is checking updates for component cluster ...
Starting component `cluster`: /home/ubuntu/.tiup/components/cluster/v1.10.3/tiup-cluster rename test-asi test-asi2
Will rename the cluster name from test-asi to test-asi2.
Do you confirm this action? [y/N]:(default=N) ~!@y@!~
Rename cluster `test-asi` -> `test-asi2` successfully
Will reload the cluster test-asi2 with restart policy is true, nodes: , roles: grafana,prometheus.
Do you want to continue? [y/N]:(default=N) ~!@y@!~
.
.
.
Reloaded cluster `test-asi2` successfully
```
-------------------------------------------------------------
You can use the `tiup cluster rename` command to rename the cluster:

```
$ tiup cluster rename $ {old_name} ${new_name}
```

Renaming a cluster will cause monitoring framework to be restarted. And, `Grafana` may leave behind some panels with the old cluster name, and you need to manually delete these obsoleted panels.