If you need to modify the cluster configuration after the cluster is deployed, you can use the
tiup cluster edit-config command that starts an editor for you to modify the topology file of a cluster. This editor is specified in the
$EDITOR environment variable by default. If the
$EDITOR environment variable does not exist, the
vi editor is used.
- When you modify the configuration, you cannot add or delete machines. For how to add machines, see Scale out a cluster. For how to delete machines, see Scale in a cluster.
- After you execute the
tiup cluster edit-configcommand, the configuration is modified only on the control machine. Then you need to execute the
tiup cluster reloadcommand to reload the configuration.
tiup cluster edit-config <cluster-name> [flags]
<cluster-name> is the cluster to operate on.
- Prints help information.
- Data type:
- This option is disabled by default and its default value is
false. To enable this option, you can add this option to the command, and pass the
truevalue or do not pass any value.
- If the command is successfully executed, there is no output.
- If you have mistakenly modified the fields that cannot be modified, when you save the file, an error will be reported, reminding you to edit the file again. For the fields that cannot be modified, see the topology file.