Chapter 2: mx Commands

55

The second field, user, 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 the Matrix Server password for that user.

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.

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

If you need to control which server is used for the mx connection, list the servers individually in the matrixrc file. If any server can be used for the connection, you can group the servers.

List servers individually

Add a line to the file for each server for which you want mx access and specify the appropriate username and password. This example specifies that srv3 is the default.

srv1 admin secret1 srv2 admin secret1

srv3 admin secret2 default

When you issue a mx command without specifying a server name, as in the following example, it connects to the machine specified as the default in the

.matrixrc file.

mx server status

To connect to a different server, include the --matrixoption and specify the server name on the command line. For example, the following command connects to server acme1 as user admin using the password secret1.

mx --matrix srv1 server status

Use wildcards

You can use wildcards in the .matrixrc file to match machine names:

srv* admin secret1

srv3 admin secret1 default

Copyright © 1999-2006 PolyServe, Inc. All rights reserved.

Page 60
Image 60
HP Clustered Gateway Device Management Software manual Matrixrc file, Mx server status, Mx --matrix srv1 server status