NAME

       condor_update_machine_ad - HTCondor Manual

       update a machine ClassAd

SYNOPSIS

       condor_update_machine_ad [-help | -version ]

       condor_update_machine_ad  [-pool  centralmanagerhostname[:portnumber]]  [-name startdname]
       path/to/update-ad

DESCRIPTION

       condor_update_machine_ad modifies the specified condor_startd  daemon's  machine  ClassAd.
       The  ClassAd in the file given by path/to/update-ad represents the changed attributes. The
       changes persists until the condor_startd restarts. If no file is specified on the  command
       line, condor_update_machine_ad reads the update ClassAd from stdin.

       Contents  of  the  file  or  stdin  must  contain  a  complete  ClassAd. Each line must be
       terminated by a newline character, including the last line of the file. Lines are  of  the
       form

          <attribute> = <value>

       Changes  to  certain  ClassAd attributes will cause the condor_startd to regenerate values
       for other ClassAd attributes. An example  of  this  is  setting  HasVM.  This  will  cause
       OfflineUniverses, VMOfflineTime, and VMOfflineReason to change.

OPTIONS

          -help  Display usage information and exit

          -version
                 Display the HTCondor version and exit

          -pool centralmanagerhostname[:portnumber]
                 Specify  a  pool  by giving the central manager's host name and an optional port
                 number

          -name startdname
                 Send the command to a machine identified by startdname

GENERAL REMARKS

       This tool is intended for the use of  system  administrators  when  dealing  with  offline
       universes.

EXAMPLES

       To  re-enable  matching  with  the  VM  universe  jobs,  place on stdin a complete ClassAd
       (including the ending newline character) to change the value of ClassAd attribute HasVM:

          $ echo "HasVM = True
          " | condor_update_machine_ad

       To prevent vm universe jobs from matching with the machine:

          $ echo "HasVM = False
          " | condor_update_machine_ad

       To prevent vm universe jobs from matching with the machine and specify a reason:

          $ echo "HasVM = False
          VMOfflineReason = \"Cosmic rays.\"
          " | condor_update_machine_ad

       Note that the quotes around the reason are required by ClassAds, and they must be  escaped
       because of the shell. Using a file instead of stdin may be preferable in these situations,
       because neither quoting nor escape characters are needed.

EXIT STATUS

       condor_update_machine_ad will exit with a status value of 0 (zero) upon  success,  and  it
       will exit with the value 1 (one) upon failure.

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_UPDATE_MACHINE_AD(1)