3.4.0 Matrix Server Command Reference

Chapter 2: mx Commands 50

mx device – device monitor commands

Use the following commands to configure device monitors or to display their

status.

Add a device monitor:

mx device add --servers <server1>,<server2>,...

[optional-arguments] <devicename> ...

--servers specifies the server or servers that use the monitored device. The

<devicename> can include up to 32 characters.

The arguments are:

[--application <application>]

The application associated with this device monitor.

[--timeout <seconds>]

The maximum amount of time to wait for a probe of the device to complete.

For

CUSTOM device monitors, the default is 60 seconds. For NTSERVICE

device monitors, the default is 15 seconds. For

other device monitors, the

default is five seconds.

[--frequency <seconds>]

The interval at which the monitor probes the device. For GATEWAY device

monitors, the default is five seconds. For

CUSTOM device monitors, the

default is 60 seconds. For

other device monitors, the default is 30 seconds.

[--type CUSTOM|DISK|GATEWAY|SHARED_FILESYSTEM|NTSERVICE]

The type of device monitor.

[--probeSeverity nofailover|autorecover|noautorecover]

The failover behavior for the monitor. nofailover prevents failover of virtual

hosts when the monitored device fails. autorecover fails over the virtual

hosts, and when the device is restored, fails the virtual hosts back to the

original network interfaces. noautorecover fails over the virtual hosts but

does not fail them back after the device is restored. The default is

autorecover. These settings work in combination with the virtual host’s

failback policy.