.\"Man page for condor_update_machine_ad 
.\"Generated by makeman on Tue May 29 00:38:53 2018
.TH condor_update_machine_ad  1 "May 2018"
.SH Name
.P
condor_update_machine_ad update \- a machine ClassAd 
.P

.SH Synopsis
condor_update_machine_ad [-help -version] 
.P
condor_update_machine_ad[-pool centralmanagerhostname[:portnumber]] [-name startdname] path/to/update-ad
.P
.SH 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 . 
.P
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 
.P


.br
<attribute> = <value>
.P
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. 
.P
.SH Options
.P

.B -help
.IP "" 3
Display usage information and exit 
.IP "" 3
.P
.B -version
.IP "" 3
Display the HTCondor version and exit 
.IP "" 3
.P
.B -pool centralmanagerhostname[:portnumber]
.IP "" 3
Specify a pool by giving the central manager's host name and an optional port number 
.IP "" 3
.P
.B -name startdname
.IP "" 3
Send the command to a machine identified by startdname
.IP "" 3
.P

.SH General Remarks
.P
This tool is intended for the use of system administrators when dealing with offline universes. 
.P
.SH Examples
.P
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 : 
.P


.br
echo "HasVM = True
.br
" | condor_update_machine_ad 
.P
To prevent vm universe jobs from matching with the machine: 
.P


.br
echo "HasVM = False
.br
" | condor_update_machine_ad 
.P
To prevent vm universe jobs from matching with the machine and specify a reason: 
.P


.br
echo "HasVM = False
.br
VMOfflineReason = \\"Cosmic rays.\\"
.br
" | condor_update_machine_ad 
.P
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. 
.P
.SH Exit Status
.P
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. 
.P
.SH Author
Center for High Throughput Computing, University of Wisconsin-Madison 
.SH Copyright
Copyright (C) 1990-2016 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.