1condor_update_machine_ad(1) General Commands Manualcondor_update_machine_ad(1)
2
3
4

Name

6       condor_update_machine_adupdate a machine ClassAd
7

Synopsis

9       condor_update_machine_ad[-help | -version]
10
11       condor_update_machine_ad[-pool     centralmanagerhostname[:portnumber]]
12       [-name startdname] path/to/update-ad
13

Description

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

Options

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

General Remarks

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

Examples

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

Exit Status

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

Author

92       Center for High Throughput Computing, University of Wisconsin-Madison
93
95       Copyright (C) 1990-2019 Center for High Throughput Computing,  Computer
96       Sciences  Department, University of Wisconsin-Madison, Madison, WI. All
97       Rights Reserved. Licensed under the Apache License, Version 2.0.
98
99
100
101                                     date          condor_update_machine_ad(1)
Impressum