Skip to main content
A newer release of this product is available.

network interface migrate

Contributors
Suggest changes

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