2

mx Commands

The mx utility provides a command-line interface for administering a matrix and monitoring its operation.

Using the mx utility

The matrixrc file

The mx utility can be used both interactively and in scripts. Because matrix administration requires a password, Matrix Server uses an external configuration file named matrixrc to provide authentication. This file is required for mx operation and contains password information.

NOTE: The .matrixrc file is also used by the mxconsole utility. See “mxconsole

– start the Management Console” on page 11 for more information.

If you want to use the mx utility, create a matrixrc file that specifies your user names and passwords for each server that you want to access. The default location for the file is $HOME/.matrixrc. For security reasons, the file must not allow any permissions for group or other.

By default, the mx utility uses the .matrixrc file. However, you can specify a different configuration file with the --configoption.

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.

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

54

Page 59
Image 59
HP Clustered Gateway Device Management Software manual Using the mx utility, Matrixrc file