next up previous contents index
Next: condor_ check_userlogs Up: 9. Command Reference Manual Previous: cleanup_release   Contents   Index

Subsections


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 ClassAd is contained in a file, which is specified by the second required argument. Which daemon's ClassAd to update is specified by the first required argument. 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 MyType is always Query. TargetType is set to the MyType of the ad to be deleted. This MyType is DaemonMaster for the condor_ master ClassAd, Machine for the condor_ startd ClassAd, Scheduler for the condor_ schedd ClassAd, and Negotiator for the condor_ negotiator ClassAd. 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
-pool centralmanagerhostname[:portname]
Specify a pool by giving the central manager's hostname 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.
-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_SIZE in section 3.3.17.

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_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_ 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 © 1990-2007 Condor Team, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. No use of the Condor Software Program is authorized without the express consent of the Condor Team. For more information contact: Condor Team, Attention: Professor Miron Livny, 7367 Computer Sciences, 1210 W. Dayton St., Madison, WI 53706-1685, (608) 262-0856 or miron@cs.wisc.edu.

U.S. Government Rights Restrictions: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of Commercial Computer Software-Restricted Rights at 48 CFR 52.227-19, as applicable, Condor Team, Attention: Professor Miron Livny, 7367 Computer Sciences, 1210 W. Dayton St., Madison, WI 53706-1685, (608) 262-0856 or miron@cs.wisc.edu.

See the Condor Version 6.8.7 Manual for additional notices.


next up previous contents index
Next: condor_ check_userlogs Up: 9. Command Reference Manual Previous: cleanup_release   Contents   Index
condor-admin@cs.wisc.edu