3.5.1 Matrix Server Command Reference

Chapter 2: mx Commands 58

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

}

NOTE:

Although the mx and mxconsole commands can access clusters

running different versions of Matrix Server, the .matrixrc file can

include groups and wildcards only when connecting to servers

running Matrix Server 3.0 or later. Also, earlier versions of Matrix

Server require that a default server be specified in the matrixrc file.

If you will be connecting to a matrix running an earlier version of

Matrix Server and want to use grouping or wildcards, you can create a

separate matrixrc file for that matrix and specify it with --config.

mx syntax

The mx utility has the following syntax:

mx [mx_options] class command [command_options]

The mx_options affect an entire mx command session. The options are:

--help

Displays a command summary.