This is a read-only copy of the MariaDB Knowledgebase generated on 2024-11-22. For the latest, interactive version please visit https://mariadb.com/kb/.

CLI

CLI

The command line interface as used by maxadmin. The CLI router requires the use of the maxscaled protocol.

Configuration

Two components are required to run the command line interface for maxadmin; a service and a listener. The listener may either use a Unix domain socket or an internet socket.

The default entries required are shown below.

[CLI]
type=service
router=cli

# Unix Domain Socket
[CLI-Unix-Listener]
type=listener
service=CLI
protocol=maxscaled
socket=default

# Internet Socket
[CLI-Inet-Listener]
type=listener
service=CLI
protocol=maxscaled
address=localhost
port=6603

In the example above, two listeners have been specified; one that listens on the default Unix domain socket and one that listens on the default port. In the latter case, if the address= entry is removed, connections are allowed from any machine on your network.

In the former case, if the value of socket is changed and in the latter case, if the value of port is changed, maxadmin must be invoked with the -S and -P options, respectively.

If Unix domain sockets are used, the connection is secure, but maxadmin can only be used on the same host where MariaDB MaxScale runs. If internet sockets are used, the connection is inherently insecure but maxadmin can be used from another host than the one where MariaDB MaxScale runs.

Note that the latter approach is deprecated and will be removed in a future version of MariaDB MaxScale.

Content reproduced on this site is the property of its respective owners, and this content is not reviewed in advance by MariaDB. The views, information and opinions expressed by this content do not necessarily represent those of MariaDB or any other party.