Overview

BirdBath is HTCondor's entry into the world of Web Services. Its goal is to augment some of the core HTCondor daemons with Simple Object Access Protocol (SOAP) interfaces so that they can be queried and controlled through programs other than the standard HTCondor command-line tools. The main interfaces are currently to the Schedd for submitting and querying jobs, and the Collector for accessing information about a HTCondor pool.

Information about configuring HTCondor's SOAP API is available in the HTCondor manual.

Status

As of March 2nd 2005, BirdBath is part of HTCondor. It was in the 6.7 developer series as of 6.7.5, and is part of the 6.8 stable series.

Examples

• HTCondor Week 2006 has a presentation and tutorial describing job submission and control.

Known Issues

• Job Ad NTDomain Attribute: When submitting jobs to a Windows SchedD or to be run on Windows you must add an NTDomain attribute to your job's ad before calling Submit(). This attribute is not created for you in the job ad template returned by CreateJobTemplate(). The value of the attribute should be a string and a domain where the job's Owner has an account. The value of the NTDomain attribute is combined with the Owner attribute, e.g. Owner@NTDomain, to lookup the owner's credentials.

Problems?

Please contact Matthew Farrellee and Todd Tannenbaum.