.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CONDOR_UPDATE_MACHINE_AD" "1" "Apr 01, 2024" "" "HTCondor Manual"
.SH NAME
condor_update_machine_ad \- HTCondor Manual
.sp
update a machine ClassAd
  
.SH SYNOPSIS
.sp
\fBcondor_update_machine_ad\fP [\fB\-help | \-version\fP ]
.sp
\fBcondor_update_machine_ad\fP
[\fB\-pool\fP \fIcentralmanagerhostname[:portnumber]\fP]
[\fB\-name\fP \fIstartdname\fP] \fIpath/to/update\-ad\fP
.SH DESCRIPTION
.sp
\fIcondor_update_machine_ad\fP modifies the specified \fIcondor_startd\fP
daemon\(aqs machine ClassAd. The ClassAd in the file given by
\fBpath/to/update\-ad\fP represents the changed attributes. The changes
persists until the \fIcondor_startd\fP restarts. If no file is specified on
the command line, \fIcondor_update_machine_ad\fP reads the update ClassAd
from \fBstdin\fP\&.
.sp
Contents of the file or \fBstdin\fP 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
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<attribute> = <value>
.EE
.UNINDENT
.UNINDENT
.sp
Changes to certain ClassAd attributes will cause the \fIcondor_startd\fP to
regenerate values for other ClassAd attributes. An example of this is
setting \fBHasVM\fP\&. This will cause \fBOfflineUniverses\fP,
\fBVMOfflineTime\fP, and \fBVMOfflineReason\fP to change.
.SH OPTIONS
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-help\fP
Display usage information and exit
.TP
\fB\-version\fP
Display the HTCondor version and exit
.TP
\fB\-pool\fP \fIcentralmanagerhostname[:portnumber]\fP
Specify a pool by giving the central manager\(aqs host name and an
optional port number
.TP
\fB\-name\fP \fIstartdname\fP
Send the command to a machine identified by \fIstartdname\fP
.UNINDENT
.UNINDENT
.UNINDENT
.SH GENERAL REMARKS
.sp
This tool is intended for the use of system administrators when dealing
with offline universes.
.SH EXAMPLES
.sp
To re\-enable matching with the VM universe jobs, place on \fBstdin\fP a
complete ClassAd (including the ending newline character) to change the
value of ClassAd attribute \fBHasVM\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ echo \(dqHasVM = True
\(dq | condor_update_machine_ad
.EE
.UNINDENT
.UNINDENT
.sp
To prevent vm universe jobs from matching with the machine:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ echo \(dqHasVM = False
\(dq | condor_update_machine_ad
.EE
.UNINDENT
.UNINDENT
.sp
To prevent vm universe jobs from matching with the machine and specify a
reason:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ echo \(dqHasVM = False
VMOfflineReason = \e\(dqCosmic rays.\e\(dq
\(dq | condor_update_machine_ad
.EE
.UNINDENT
.UNINDENT
.sp
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
\fBstdin\fP may be preferable in these situations, because neither quoting
nor escape characters are needed.
.SH EXIT STATUS
.sp
\fIcondor_update_machine_ad\fP will exit with a status value of 0 (zero)
upon success, and it will exit with the value 1 (one) upon failure.
.SH AUTHOR
HTCondor Team
.SH COPYRIGHT
1990-2024, Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.
.\" Generated by docutils manpage writer.
.