Home / Troubleshooting / Decommissioning & Repurposing ONTAP

Decommissioning & Repurposing ONTAP

Retiring a node, a shelf, or a whole cluster — or handing used gear to a homelab — has a specific order of operations. Get it wrong and you lose licenses, get stuck on audit volumes, or hand a support headache to the next owner. This runbook covers the full lifecycle: backup, removal, sanitization, and repurposing.

NetApp FAS controller prepared for decommissioning or repurposing

1. Phase 0 — Plan and back everything up first

Before any hardware moves, capture the configuration and the license picture. You cannot rebuild either from memory.

# Full configuration backup (to a location NOT on this system!)
system configuration backup create -node * -type full
system configuration backup show
# License inventory — record every serial number before it disappears
system license show
# What data still lives here? Who needs to sign off before it is destroyed?
volume show -fields volume,vserver,aggregate,used,percent-used
# AutoSupport off so the soon-to-be-dead system stops filing cases
system node autosupport modify -node * -state disabled

2. Phase 1 — Quiesce data and finalize replication

Clients stop first, then the replication layer, then the storage:

  1. Stop application writes (maintenance window, unmount NFS/SMB, offline the VMs).
  2. Final SnapMirror update so the destination is current, or break the relationship cleanly if the destination is now the source of truth: snapmirror update -destination-path svm_dst:vol1 then snapmirror break -destination-path svm_dst:vol1 — see the SnapMirror guide.
  3. Take a final snapshot as a belt-and-braces recovery point: snapshot create -vserver vs1 -volume vol1 -snapshot pre-decom.
  4. Document the SVM/IP space/network dependencies so a later audit can answer "what was this?"

3. Phase 2 — Remove the node or cluster cleanly

Removing a node from a healthy cluster is a supported operation; removing it from a broken one is where the stuck-volume stories come from.

# Pre-flight: no volumes/SVMs left that live on this node
volume show -node node2 -fields volume,vserver,aggregate,state
# On the surviving node, remove the node from cluster membership
cluster remove-node -node node2 -skip-lif-migration false
# Or halt it for a maintenance-style removal:
system node halt -node node2 -reason "decommissioning"
Stuck audit volumes and other removal blockers A classic gotcha when decommissioning: the audit volume (used by vserver audit for file-access logging) is not deletable while auditing is enabled, and an undeletable volume blocks node removal. Disable auditing first, then delete the volume: vserver audit disable -vserver vs1, then volume delete -vserver vs1 -volume vs1_audit_vol (names vary). Same pattern applies to any volume with an active consumer — SnapMirror sources, SnapVault destinations, Vault secondaries, and clone parents all refuse deletion until their relationships are broken.

4. Phase 3 — Sanitize data before the gear leaves

If the disks (or the whole node) are leaving your control, sanitize them. For FIPS/SED (NSE) disks, a crypto-erase is fast and complete; for others use secure erase or physical destruction.

# Verify which disks are self-encrypting (NSE) — crypto-erase is an option
storage disk show -fields disk,is-fips-certified,is-self-encrypting
# Secure erase (ONTAP 9.7+, advanced privilege) — DESTROYS ALL DATA on the disks
set -privilege advanced
storage disk secure-erase -disk <list-of-disks>
set -privilege admin

5. Phase 4 — Repurposing used shelves and disks

Used NetApp shelves on a different system — a very common homelab move — mostly works, with caveats:

6. Phase 5 — Close the loop

When to call support Decommissioning is usually unglamorous — but call support if: a volume refuses deletion for a reason you can't find (audit is the usual culprit), cluster remove-node fails on a partially-dead node, or you need the documented secure-erase/RMA procedure for your exact platform and ONTAP release.

Related: aggregate capacity · hardware lineup · volume space exhaustion · ← All troubleshooting guides