3.6.0 Matrix Server Command Reference (5697-7083, December 2007)

Chapter 3: mx Commands 117

add—Add a new virtual host

mx vhost add [--application <application>] [--policy

nofailback|autofailback] [--activitytype single|always] <vhost>

<<networkinterface> ...|ALL_SERVERS <network interface>>

The options are:

[--application <application>]

The Matrix Server application associated with this virtual host. If you do not

specify an application, the IP address for the virtual host will be used.

[--policy

autofailback|nofailback]

The failback action that the virtual host will take following failover to a

backup node. autofailback will fail back when a higher-ranked node

provides equal or greater services than the backup node; nofailback fails

back only if a higher-ranked node provides greater services than the backup

node. autofailback is the default.

[--activitytype single|always]

Whether, upon server failure, the virtual host will move to an active server if

all associated service and device monitors are inactive or down. If always is

specified, the failover will occur. If single is specified, the failover will not

occur and the virtual host will not be made active anywhere. single is the

default.

<vhost> can be either the hostname or the IP address for the virtual host. If you

specify the hostname, it can include up to 32 characters.

The order in which you specify the network interfaces determines the

ordering for failover. The first network interface is the primary interface;

network traffic for the virtual host goes to the server providing this interface.

The remaining network interfaces are backups. Each network interface must

be located on a different server.

delete—Delete a virtual host

mx vhost delete <vhost> ...

move rehost, or move, a virtual host to another server

status show status for a virtual host

update modify an existing virtual host

Command Description