Name
condor_advertise - Send a ClassAd to the condor_collector daemon
Synopsis
condor_advertise [ -help -version ] [ -pool
centralmanagerhostname[:portname] ] [ -debug ] [ -tcp ] update-command
[ classad-filename ]
Description
condor_advertise sends a ClassAd to the condor_collector daemon on the
central manager machine. The required argument update-command says what
daemon type’s ClassAd is to be updated. The optional argument classad-
filename is the file from which the ClassAd should be read. If classad-
filename is omitted or is ‘‘-’’, then the ClassAd is read from standard
input.
The update-command may 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_advertise can also be used to invalidate and delete ClassAds
currently held by the condor_collector daemon. In this case the update-
command will 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 MyTypeis always Query. TargetTypeis set to the
MyTypeof the ad to be deleted. This MyTypeis DaemonMasterfor the
condor_master ClassAd, Machinefor the condor_startd ClassAd,
Schedulerfor the condor_schedd ClassAd, and Negotiatorfor the
condor_negotiator ClassAd. Requirementsis an expression evaluated
within the context of ads of TargetType. When Requirementsevaluates to
True, the matching ad is invalidated. A full example is given below.
Options
-help
Display usage information
-version
Display version information
-pool centralmanagerhostname[:portname]
Specify a pool by giving the central manager’s host name and an
optional port number. The default is the COLLECTOR_HOSTspecified in
the configuration file.
-tcp
Use TCP for communication. Without this option, UDP is used.
-debug
Print debugging information as the command executes.
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_val
command is the proper command to use.
For those administrators who do need condor_advertise , you can
optionally include these attributes:
DaemonStartTime - The time the service you are advertising started
running. Measured in seconds since the Unix epoch.
UpdateSequenceNumber - An integer that begins at 0 and increments by
one each time you re-advertise the same ad.
If both of the above are included, the condor_collector will
automatically include the following attributes:
UpdatesTotal - The actual number of advertisements for this daemon that
the condor_collector has seen.
UpdatesLost - The number of advertisements that for this daemon that
the condor_collector expected to see, but did not.
UpdatesSequenced - The total of UpdatesTotal and UpdatesLost.
UpdatesHistory - See COLLECTOR_DAEMON_HISTORY_SIZEin section .
Examples
Assume that a machine called condor.example.com is turned off, yet its
condor_startd ClassAd does not expire for another 20 minutes. To avoid
this machine being matched, an administrator chooses to delete the
machine’s condor_startd ClassAd. Create a file (called remove_filein
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_advertise will exit with a status value of 0 (zero) upon
success, and it will exit with the value 1 (one) upon failure.
Author
Condor Team, University of Wisconsin-Madison
Copyright
Copyright (C) 1990-2009 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.2.4 Manual or
http://www.condorproject.org/licensefor additional notices. condor-
admin@cs.wisc.edu
date just-man-pages/condor_advertise(1)