ncmgr rehost

The rehost subcommand can be used to migrate the NC vovserver to a specified host. It works by leveraging the failover infrastructure. The following requirements must be satisfied before using the command.

1. Failover must be configured beforehand, in order to setup failover.
2. One of the failover taskers must be configured to run on the target host.
3. At least one of the failover taskers on the target host must have an acceptable status (in particular, not in BLACKHOLE, DEAD, PAUSED, SICK).
4. The target host must respond to a 'ping' check.
5. The nc rehost command must be executed from the current project host.

The command takes the form:

ncmgr [-q <queue>] rehost -host <new-host>

Since the rehost subcommand utilizes the failover infrastructure, it may take 2-3 minutes in order to take effect.

Use vovproject list to check the status while waiting.

vncmgr: Usage Message
        
DESCRIPTION:
Rehost an Accelerator queue.
Acts on the queue named 'vnc', unless -queue is used.
This triggers a failover that results in the project restarting on
the specified target host. Failover must be configured and there must
be a failover tasker running on the target host.
        
USAGE:
% ncmgr [-q queue] rehost -host <targetHost>

OPTIONS:
-queue               Specify name of queue to stop; default = vnc
                     if set, and otherwise vnc.
-force               Do not prompt for confirmation.
-host <targetHost>   Use failover to restart on <targetHost>.