Provided by: htcondor_8.4.2~dfsg.1-1build1_amd64 bug

Name

       condor_update_machine_ad 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_startddaemon's machine ClassAd. The
       ClassAd  in  the  file  given by  path/to/update-ad represents the changed attributes. The
       changes persists until the condor_startdrestarts. 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 mustbe
       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_startdto 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_adwill  exit  with  a  status value of 0 (zero) upon success, and it
       will exit with the value 1 (one) upon failure.

Author

       Center for High Throughput Computing, University of Wisconsin-Madison

Copyright

       Copyright  (C)  1990-2015  Center  for  High  Throughput  Computing,   Computer   Sciences
       Department,  University  of  Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed
       under the Apache License, Version 2.0.

                                          February 2016               condor_update_machine_ad(1)