Migrate a logical interface to a different port
Availability: This command is available to cluster administrators at the admin privilege level.
Description
The
network interface migrate command
migrates a logical interface to a port or interface group
on the node you specify.
Note: Manual migration of a logical interface
can take up to 15 seconds to complete.
Also, when you migrate a cluster logical interface,
you must do so from the local node.
Logical interface migration is a best-effort command,
and can only be completed if the destination node and port
are operational
Note: Logical interfaces for SAN protocols do not support migration. Attempts
to do so will result in an error.
Note: On some cloud platforms, this operation might perform changes to
the external route tables.
Parameters
- -vserver <vserver> - Vserver Name
- Use this parameter to specify
the Vserver that owns the logical interface that
is to be migrated.
- -lif <lif-name> - Logical Interface Name
- Use this parameter to specify
the logical interface that
is to be migrated.
- -destination-node <nodename> - Destination Node
- Use this parameter to specify
the node to which the logical interface
is to be migrated.
- [-destination-port {<netport>|<ifgrp>}] - Destination Port
- Use this parameter to specify
the port or interface group to which the logical interface
is to be migrated.
- [-force [true]] - Force Migrate Data LIF Flag (privilege: advanced)
- Use this parameter to force the migration operation.
Intended for disaster recovery only. Specifying this parameter
implies the LIF's current node is down and will skip removing the
LIF from its current node.
Examples
The following example migrates a logical interface named datalif1 on a Vserver named vs0 to port e0c on a node named node2:
cluster1::> network interface migrate -vserver vs0 -lif datalif1 -dest-node node2 -dest-port e0c