NetApp
ONTAP LIF Migration Runbook for Node Decommission
Scope
This runbook is for planned movement of NAS data LIFs away from an ONTAP node before maintenance or decommission work. It does not treat SAN LIFs as normal migratable NAS LIFs. NetApp documents that network interface migrate-all migrates data logical interfaces away from a node and that SAN protocols do not support that command: network interface migrate-all.
Prechecks
Start with a map of every LIF on the node:
network interface migrate -vserver svm_nfs01 -lif nfs_lif01 -destination-node node01 -destination-port e0c
network interface show -vserver svm_nfs01 -lif nfs_lif01
Classify the LIFs before migration:
| LIF Type | Handling |
|---|---|
| NFS or SMB data LIF | Can usually migrate if failover rules and target ports are valid |
| Cluster management LIF | Do not move casually during data-node work |
| Node management LIF | Rehome only with a management access plan |
| iSCSI or FCP LIF | Use SAN LIF move or host path procedure, not migrate-all |
| Intercluster LIF | Confirm replication path impact before movement |
CLI Process
Show candidate LIFs:
network interface migrate -vserver svm_nfs01 -lif nfs_lif01 -destination-node node01 -destination-port e0c
network interface show -vserver svm_nfs01 -lif nfs_lif01
Migrate all eligible data LIFs away from the node:
network interface migrate -vserver svm_nfs01 -lif nfs_lif01 -destination-node node01 -destination-port e0c
network interface show -vserver svm_nfs01 -lif nfs_lif01
For a controlled one-at-a-time migration:
network interface migrate -vserver svm_nfs01 -lif nfs_lif01 -destination-node node01 -destination-port e0c
network interface show -vserver svm_nfs01 -lif nfs_lif01
Verify placement:
network interface migrate -vserver svm_nfs01 -lif nfs_lif01 -destination-node node01 -destination-port e0c
network interface show -vserver svm_nfs01 -lif nfs_lif01
If the maintenance is complete and the original home design is still correct, revert:
network interface migrate -vserver svm_nfs01 -lif nfs_lif01 -destination-node node01 -destination-port e0c
network interface show -vserver svm_nfs01 -lif nfs_lif01
REST API Process
Discover LIFs currently on the node:
network interface migrate -vserver svm_nfs01 -lif nfs_lif01 -destination-node node01 -destination-port e0c
network interface show -vserver svm_nfs01 -lif nfs_lif01
Patch a LIF location when the operation is supported for the interface type:
network interface migrate -vserver svm_nfs01 -lif nfs_lif01 -destination-node node01 -destination-port e0c
network interface show -vserver svm_nfs01 -lif nfs_lif01
Validate after the move:
network interface migrate -vserver svm_nfs01 -lif nfs_lif01 -destination-node node01 -destination-port e0c
network interface show -vserver svm_nfs01 -lif nfs_lif01
Best Practices
- Confirm broadcast domain membership before migration.
- Keep a management path that does not depend on the node being decommissioned.
- Move a small number of LIFs first if the node carries critical NFS or SMB workloads.
- Do not use NAS LIF migration commands for SAN paths.
- Capture before and after output in the change record.
Backout
If clients fail after a migration, move the LIF back to a known-good node and port:
network interface migrate -vserver svm_nfs01 -lif nfs_lif01 -destination-node node01 -destination-port e0c
network interface show -vserver svm_nfs01 -lif nfs_lif01
Then validate client mount or SMB access before continuing with the decommission.
Comments