1just-man-pages/condor_advertiGseen(e1r)al CommandsjMuasntu-amlan-pages/condor_advertise(1)
2
6 condor_advertise Send a ClassAd to the condor_collector daemon
7
9 condor_advertise [ -help -version ] [ -pool centralmanagerhost‐
10 name[:portname] ] [ -debug ] [ -tcp ] update-command [ classad-filename
11 ]
12
14 condor_advertise sends a ClassAd to the condor_collector daemon on the
15 central manager machine. The required argument update-command says what
16 daemon type's ClassAd is to be updated. The optional argument classad-
17 filename is the file from which the ClassAd should be read. If classad-
18 filename is omitted or is ``-'', then the ClassAd is read from standard
19 input.
20 The update-command may be one of the following strings:
22 UPDATE_STARTD_AD
24 UPDATE_SCHEDD_AD
30 UPDATE_MASTER_AD
36 UPDATE_GATEWAY_AD
42 UPDATE_CKPT_SRVR_AD
48 UPDATE_NEGOTIATOR_AD
54 UPDATE_HAD_AD
60 UPDATE_AD_GENERIC
66 UPDATE_SUBMITTOR_AD
72 UPDATE_COLLECTOR_AD
78 UPDATE_LICENSE_AD
84 UPDATE_STORAGE_AD
90 condor_advertise can also be used to invalidate and delete ClassAds
96 currently held by the condor_collector daemon. In this case the update-
97 command will be one of the following strings:
98 INVALIDATE_STARTD_ADS
100 INVALIDATE_SCHEDD_ADS
106 INVALIDATE_MASTER_ADS
112 INVALIDATE_GATEWAY_ADS
118 INVALIDATE_CKPT_SRVR_ADS
124 INVALIDATE_NEGOTIATOR_ADS
130 INVALIDATE_HAD_ADS
136 INVALIDATE_ADS_GENERIC
142 INVALIDATE_SUBMITTOR_ADS
148 INVALIDATE_COLLECTOR_ADS
154 INVALIDATE_LICENSE_ADS
160 INVALIDATE_STORAGE_ADS
166 For any of these INVALIDATE commands, the ClassAd in the required file
172 consists of three entries. The file contents will be similar to:
173 MyType = "Query"
175 TargetType = "Machine"
176 Requirements = Name == "condor.example.com"
177 The definition for MyTypeis always Query. TargetTypeis set to the
179 MyTypeof the ad to be deleted. This MyTypeis DaemonMasterfor the con‐
180 dor_master ClassAd, Machinefor the condor_startd ClassAd, Schedulerfor
181 the condor_schedd ClassAd, and Negotiatorfor the condor_negotiator
182 ClassAd. Requirementsis an expression evaluated within the context of
183 ads of TargetType. When Requirementsevaluates to True, the matching ad
184 is invalidated. A full example is given below.
185
187 -help
188 Display usage information
190 -version
194 Display version information
196 -pool centralmanagerhostname[:portname]
200 Specify a pool by giving the central manager's host name and an
202 optional port number. The default is the COLLECTOR_HOSTspecified in
203 the configuration file.
204 -tcp
208 Use TCP for communication. Without this option, UDP is used.
210 -debug
214 Print debugging information as the command executes.
216
220 The job and machine ClassAds are regularly updated. Therefore, the
221 result of condor_advertise is likely to be overwritten in a very short
222 time. It is unlikely that either Condor users (those who submit jobs)
223 or administrators will ever have a use for this command. If it is
224 desired to update or set a ClassAd attribute, the condor_config_val
225 command is the proper command to use.
226 For those administrators who do need condor_advertise , you can option‐
228 ally include these attributes:
229 DaemonStartTime - The time the service you are advertising started run‐
231 ning. Measured in seconds since the Unix epoch.
232 UpdateSequenceNumber - An integer that begins at 0 and increments by
234 one each time you re-advertise the same ad.
235 If both of the above are included, the condor_collector will automati‐
237 cally include the following attributes:
238 UpdatesTotal - The actual number of advertisements for this daemon that
240 the condor_collector has seen.
241 UpdatesLost - The number of advertisements that for this daemon that
243 the condor_collector expected to see, but did not.
244 UpdatesSequenced - The total of UpdatesTotal and UpdatesLost.
246 UpdatesHistory - See COLLECTOR_DAEMON_HISTORY_SIZEin section .
248
250 Assume that a machine called condor.example.com is turned off, yet its
251 condor_startd ClassAd does not expire for another 20 minutes. To avoid
252 this machine being matched, an administrator chooses to delete the
253 machine's condor_startd ClassAd. Create a file (called remove_filein
254 this example) with the three required attributes:
255 MyType = "Query"
257 TargetType = "Machine"
258 Requirements = Name == "condor.example.com"
259 This file is used with the command:
261 % condor_advertise INVALIDATE_STARTD_ADS remove_file
263
265 condor_advertise will exit with a status value of 0 (zero) upon suc‐
266 cess, and it will exit with the value 1 (one) upon failure.
267
269 Condor Team, University of Wisconsin-Madison
270
272 Copyright (C) 1990-2009 Condor Team, Computer Sciences Department, Uni‐
273 versity of Wisconsin-Madison, Madison, WI. All Rights Reserved.
274 Licensed under the Apache License, Version 2.0.
275 See the Condor Version 7.4.2 Manual or http://www.condorpro‐
277 ject.org/licensefor additional notices. condor-admin@cs.wisc.edu
278 date just-man-pages/condor_advertise(1)