3.4.0 Matrix Server Command Reference

Chapter 2: mx Commands 44

The entries in the matrixrc file have this format:

machine user password default

• The first field, machine, is either the name or IP address of the server.

• The second field, user, is optional. It is the name of a user on that server,

either admin for the administrator or another name for a read-only user.

• The third field is also optional and contains the PolyServe Matrix Server

password for that user. The password is encrypted automatically when

you use the PolyServe Matrix Server Connect window to specify the

password. A utility is also available to encrypt the password. (See

“Encrypted passwords in the .matrixrc file” on page 46.)

NOTE: In PolyServe Matrix Server releases earlier than 3.x, the mx

command cannot interpret encrypted passwords. If you are using

mx and connect to a matrix running one of these versions of

PolyServe Matrix Server, you will be asked whether you want

PolyServe Matrix Server to create a temporary .matrixrc file that

contains clear passwords. The temporary file will be deleted when

the mx command is complete.

•The fourth field, default, specifies that this server will be connected to by

default if a server name is not specified on the command line. Specifying

a default server is optional in PolyServe Matrix Server 3.2.x and later

releases.

Blank lines and lines beginning with a # character are ignored.

NOTE: Comments can be lost when the .matrixrc file is edited via the

PolyServe Matrix Server Connect window.

Specify servers in the .matrixrc file

If you need to control which server is used for the mx connection, list the

servers individually in the matrixrc file or use the mx --matrix command-line

option. If any server can be used for the connection, you can group the

servers.