3.4.0 Matrix Server Command Reference

Chapter 2: mx Commands 46

# 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

}

Encrypted passwords in the .matrixrc file

Passwords are encrypted automatically when you use the PolyServe 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

Files\PolyServe\ManagementConsole\bin on servers where the Console is

installed.)