Introduction
Are you planning an ONTAP upgrade? Then you already know how important it is to have a reliable plan. But if you’ve ever run into a last-minute blocker or configuration surprise, you know the challenge isn’t just running “the upgrade.” It’s making sure you’re ready ahead of time.
That’s where automated pre-checks come in. Upgrade Health Checker (UHC) is your onsite upgrade advisory and validation tool, specifically crafted to streamline and safeguard ONTAP upgrades—even in the most complex, large-scale, or security-focused environments.
Fleet coverage beyond the cloud: UHC Works onsite and offline
Active IQ’s upgrade advisor supports those who send telemetry data and prefer cloud-based planning. UHC extends upgrade readiness to fleet-wide coverage—providing comprehensive, automated insight whether you’re fully cloud-connected, hybrid, or operating in highly regulated or “dark site” environments. UHC installs locally and runs within your own network, never requiring you to abandon SaaS tools or stop sending AutoSupport. Instead, you get upgrade preparation on your terms, for your whole environment.
Why automated pre‑upgrade checks matter
Most upgrade headaches don’t come from the upgrade itself—they come from discovering prerequisites or mismatches late in the process. Automated pre-upgrade checks help you spot risks before you start, so you can move forward with confidence rather than worry. For many customers, these checks also save significant time—helping you avoid lost hours troubleshooting late-stage blockers, accelerating deployments across clusters, and reducing manual review effort to keep your business running smoothly.
UHC key features and how it works
- Onsite and secure: UHC runs on your own infrastructure, minimizing cloud reliance and enabling optional offline usage.
- Leverages AutoSupport data: Pulls from your ONTAP clusters to highlight blockers, warnings, and readiness gaps.
- Easy credential and role management: Built-in support for ONTAP REST roles and service accounts plus Ansible-based onboarding and enterprise credential manager support.
- Flexible automation: Use CLI flags, YAML configuration, or interactive mode with clear parameter precedence.
- Scalable: Schedule fleet-level checks with cron or integrate with orchestration pipelines; works for both single and multi-cluster environments.
- Rich reporting: Each run generates easy-to-read HTML as well as JSON for your ITSM/automation pipelines—including actionable remediation advice and upgrade plans.
UHC in action: typical workflow
- Download UHC and deploy it on a local virtual machine.
- Validate its digital signature for peace of mind.
- Add the required ONTAP REST role and service account. Use Ansible for automated setup if you prefer.
- Execute UHC either manually or on a schedule.
- View the HTML or JSON report to see everything from health insights to blockers and a step-by-step upgrade plan.
- If you use ITSM or automation tools, integrate the JSON report directly into your workflows.
Figure: The four-step UHC readiness loop—deploy onsite, run automated checks, review the HTML/JSON report from the runs folder, remediate and re-run (optionally scheduled via cron)
UHC or Upgrade Advisor? Making the right choice
Both tools help you succeed, but UHC shines in secure, large, or complex environments—especially where automation is non-negotiable, and cloud options aren’t available or allowed. Upgrade Advisor is great for smaller, cloud-connected environments and teams that prefer a UI.
|
Feature/Aspect |
Upgrade Health Checker (UHC) |
Upgrade Advisor (UA) |
|
Deployment model |
Onsite, self-hosted |
Cloud-based |
|
Ideal for |
Large, complex, or secure fleets |
Small environments, cloud workflows |
|
User experience |
Automation first |
UI driven |
|
Internet needed |
Optional (for tool updates) |
Yes |
|
Scale |
Fleet-level |
Single clusters |
|
Security posture |
Dark site and security friendly |
Cloud centric |
Make the most of UHC
UHC not only provides human-readable HTML output but also gives you structured JSON you can automate around. Schedule runs, keep your environment ready, and bring your reports into audits and compliance reviews whenever you want.
Video Overview
🎥 Upgrade Health Checker Overview
Upgrade Health Checker tool: An Overview - YouTube
What’s New and What’s Next
UHC is continually evolving—expect deeper automation, reporting improvements, and more flexible integration with your favorite tools as NetApp responds to user feedback and operational needs.
Wrapping Up
Smarter upgrades start with better preparation. By leveraging UHC, you empower your team with automated, onsite pre-upgrade checks that reduce surprises, keep you secure, and enable confident ONTAP change management.
Appendix
UHC Download Information
UHC can be downloaded from the NetApp Console Automation Hub. Recommended system requirements and usage guidance (such as supported OS versions and digital signature verification) are detailed in the UHC docs.
