Skip to content

Latest commit

 

History

History
36 lines (24 loc) · 2.19 KB

tiup-component-cluster-edit-config.md

File metadata and controls

36 lines (24 loc) · 2.19 KB
Raw
title summary
tiup cluster edit-config
The `tiup cluster edit-config` command allows you to modify the cluster configuration after deployment. You can use an editor to modify the topology file, specified in the `$EDITOR` environment variable. Note that you cannot add or delete machines when modifying the configuration. After executing the command, the configuration is modified only on the control machine, and you need to execute `tiup cluster reload` to reload the configuration.

tiup cluster edit-config

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.

Note:

  • 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-config command, the configuration is modified only on the control machine. Then you need to execute the tiup cluster reload command to reload the configuration.

Syntax

tiup cluster edit-config <cluster-name> [flags]

<cluster-name> is the cluster to operate on.

Option

-h, --help

  • Prints help information.
  • Data type: BOOLEAN
  • 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 true value or do not pass any value.

Output

  • 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.

<< Back to the previous page - TiUP Cluster command list