Version information
This version is compatible with:
- ,
Start using this module
Add this module to your Puppetfile:
mod 'HEPPuppet-htcondor', '2.0.2-1'
Learn more about managing modules with a PuppetfileDocumentation
Puppet module for HTCondor batch system
Latest stable version: https://github.com/HEP-Puppet/htcondor/releases/tag/v2.0.2
Development branch: https://github.com/HEP-Puppet/htcondor/tree/development
Puppetforge: https://forge.puppetlabs.com/HEPPuppet/htcondor
Table of Contents
- Overview - What is the htcondor module?
- Module Description - What does the module do?
- Setup - The basics of getting started with htcondor
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Overview
The htcondor modules allows you to set up a HTCondor cluster (https://research.cs.wisc.edu/htcondor/). It depends on several other modules, including puppetlabs/(stdlib|concat|firewall). Please check the metadata.json for detailed dependencies.
Module Description
An HTCondor cluster consists of at least three types of nodes:
- a worker for executing the jobs
- a scheduler for job submission
- a collector/negotiator to match jobs with workers
This puppet modules allows for the configuration of these three types of nodes.
Setup
What the htcondor module affects:
- configuration files and directories (/etc/condor/*)
- installation of htcondor software (condor* packages)
- a new fact for facter: condor_version
Beginning with HTCondor
Since admins might wish to run their own repository or disable repositories after install, the HTCondor repository is no longer included in the Puppet module since version 2.0.0. Therefore, the first step is to install the latest HTCondor repository for your OS (https://research.cs.wisc.edu/htcondor/yum/):
yum install -y https://research.cs.wisc.edu/htcondor/yum/repo.d/htcondor-stable-rhel6.repo
If you wish to use a pool password for authentication you will need to create one first: condor_store_cred -f <path_to_htcondor_module>/files/pool_password
.
Examples
hiera
config examples can be found in the examples folder. They describe a minimal example of
- settings shared across different node types:
htcondor_common.yaml
- settings for managers (nodes that run collector & negotiator daemons):
htcondor_manager.yaml
- settings for schedulers:
htcondor_scheduler.yaml
- settings for worker nodes:
htcondor_common.yaml
The examples assume class management in hiere by addinghiera_include('classes')
to thesite.pp
. Real life examples can be found in https://github.com/uobdic/UKI-SOUTHGRID-BRIS-HEP.
Custom machine/job attributes
Sometimes it is necessary to create custom attributes for condor. Machine attributes can be used
in job requirements (e.g. HasMatLab = True
) and job attributes for job reporting/monitoring (e.g. HEPSPEC06 = 14.00
).
To specify the attributes in hiera simply add
htcondor::custom_attributes:
- HasMatLab: True
...
and for job attributes
htcondor::custom_job_attributes:
- HEPSPEC06: 14.00
- CPUScaling: 1.04
...
Although the use is identical, they are put into different places. custom_attributes
end up added to the STARTD_ATTRS
and custom_job_attributes
are added to STARTD_JOB_ATTRS
.
Limitations
General
Development
Contributing
Running tests
Please run
bundle exec rake validate && bundle exec rake lint && bundle exec rake spec SPEC_OPTS='--format documentation'
and make sure no errors are present when submitting code.
Generating changlelog
github_changelog_generator -u hep-puppet -p htcondor
Change Log
v2.0.2 (2017-07-17)
Closed issues:
- Changes in CentOS7 cgroup setup #59
Merged pull requests:
- Implement SSL authentication #65 (olifre)
- htcondor::security Pull CERTIFICATE_MAPFILE out of krb-auth dependency. #64 (olifre)
- Allow to specify the source for certificate and kerberos map files. #63 (olifre)
- htcondor::sharedport: Add configuration for condor_shared_port daemon. #62 (olifre)
- Fix baseurl for yum repositories #61 (wiene)
v2.0.0 (2017-07-14)
Implemented enhancements:
Merged pull requests:
v1.3.1 (2017-05-18)
Implemented enhancements:
- Add profiles #46
- Simplify parameters #44
- Repository clean up #43
- Towards version 2.0 - part 3 #55 (kreczko)
- Step 2 towards version 2.0 #54 (kreczko)
- Big simplifications #53 (kreczko)
Closed issues:
Merged pull requests:
- Version 1.3.1 #52 (kreczko)
- [New feature] high-availability deployment for multiple managers #51 (kreczko)
- 2016 spring clean #50 (kreczko)
v1.3.0 (2016-01-29)
Implemented enhancements:
Closed issues:
Merged pull requests:
v1.2.0 (2014-11-12)
Merged pull requests:
- Added kerberos map file #37 (kreczko)
- setting default FILESYSTEM_DOMAIN to FQDN (not all WNs have shared FS) #36 (kreczko)
- Improving auth method setting #35 (kreczko)
- Condor id fix, better tests and puppet-lint fixes #33 (kreczko)
v1.1.0 (2014-10-16)
Closed issues:
- htcondor files ownership #14
Merged pull requests:
- Exclude condor-i686 and few other bits #32 (kashif74)
- A few small changes #31 (kreczko)
- New feature: ganglia #30 (kreczko)
- New feature: kerberos #29 (kreczko)
- Queues with hiera or config #28 (kreczko)
- Fairshares updated #27 (kreczko)
- email, default and filesystem domains #26 (kreczko)
- Request memory #25 (kreczko)
- adding option for DEV repositories #24 (kreczko)
- Defrag and partitionable slots #23 (kreczko)
- fix ":" -> "=" #22 (kreczko)
v1.0.0 (2014-08-07)
[Full Changelog](https://github.com/hep-puppet/htcondor/compare/New features...v1.0.0)
Closed issues:
Merged pull requests:
- Added defrag and healthcheck #19 (kashif74)
- make sure condor_reconfig is not run before service is up #18 (fschaer)
- allow user-defined templates to be specified #17 (fschaer)
- Fix3 #16 (fschaer)
- specify file ownership and allow for user (root) override, as this is #15 (fschaer)
- be librarian-puppet friendly #13 (fschaer)
- Changes for seperate scheduler configuartion #12 (kashif74)
- Fixes for Nagios tests #11 (kreczko)
- Fairshare fixes #10 (kreczko)
- Fixes for issues #4 and #8 + other stuff #9 (kreczko)
- Updating things for productin #7 (kreczko)
- new version #6 (kashif74)
- Added priority to repo #5 (kashif74)
- First working version of Puppet module for HTCondor #1 (kreczko)
Version 2.0.0
Version 2.0.0 brought big changes to the module. The biggest change is a structural one.
htcondor::params.pp
was added to set defaults for all the parameters.
In addition, parameters are attempted to be read via hiera
first. Full merge
support for hashes and arrays is provided.
With these changes the htcondor::config.pp
was split into six pieces:
- the main config setting up the rest
- a common config part
- the security configuration
- separate configs for manager, scheduler & worker The full detail of these changes can be seen in PR 53.
New features
- configure connection broker for private workers (i.e. workers that cannot be reached from the manager or scheduler but can reach the manager).
- enabled
ganglia
daemon for schedulers (previously only possible on managers) - flag to enable condor reporting, disabed by default
- added
use_anonymous_auth
- added
custom_machine_attributes
andcustom_machine_attributes
which can be used to add classads forSTARTD_ATTRS
andSTARTD_JOB_ATTRS
Bug fixes
- daemon list would be incorrect for some versions of Ruby. This was due to the use of
and
andor
operators which is incorrect for boolean comparisons. - added missing
cluster_has_multiple_domains
parameter (w.r.t to 2.0.0 beta) - removed repository dependency if it is disabled
Other
- changed config templates to ensure new line at the end of the file and reduced the use of
-%>
- workers are no longer able to write to schedulers by default
- new formatting for the security config: one line per entry for manager/scheduler/worker
- removed
use_pkg_config
parameter. - no longer changing
/etc/condor/condor_config
nor/etc/condor/condor_config.local
as recommended by the HTCondor team - content previously in
/etc/condor/condor_config.local
now in/etc/condor/config.d/00_config_local.config
* This Change Log was automatically generated by github_changelog_generator