pxc_scheduler_handler statements

Statement reference

The standard pxc_scheduler_handler statement includes percona-scheduler-admin --config-file=<configuration file name and extension>. A pxc_scheduler_handler example statement has the following syntax:

percona-scheduler-admin --config-file=config.toml [option] [option]

If you do not include the configuration file in the command, the result is an error and nothing happens.

$ percona-scheduler-admin --debug
ERROR : The --config-file option is required but is missing from the command.

The options determine what the statement does. The pxc_scheduler_handler statement must include at least one option. A command without an option returns an error and nothing happens.

For most options, two hyphens (–) precede an option name. The disable and the enable option can be selected with one hyphen (-) and the appropriate abbreviation.

For example, the following commands return the same result:

$ percona-scheduler-admin --config-file=config.toml -e

$ percona-scheduler-admin --config-file=config.toml --enable

You can combine some options with other, optional options to modify the statement behavior. Multiple options are separated by a space. You can combine the options in any order.

An example of combining options in one statement:

$ percona-scheduler-admin --config-file=config.toml --write-node=127.0.0.1:4130 --update-cluster

For some options, they must be combined with a required option to return a result.

An example of an option combined with a required option:

$ percona-scheduler-admin --config-file=config.toml --force -e

If you do not combine the option with the required option, the statement does not run and returns an error.

$ percona-scheduler-admin --config-file=tests/testsuite.toml  --update-write-weight="127.0.0.1:33,112"

Expected output

ERROR : --update-write-weight requires --update-cluster.

Specific options, such as -–write-node or –-server, require a value.

$> percona-scheduler-admin --config-file=config.toml --server=192.168.56.32:3306

For the available options, see pxc_scheduler_handler options

---

Last update: 2025-04-22