add-leaf

Description

Add the node as a leaf to the cluster.

Usage

Add the node as a leaf to the cluster.

This command will add the specified node as a leaf node. It requires a running
master aggregator.

Examples:

    sdb-admin add-leaf --memsql-id 0123ABCDEF --password 'foo'

    sdb-admin add-leaf --host memsql-01 --port 3306 --password 'foo'

Usage:
  sdb-admin add-leaf [flags]

Flags:
      --availability-group int   The availability group to assign to the leaf
  -h, --help                     Help for add-leaf
      --host string              The cluster-addressable hostname for the leaf node
      --memsql-id MemsqlID       The node ID of the node to be added as a leaf node
  -p, --password STRING          The database user's password. If a password is specified on the command line, it must not contain an unescaped '$' character as it will be replaced by the shell.
                                 If a password is not specified on the command line, Toolbox will attempt to read the password from the ‘MEMSQL_PASSWORD’ environment variable.
                                 If this variable is present but does not contain a value, or if the variable does not exist, Toolbox will prompt for a password
      --port PORT                The cluster-addressable port for the leaf node
      --skip-validate-env        Skip environment validation
      --user string              The database user (default "root")

Global Flags:
      --backup-cache FILE_PATH              File path for the backup cache
      --cache-file FILE_PATH                File path for the Toolbox node cache
  -c, --config FILE_PATH                    File path for the Toolbox configuration
      --disable-colors                      Disable colored output in console, which some terminal sessions/environments may have issues with
      --disable-spinner                     Disable the progress spinner, which some terminal sessions/environments may have issues with
  -j, --json                                Enable JSON output
      --parallelism POSITIVE_INTEGER        Maximum number of operations to run in parallel
      --runtime-dir DIRECTORY_PATH          Where to store Toolbox runtime data
      --ssh-max-sessions POSITIVE_INTEGER   Maximum number of SSH sessions to open per host, must be at least 3
      --state-file FILE_PATH                Toolbox state file path
  -v, --verbosity count                     Increase logging verbosity: valid values are 1, 2, 3. Usage -v=count or --verbosity=count
  -y, --yes                                 Enable non-interactive mode and assume the user would like to move forward with the proposed actions by default

Remarks

  • When using this command, you should use --memsql-id rather than --host and/or --port.

  • --password is a required flag that specifies the SingleStore DB root password. You can optionally use this flag in conjunction with the --user flag to specify a SingleStore DB user that is different from the root user and the user’s password.

    Note that the MEMSQL_PASSWORD environment variable is a safer alternative option for setting the password.

  • Wrap the password in single quotes (') to avoid having special characters included in the password interpreted by the shell. For example: sdb-admin add-leaf --host memsql-01 --port 3306 --password '<<fooismypassword'

  • This command is interactive unless you use either --yes or --json flag to override interactive behavior.