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-2024, Center for High Throughput Computing, Computer Sciences Department,  University
       of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

                                           Apr 14, 2024                   CONDOR_UPGRADE_CHECK(1)