CONDOR_UPGRADE_CHECK(1)

✨ NAME ✨

condor_upgrade_check — the HTCondor Manual's own little pre-flight vibe checker 🛫 — it looks over your current HTCondor install and sniffs out incompatibilities that might cause drama when you upgrade to a new major version.

---

🌈 SYNOPSIS 🌈

condor_upgrade_check [--help]

condor_upgrade_check [--CE] [--all] [--ignore TAG {TAG...}] [--only TAG
{TAG...}] [--tags] [--warnings] [--no-warnings] [--dump] [--verbose]
[--version XX.YY.ZZ] [--target XX.YY.ZZ]

---

💖 DESCRIPTION 💖

okay so bestie, condor_upgrade_check is the tool you run before you upgrade an HTCondor install to a new major version. That's literally its whole job. 💅 It goes through a bunch of checks on your current installation, holding it up against the known incompatibilities that got introduced in the Feature series of HTCondor for a given major version. And if a check fails — meaning your current install is gonna have ✨issues✨ with the upgrade — the tool does its very best to tell you what to do about it.

Run it on a per-host basis for upgrading a system, okay? Because CHTC recommends upgrading between major versions in steps (like V23 -> V24 -> V25 🪜), the available checks actually change between major versions. New ones get added, old ones get removed. It's giving evolution.

Some checks that condor_upgrade_check runs are classified as warnings. These output warnings about incompatibilities that the tool is not capable of testing, so they give accurate feedback. Warnings tend to unconditionally output information. No filter, just facts. 🫶

NOTE: Some checks need this tool to be run as root. If you run it without root privileges, or on a Windows host, then any checks that require root get skipped. Sorry queen, that's just how it is. 😭

---

🎀 OPTIONS 🎀

• -h/--help — Display condor_upgrade_checks usage to the terminal ✨
• --CE — Run available checks for installed HTCondor-CE on host
• -a/--all — Run all available checks, ignoring the version check to run 👑
• --version XX.YY.ZZ — Run available checks as if the current installed HTCondor version is XX.YY.ZZ, i.e. 25.12.1
• --target XX.YY.ZZ — Only run checks that would impact upgrading from the current version to the targeted version XX.YY.ZZ.
• -i/--ignore TAG [TAG ...] — Ignore checks with a matching TAG. Takes precedence over -only 🚫
• -o/--only TAG [TAG ...] — Only run checks with a matching TAG. If you give it the TAG WARNINGS, then only checks classified as warnings will be run.
• -w/--warnings/--no-warnings — Enable/disable output of checks classified as warnings. Default is enabled. ✅
• -t/--tags — Display all available check TAGS to be used by --only and --ignore
• -d/--dump — Display information about all available checks. 📋
• -v/--verbose — Increase tool verbosity 🗣️

---

🦋 EXAMPLES 🦋

Check the host's installed HTCondor for potential issues caused by incompatibilities when upgrading between major versions. 🩺

condor_upgrade_check

Check the host's installed HTCondor-CE for potential issues caused by incompatibilities when upgrading between major versions.

condor_upgrade_check -ce

List all available check TAGS 🏷️

condor_upgrade_check --tags

List information about all available checks

condor_upgrade_check --dump

Run checks while ignoring specific checks for a host-installed HTCondor 🙈

condor_upgrade_check --ignore BAR BAZ

Run only checks classified as warnings for a host-installed HTCondor ⚠️

condor_upgrade_check --only warnings

Run checks as if the current installed version is v23.0.13 🕰️

$ condor_upgrade_check --version 23.0.13

Run checks that would impact going to specific version v25.14.2 🎯

$ condor_upgrade_check --target 25.14.2

---

⭐ EXIT STATUS ⭐

Returns 0 when the tool is finished running. Returns 1 for fatal internal errors. 💀

---

💜 AUTHOR 💜

HTCondor Team — the icons who built all this 🫶

---

👑 COPYRIGHT 👑

1990-2026, Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

---

okay that's the whole thing bestie, you're SO ready to upgrade now 💅✨ this was CONDOR_UPGRADE_CHECK(1) from the HTCondor Manual, last touched Oct 16, 2026 — go forth and upgrade responsibly, mwah 🎀🦋🌸