1condor_update_machine_ad(1) General Commands Manualcondor_update_machine_ad(1)
2
3
4
6 condor_update_machine_adupdate a machine ClassAd
7
9 condor_update_machine_ad[-help | -version]
10
11 condor_update_machine_ad[-pool centralmanagerhostname[:portnumber]]
12 [-name startdname] path/to/update-ad
13
15 condor_update_machine_admodifies the specified condor_startddaemon's
16 machine ClassAd. The ClassAd in the file given by path/to/update-adrep‐
17 resents the changed attributes. The changes persists until the con‐
18 dor_startdrestarts. If no file is specified on the command line, con‐
19 dor_update_machine_adreads the update ClassAd from stdin.
20
21 Contents of the file or stdinmust contain a complete ClassAd. Each line
22 mustbe terminated by a newline character, including the last line of
23 the file. Lines are of the form
24
25 <attribute> = <value>
26
27 Changes to certain ClassAd attributes will cause the condor_startdto
28 regenerate values for other ClassAd attributes. An example of this is
29 setting HasVM. This will cause OfflineUniverses, VMOfflineTime, and
30 VMOfflineReasonto change.
31
33 -help
34
35 Display usage information and exit
36
37
38
39 -version
40
41 Display the HTCondor version and exit
42
43
44
45 -pool centralmanagerhostname[:portnumber]
46
47 Specify a pool by giving the central manager's host name and an
48 optional port number
49
50
51
52 -name startdname
53
54 Send the command to a machine identified by startdname
55
56
57
59 This tool is intended for the use of system administrators when dealing
60 with offline universes.
61
63 To re-enable matching with the VM universe jobs, place on stdina com‐
64 plete ClassAd (including the ending newline character) to change the
65 value of ClassAd attribute HasVM:
66
67 echo "HasVM = True
68 " | condor_update_machine_ad
69
70 To prevent vm universe jobs from matching with the machine:
71
72 echo "HasVM = False
73 " | condor_update_machine_ad
74
75 To prevent vm universe jobs from matching with the machine and specify
76 a reason:
77
78 echo "HasVM = False
79 VMOfflineReason = \"Cosmic rays.\"
80 " | condor_update_machine_ad
81
82 Note that the quotes around the reason are required by ClassAds, and
83 they must be escaped because of the shell. Using a file instead of std‐
84 inmay be preferable in these situations, because neither quoting nor
85 escape characters are needed.
86
88 condor_update_machine_adwill exit with a status value of 0 (zero) upon
89 success, and it will exit with the value 1 (one) upon failure.
90
92 Center for High Throughput Computing, University of Wiscon‐
93 sin–Madison
94
96 Copyright © 1990-2019 Center for High Throughput Computing, Computer
97 Sciences Department, University of Wisconsin-Madison, Madison, WI. All
98 Rights Reserved. Licensed under the Apache License, Version 2.0.
99
100
101
102 date condor_update_machine_ad(1)