condor_update_machine_ad [-pool centralmanagerhostname[:portnumber]] [-name startdname] path/to/update-ad
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.
This tool is intended for the use of system administrators when dealing with offline universes.
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.
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.