condor_advertise(1) General Commands Manual condor_advertise(1)
Name
condor_advertise Send - a ClassAd to the condor_collectordaemon
Synopsis
condor_advertise [-help -version]
condor_advertise[-pool centralmanagerhostname[:portname]] [-debug] [-tcp] [-multiple] update-command[classad-filename]
Description
condor_advertise sends one or more ClassAds to the condor_collectordaemon on the central manager machine. The required argument update-com-
mandsays what daemon type's ClassAd is to be updated. The optional argument classad-filenameis the file from which the ClassAd(s) should be
read. If classad-filenameis omitted or is the dash character ('-'), then the ClassAd(s) are read from standard input.
When -multipleis specified, multiple ClassAds may be published. Publishing many ClassAds in a single invocation of condor_advertiseis more
efficient than invoking condor_advertiseonce per ClassAd. The ClassAds are expected to be separated by one or more blank lines. When -mul-
tipleis not specified, blank lines are ignored (for backward compatibility). It is best not to rely on blank lines being ignored, as this
may change in the future.
The update-commandmay be one of the following strings:
UPDATE_STARTD_AD
UPDATE_SCHEDD_AD
UPDATE_MASTER_AD
UPDATE_GATEWAY_AD
UPDATE_CKPT_SRVR_AD
UPDATE_NEGOTIATOR_AD
UPDATE_HAD_AD
UPDATE_AD_GENERIC
UPDATE_SUBMITTOR_AD
UPDATE_COLLECTOR_AD
UPDATE_LICENSE_AD
UPDATE_STORAGE_AD
condor_advertisecan also be used to invalidate and delete ClassAds currently held by the condor_collectordaemon. In this case the update-
commandwill be one of the following strings:
INVALIDATE_STARTD_ADS
INVALIDATE_SCHEDD_ADS
INVALIDATE_MASTER_ADS
INVALIDATE_GATEWAY_ADS
INVALIDATE_CKPT_SRVR_ADS
INVALIDATE_NEGOTIATOR_ADS
INVALIDATE_HAD_ADS
INVALIDATE_ADS_GENERIC
INVALIDATE_SUBMITTOR_ADS
INVALIDATE_COLLECTOR_ADS
INVALIDATE_LICENSE_ADS
INVALIDATE_STORAGE_ADS
For any of these INVALIDATE commands, the ClassAd in the required file consists of three entries. The file contents will be similar to:
MyType = "Query"
TargetType = "Machine"
Requirements = Name == "condor.example.com"
The definition for MyType is always Query . TargetType is set to the MyType of the ad to be deleted. This MyType is DaemonMaster for
the condor_masterClassAd, Machine for the condor_startdClassAd, Scheduler for the condor_scheddClassAd, and Negotiator for the con-
dor_negotiatorClassAd. Requirements is an expression evaluated within the context of ads of TargetType . When Requirements evaluates to
True , the matching ad is invalidated. A full example is given below.
Options
-help
Display usage information
-version
Display version information
-debug
Print debugging information as the command executes.
-multiple
Send more than one ClassAd, where the boundary between ClassAds is one or more blank lines.
-pool centralmanagerhostname[:portname]
Specify a pool by giving the central manager's host name and an optional port number. The default is the COLLECTOR_HOST specified in
the configuration file.
-tcp
Use TCP for communication. Without this option, UDP is used.
General Remarks
The job and machine ClassAds are regularly updated. Therefore, the result of condor_advertise is likely to be overwritten in a very short
time. It is unlikely that either Condor users (those who submit jobs) or administrators will ever have a use for this command. If it is
desired to update or set a ClassAd attribute, the condor_config_valcommand is the proper command to use.
For each of these attributes, see section 11for definitions.
For those administrators who do need condor_advertise, the following attributes may be included:
DaemonStartTime
UpdateSequenceNumber
If both of the above are included, the condor_collectorwill automatically include the following attributes:
UpdatesTotal
UpdatesLost
UpdatesSequenced
UpdatesHistory
Also see COLLECTOR_DAEMON_HISTORY_SIZE in section 3.3.16.
Examples
Assume that a machine called condor.example.com is turned off, yet its condor_startdClassAd does not expire for another 20 minutes. To
avoid this machine being matched, an administrator chooses to delete the machine's condor_startdClassAd. Create a file (called remove_file
in this example) with the three required attributes:
MyType = "Query"
TargetType = "Machine"
Requirements = Name == "condor.example.com"
This file is used with the command:
% condor_advertise INVALIDATE_STARTD_ADS remove_file
Exit Status
condor_advertisewill exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure. Success means
that all ClassAds were successfully sent to all condor_collectordaemons. When there are multiple ClassAds or multiple condor_collectordae-
mons, it is possible that some but not all publications succeed; in this case, the exit status is 1, indicating failure.
Author
Condor Team, University of Wisconsin-Madison
Copyright
Copyright (C) 1990-2012 Condor Team, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
Licensed under the Apache License, Version 2.0.
See the Condor Version 7.8.2 Manualor http://www.condorproject.org/licensefor additional notices. condor-admin@cs.wisc.edu
September 2012 condor_advertise(1)