Linux Certif

Toute la documentation sur la certification Linux LPI

condor_advertise

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