MaxCtrl Commands for MariaDB MaxScale
This page is part of MariaDB's Documentation.
The parent of this page is: Reference for MariaDB MaxScale
Topics on this page:
Overview
MariaDB MaxScale ships with a command-line utility and administrative console called MaxCtrl (maxctrl) to configure and manage MariaDB database product deployments through the MaxScale REST API. MaxCtrl supports many different commands.
Reference material is available for MariaDB MaxScale.
Usage
MaxCtrl commands can be run as command-line arguments:
$ maxctrl show services
Alternatively, if you need to execute several commands, you can open the administrative console by running MaxCtrl without arguments:
$ maxctrl
If authentication is enabled for MaxScale's REST API, the user name and password can be provided via the --user and --password options:
$ maxctrl --user='maxscale' \
--password='secure-password' \
show services
The default user name is admin, and the default password is mariadb.
MaxCtrl Commands by MariaDB MaxScale Version
Choose a version of MariaDB MaxScale to see the MaxCtrl Commands supported by that version:
Support Matrix by Version
A summary of MaxCtrl Commands across MariaDB MaxScale versions:
Command | In 25.01? | In 24.08? | In 24.02? | In 23.08? | In 23.02? | In 22.08? | In 6? | In 2.5? | In 2.4? |
|---|---|---|---|---|---|---|---|---|---|
Configuration File
MaxCtrl reads command-line options from the ~/.maxctrl.cnf configuration file.
The configuration file can be used to store common options, such as the user name and password:
[maxctrl]
user = maxscale
password = secure-password
MaxCtrl will refuse to use the ~/.maxctrl.cnf configuration file if it can be accessed by anyone other than the owner. Ensure that only the owner can access the file using the following command:
$ chown 0600 ~/.maxctrl.cnf
MaxCtrl can use a different configuration file by specifying the -c or --config option:
$ maxctrl --config=/maxscale/maxctrl.cnf \
show services