CONDOR_UPGRADE_CHECK(1)

NAME
condor_upgrade_check - HTCondor Manual

Check a current install of HTCondor for incompatibilites that may cause issues when upgrading 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]

DESCRIPTION

condor_upgrade_check is a tool intended to be used by administrators before upgrading an HTCondor install to a new major version. This tool will perform various checks for the current installation against known incompatibilities introduced in the Feature series of HTCondor for a given major version. If a check fails, indicating the current install will have issues with an upgrade, then the tool will do its best to suggest a course of action to take.

condor_upgrade_check is intended to be ran on a per-host basis for upgrading a system. Since the CHTC recommends upgrading between major versions in steps (i.e. V23 -> V24 -> V25), the available checks change between major versions. New ones will be added and old ones removed.

Some checks ran by condor_upgrade_check are classified as warnings. These checks output warnings about incompatibilites that the tool is not capable of testing and thus give accurrate feedback. Warnings tend to unconditionally output information.

Note:
        Some checks ran by this tool require the tool to be ran as root. If this tool is executed with out root privileges or on a Windows host then any checks that require root will be skipped.

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

            -i/--ignore TAG [TAG ...]
                Ignore checks with a matching TAG. Takes precendence over -only

            -o/--only TAG [TAG ...]
                Only run checks with a matching TAG. If given the TAG WARNINGS then only checks classified as warnings will be ran.

            -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 hosts installed HTCondor for potential issues caused by incompatibilities when upgrading between major versions.

            condor_upgrade_check

Check hosts installed HTCondor-CE for potential issues caused by incompatibilites 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

EXIT STATUS

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

Author
HTCondor Team

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.