1CONDOR_UPDATE_MACHINE_AD(1)     HTCondor Manual    CONDOR_UPDATE_MACHINE_AD(1)
2
3
4

NAME

6       condor_update_machine_ad - HTCondor Manual
7
8       update a machine ClassAd
9
10

SYNOPSIS

12       condor_update_machine_ad [-help | -version ]
13
14       condor_update_machine_ad   [-pool  centralmanagerhostname[:portnumber]]
15       [-name startdname] path/to/update-ad
16

DESCRIPTION

18       condor_update_machine_ad modifies the specified condor_startd  daemon's
19       machine  ClassAd.  The  ClassAd  in the file given by path/to/update-ad
20       represents the changed attributes. The changes persists until the  con‐
21       dor_startd  restarts. If no file is specified on the command line, con‐
22       dor_update_machine_ad reads the update ClassAd from stdin.
23
24       Contents of the file or stdin must contain  a  complete  ClassAd.  Each
25       line must be terminated by a newline character, including the last line
26       of the file. Lines are of the form
27
28          <attribute> = <value>
29
30       Changes to certain ClassAd attributes will cause the  condor_startd  to
31       regenerate  values  for other ClassAd attributes. An example of this is
32       setting HasVM. This will  cause  OfflineUniverses,  VMOfflineTime,  and
33       VMOfflineReason to change.
34

OPTIONS

36          -help  Display usage information and exit
37
38          -version
39                 Display the HTCondor version and exit
40
41          -pool centralmanagerhostname[:portnumber]
42                 Specify  a pool by giving the central manager's host name and
43                 an optional port number
44
45          -name startdname
46                 Send the command to a machine identified by startdname
47

GENERAL REMARKS

49       This tool is intended for the use of system administrators when dealing
50       with offline universes.
51

EXAMPLES

53       To  re-enable matching with the VM universe jobs, place on stdin a com‐
54       plete ClassAd (including the ending newline character)  to  change  the
55       value of ClassAd attribute HasVM:
56
57          echo "HasVM = True
58          " | condor_update_machine_ad
59
60       To prevent vm universe jobs from matching with the machine:
61
62          echo "HasVM = False
63          " | condor_update_machine_ad
64
65       To  prevent vm universe jobs from matching with the machine and specify
66       a reason:
67
68          echo "HasVM = False
69          VMOfflineReason = \"Cosmic rays.\"
70          " | condor_update_machine_ad
71
72       Note that the quotes around the reason are required  by  ClassAds,  and
73       they  must  be  escaped  because  of the shell. Using a file instead of
74       stdin may be preferable in these situations,  because  neither  quoting
75       nor escape characters are needed.
76

EXIT STATUS

78       condor_update_machine_ad will exit with a status value of 0 (zero) upon
79       success, and it will exit with the value 1 (one) upon failure.
80

AUTHOR

82       HTCondor Team
83

85       1990-2022, Center for High Throughput Computing, Computer Sciences  De‐
86       partment,  University  of  Wisconsin-Madison, Madison, WI, US. Licensed
87       under the Apache License, Version 2.0.
88
89
90
91
928.8                              Jun 13, 2022      CONDOR_UPDATE_MACHINE_AD(1)
Impressum