3.1.2 Matrix Server Command Reference

Chapter 2: mx Commands 56

In the following command, --matrix srv8 matches the wildcard. When the

--matrix option is not specified, the connection is made to srv3, the default;

the machine specified as the default cannot contain a wildcard.

mx --matrix srv8 server status

Group servers

This method allows mx to connect to any available server in the cluster

without the need to specify a server name on the command line. To use this

method, enclose the server entries in brackets, as in the following example for

the prod matrix.

# production cluster

prod {

srv1 admin secret1

srv2 admin secret1

srv3 admin secret1 default

}

To connect to the matrix, include the option --matrix prod in the mx

command. mx first attempts to access srv3, the default. If that server is not

available, the command tries the other servers in the group.

If your servers mostly use the same username and password, to simplify

configuring the .matrixrc file, you can specify those values following the

cluster name. You then only need to specify the values if they are different for

a particular server.

In the following example, the values “admin,” “secret1,” and “default” are

specified. The “default” value tells mx to first attempt to connect to the

default server, and then try the other servers in the list. If “default” is omitted,

the mx command will attempt to connect to the servers in the order that they

are specified in the list.

# production cluster

prod admin secret1 default {

srv1

srv2

srv3 admin secret1 default

srv4 admin secret2

}