AFF/FAS ONTAP 9 · Disk Qualification Package (qualification metadata) · advanced download and admin verification
Illustrative cluster: lab-01 and lab-02 need the same approved current DQP before drive firmware work, and DQP is rechecked after an ONTAP upgrade. The downloaded file is called qual_devices.zip in this example; use the exact filename and instructions supplied by NetApp. The URL http://192.0.2.80:8080/dqp/qual_devices.zip is a fictional maintenance endpoint. No package date or file-format version shown in this guide is a claim about the latest NetApp release.
About the command and output examples
Names, addresses and results are illustrative. Commands have not been executed against a live storage system or SAN switch for this publication. Confirm syntax and compatibility for your release, then rehearse in an approved lab. Existing-data recovery and destructive changes need an environment-specific plan. Read the editorial standards.
01Understand what DQP changes and when it is required
DQP contains qualification information used to support drive/device combinations. Updating that information is different from flashing a drive’s firmware or installing an ONTAP software image. It does not replace Hardware Universe checks for the actual system, shelf, drive type and capacity. NetApp calls for a DQP update before drive firmware work or introducing newly qualified drive types/sizes, and after an ONTAP upgrade. The ONTAP upgrade itself does not refresh DQP.
| Situation | Action | What it does not prove |
|---|---|---|
| Before disk firmware maintenance | Confirm and update the current DQP first | The drive firmware has not yet been activated |
| New drive type or capacity | Check current qualification package and hardware support | A package cannot make unsupported hardware supported |
| After ONTAP upgrade | Check every node and refresh the required DQP | The new ONTAP image did not perform this separate update |
| Periodic maintenance | Review current support downloads under your maintenance policy | An old file-format version number alone does not identify the newest package |
DQP is treated as qualification metadata with its own before/after evidence, not as a software or drive firmware upgrade.
02Record DQP details on each node before changing anything
- Save package date, file version, filename and record counts for every relevant node. The detailed display can expose differences hidden by looking at only one node.
- Compare nodes and the approved downloaded package. The file version describes the qualification file format; the package date and identity help distinguish package revisions. Do not use a made-up universal current version or assume that a newer download must change the format version.
- Record any existing hardware/qualification alert and its device identity before the update. A before/after comparison must separate an existing unsupported device from an actual update failure.
storage dqp show
storage dqp show -instance
storage dqp show -node lab-01 -instance
storage dqp show -node lab-02 -instance
cluster show
storage failover show
system health alert showBoth node baselines are recorded, including detailed package identity and any existing relevant alert.
03Obtain the supported DQP and preserve its integrity
The ZIP inspection is a useful operator check, not permission to invent an extraction/install sequence. If NetApp supplies a different file or install format, use that actual file and its instructions. Keep the repository path exact so the controller does not receive an HTML redirect or authentication page instead of the package.
- Sign in to the NetApp Support Site and select the Disk Qualification Package download appropriate to the supported environment. Read the download’s installation notes and any platform/release restrictions.
- Retain the actual filename, package date/identity, vendor-provided checksum information and a clean copy of the package. Do not choose a random forum attachment or rename an unrelated firmware archive to the DQP filename.
- Compare the downloaded package’s integrity with the vendor value using the algorithm supplied. Keep an archive as packaged when its instructions require it; do not manually replace qualification files in the ONTAP filesystem.
# Linux staging host; compare with the vendor value using the same algorithm:
sha256sum /srv/netapp/dqp/qual_devices.zip
# If the approved download is a ZIP archive, inspect without altering it:
unzip -l /srv/netapp/dqp/qual_devices.zipThe file is the authorized DQP, its integrity is checked, and the package instructions are retained.
04Prepare a reachable controlled endpoint
- Make the file available from a supported endpoint reachable from each intended node. Limit access and lifetime according to your maintenance standard. The sample HTTP server is for download, not receiving sensitive configuration backups.
- Check the exact path, response and byte size. A successful test from your laptop does not prove a controller’s route is permitted; the per-node ONTAP download is the actual transfer test.
- Use the transfer schemes supported by storage firmware download on your release. Do not assume that every URL scheme accepted by system node image get is also accepted by this command.
# Linux staging host on the maintenance network:
python3 -m http.server 8080 --bind 192.0.2.80 --directory /srv/netapp
# From an authorized operator machine:
curl -I http://192.0.2.80:8080/dqp/qual_devices.zipThe endpoint serves the unchanged DQP file and the approved node network can reach it.
05Install the package on the first intended node
Although the command family is storage firmware download, this invocation supplies qualification metadata. There is no additional requirement to run storage disk firmware update to activate a DQP. Doing so would begin a different, potentially disruptive operation.
- Run the download for the explicit node name. Review completion and any unpacking/copy error rather than accepting a message that transfer merely started.
- Return to admin privilege and inspect lab-01’s DQP details. Compare with the expected package identity; do not rely on a command exit alone.
- If the package remains unchanged, determine whether the node was already current or whether installation failed. Preserve the full message and verify the actual served file before retrying.
set -privilege advanced
storage firmware download -node lab-01 -package-url http://192.0.2.80:8080/dqp/qual_devices.zip
set -privilege admin
storage dqp show -node lab-01 -instanceThe first node shows the approved DQP identity with no unresolved installation error.
06Repeat for the partner and enumerate any additional nodes
- Use the same approved file for the partner and confirm its completion independently. An HA relationship does not substitute for checking the qualification information on each node.
- For clusters with more than two nodes, retain an explicit checklist of all intended nodes and run/verify the corresponding per-node downloads. Do not let a wildcard hide an individual failure.
- Compare expected package date, file version, filename and appropriate record counts across the intended nodes. Different hardware inventories should not be used as an excuse for an unexplained old package on one partner.
set -privilege advanced
storage firmware download -node lab-02 -package-url http://192.0.2.80:8080/dqp/qual_devices.zip
set -privilege admin
storage dqp show -node lab-02 -instance
storage dqp show -instanceEvery intended node is covered and no unexpected package mismatch remains.
07Complete DQP postchecks before starting drive work
| Postcheck | Required evidence | Do not infer |
|---|---|---|
| DQP identity | Expected package on every intended node | A single node’s success is not cluster-wide success |
| Qualification symptoms | Existing/new device alerts investigated | An alert is not fixed merely because DQP is newer |
| Drive model support | Hardware Universe and package compatibility agree | DQP cannot legitimize an unsupported drive |
| Disk firmware | Baseline retained; changed only if separately intended | DQP installation is not a disk firmware flash |
| Storage/HA | Expected normal state and paths | No client complaint is not a full hardware check |
| Service | Representative client transaction passes | A management login does not validate NAS/SAN data access |
- Compare postcheck output with the baseline. If the intended scope was DQP only, any unexpected firmware action or availability change requires explanation.
- When drive firmware or a drive addition follows, confirm qualification acceptance first and then use that separate procedure’s preconditions.
- Retain the post-update record with node names, package identity, timestamp, download result and exception disposition.
storage dqp show -instance
storage disk show -fields model,firmware-revision
storage disk show -broken
storage aggregate show
storage shelf show -connectivity
storage failover show
system health alert show
event log show -time >1hQualification data is accepted on all nodes, hardware remains normal and downstream drive work has a valid starting state.
08Diagnose transfer, unpacking and package mismatch failures
NetApp documents DQP failures involving unpacking and writes to internal locations. Do not use systemshell deletion, permission changes or manual edits to qualification files as a generic public runbook fix. Those changes require a specific diagnosis and the supported repair procedure. Keep the previous successful node’s evidence while investigating the failed partner.
| Symptom | Useful checks | Next action |
|---|---|---|
| URL not found or wrong bytes | Exact path, server log, response and checksum | Fix the staging endpoint and retry the intended node |
| One node works; partner transfer fails | Node-specific route/firewall/DNS and server access log | Resolve that node’s transfer path |
| Unpacking or write/copy error | Full command error, package integrity and relevant node events | Preserve evidence and engage support for ONTAP filesystem issues |
| Same file version after update | Package date, filename and expected download identity | Determine whether format stayed the same or the node was already current |
| Different package dates after the change | Per-node output and download completion | Complete/investigate the specific missing node |
| Qualification warning persists | Actual device identity and supported hardware matrix | Investigate the device; do not keep blindly reinstalling DQP |
The investigation identifies the failed node, exact error and package identity instead of treating every DQP problem as a need for another download.
09Worked mismatch example and final sign-off
Synthetic example: before the change, both nodes report package A. After the first download, lab-01 reports approved package B while lab-02 still reports A. The format version is unchanged on both. This does not mean the update failed on lab-01 or that A and B are identical; compare the package dates and record identity. Install/verify the intended B package on lab-02, then rerun the cluster-wide detailed display.
A clean final record states the real approved package identity, every covered node and whether any separate disk firmware or drive addition was performed. Avoid reporting DQP and drive firmware as one indistinguishable upgrade.
- Accept the DQP-only change only after the identity and hardware/service postchecks pass.
- Remove or stop the temporary image service when it is no longer needed under the maintenance plan. Keep the authorized package and installation evidence in the change record.
- If an ONTAP upgrade was also performed, attach this per-node DQP record to its postcheck acceptance.
storage dqp show -instance
system node autosupport invoke -node * -type all -message "DQP_UPDATE_ACCEPTED"The final record proves which DQP was installed where and distinguishes it from software and drive firmware work.
Use the section links to revisit a step, or follow a related guide below.
Official references and further reading
Choose the matching release in the vendor documentation before using a command or design. References open on the publisher’s website; linked material remains with its publisher.
- When DQP must be updated
- Qualification package details and fields
- DQP-capable download command
- DQP as a separate ONTAP post-upgrade task
- Automatic component updates by release
- NetApp documented DQP download failure
- NetApp documented DQP unpacking failure
- Hardware support validation
- Authorized support downloads