3.6.0 Matrix Server Command Reference (5697-7083, December 2007)

Chapter 3: mx Commands 54

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

the prod matrix.

# production cluster

prod {

srv1 administrator secret1

srv2 administrator secret1

srv3 administrator 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 “administrator,” “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 administrator secret1 default {

srv1

srv2

srv3 administrator secret1 default

srv4 administrator secret2

}

Encrypted passwords in the .matrixrc file

Passwords are encrypted automatically when you use the Matrix Server

Connect window to specify the password. You can also use the

mxgenpass.exe command to create encrypted passwords for use in the

.matrixrc file. (Using encrypted passwords is optional.) The command is in the

installation directory, which is typically %SystemDrive%\Program

Files\PolyServe\MatrixServer\bin. (The command is also provided in the

MxConsole .msi file and can be accessed at %SystemDrive%\Program