Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
just-man-pages/condor_advertGeneral Commandsjust-man-pages/condor_advertise(1)

Name
       condor_advertise	Send a ClassAd to the condor_collector daemon

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_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(s)	should
       be read.	If classad-filename is omitted or is the dash character	('-'),
       then the	ClassAd(s) are read from standard input.

       When  -multiple	is specified, multiple ClassAds	may be published. Pub-
       lishing many ClassAds in	a single  invocation  of  condor_advertise  is
       more  efficient	than  invoking	condor_advertise once per ClassAd. The
       ClassAds	are expected to	be separated by	one or more blank lines.  When
       -multiple  is not specified, blank lines	are ignored (for backward com-
       patibility). It is best not to rely on blank lines  being  ignored,  as
       this may	change in the future.

       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,	Sched-
       uler  for the condor_schedd ClassAd, and	 Negotiator for	the condor_ne-
       gotiator	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

       -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 op-
	  tional 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 re-
       sult of condor_advertise	is likely to be	overwritten in	a  very	 short
       time. It	is unlikely that either	HTCondor users (those who submit jobs)
       or administrators will ever have	a use for this command.	If it  is  de-
       sired  to update	or set a ClassAd attribute, the	condor_config_val com-
       mand is the proper command to use.

       Attributes are defined in Appendix A of the HTCondor manual.

       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_collector	will automati-
       cally include the following attributes:

       UpdatesTotal

       UpdatesLost

       UpdatesSequenced

       UpdatesHistory

	  Affected by  COLLECTOR_DAEMON_HISTORY_SIZE .

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  ma-
       chine'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  suc-
       cess,  and  it  will  exit with the value 1 (one) upon failure. Success
       means that all ClassAds were successfully sent to all  condor_collector
       daemons.	 When there are	multiple ClassAds or multiple condor_collector
       daemons,	it is possible that some but not all publications succeed;  in
       this case, the exit status is 1,	indicating failure.

Author
       Center for High Throughput Computing, University	of Wisconsin-Madison

Copyright
       Copyright  (C) 1990-2015	Center for High	Throughput Computing, Computer
       Sciences	Department, University of Wisconsin-Madison, Madison, WI.  All
       Rights Reserved.	Licensed under the Apache License, Version 2.0.

				     date   just-man-pages/condor_advertise(1)

Name | Synopsis | Description | Options | General Remarks | Examples | Exit Status | Author | Copyright

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=condor_advertise&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help