oddjob

Table of Contents

• Module Description
• Setup
  • What oddjob affects
  • Setup Requirements
  • Beginning with oddjob
• Usage
  • I want to set default user umask for home directories
• Limitations
• Development
• Acceptance tests

Module Description

This module ensures the oddjobd package is installed, service is running and configures oddjob-mkhomedir.

See REFERENCE.md for API details.

Setup

What oddjob affects

This module will ensure oddjob is installed and the service is running. Additionally, it will use a custom template to create the mkhomedir oddjob enforcing umask.

Setup Requirements

simp/oddjob requires simp/simplib if using the mkhomedir class.

Beginning with oddjob

include 'oddjob'

Usage

I want to set default user umask for home directories

include 'oddjob'
include 'oddjob::mkhomedir'

With Hieradata:

oddjob::mkhomedir::umask: '0077'

Limitations

SIMP Puppet modules are generally intended to be used on a Red Hat Enterprise Linux-compatible distribution.

Development

Please read our Contribution Guide.

If you find any issues, they can be submitted to our JIRA.

Acceptance tests

To run the system tests, you need Vagrant installed.

You can then run the following to execute the acceptance tests:

   bundle exec rake beaker:suites

Some environment variables may be useful:

   BEAKER_debug=true
   BEAKER_provision=no
   BEAKER_destroy=no
   BEAKER_use_fixtures_dir_for_modules=yes

• BEAKER_debug: show the commands being run on the STU and their output.
• BEAKER_destroy=no: prevent the machine destruction after the tests finish so you can inspect the state.
• BEAKER_provision=no: prevent the machine from being recreated. This can save a lot of time while you're writing the tests.
• BEAKER_use_fixtures_dir_for_modules=yes: cause all module dependencies to be loaded from the spec/fixtures/modules directory, based on the contents of .fixtures.yml. The contents of this directory are usually populated by bundle exec rake spec_prep. This can be used to run acceptance tests to run on isolated networks.

Reference

Table of Contents

Classes

• oddjob: This class ensures that the basic oddjobd service is running and provides for an entry point to other oddjob functions and configuration.
• oddjob::mkhomedir: class oddjob::mkhomedir This configures the oddjob-mkhomedir

Classes

oddjob

This class ensures that the basic oddjobd service is running and provides for an entry point to other oddjob functions and configuration.

Parameters

The following parameters are available in the oddjob class:

• package_ensure

package_ensure

Data type: String

The ensure status of package to be managed

Default value: simplib::lookup('simp_options::package_ensure', { 'default_value' => 'installed' })

oddjob::mkhomedir

class oddjob::mkhomedir

This configures the oddjob-mkhomedir

Parameters

The following parameters are available in the oddjob::mkhomedir class:

• umask
• package_ensure

umask

Data type: Simplib::Umask

Default value: '0027'

package_ensure

Data type: String

The ensure status of packages to be managed

Default value: simplib::lookup('simp_options::package_ensure', { 'default_value' => 'installed' })

• Wed Dec 06 2023 oliparcol oliparcol@noreply.github.com - 2.8.0

• Make sure oddjob-mkhomedir is installed before modifying configuration

• Mon Oct 23 2023 Steven Pritchard steve@sicura.us - 2.7.0

• [puppetsync] Add EL9 support

• Wed Oct 11 2023 Steven Pritchard steve@sicura.us - 2.6.0

• [puppetsync] Updates for Puppet 8
  • These updates may include the following:
    • Update Gemfile
    • Add support for Puppet 8
    • Drop support for Puppet 6
    • Update module dependencies

• Wed Aug 23 2023 Steven Pritchard steve@sicura.us - 2.5.0

• Add AlmaLinux 8 support

• Mon Jun 12 2023 Chris Tessmer chris.tessmer@onyxpoint.com - 2.4.0

• Add RockyLinux 8 support

• Wed Jun 16 2021 Chris Tessmer chris.tessmer@onyxpoint.com - 2.3.0

• Removed support for Puppet 5
• Ensured support for Puppet 7 in requirements and stdlib

• Fri Dec 18 2020 Chris Tessmer chris.tessmer@onyxpoint.com - 2.2.1

• Removed EL6 support

• Fri Dec 20 2019 Trevor Vaughan tvaughan@onyxpoint.com - 2.2.0-0

• Add EL8 support
• Updated README.md
• Added REFERENCE.md

• Fri Aug 02 2019 Robert Vincent pillarsdotnet@gmail.com - 2.2.0-0

• Drop Puppet 4 support
• Add Puppet 6 support
• Add puppetlabs-stdlib 6 support

• Tue Feb 12 2019 Liz Nemsick lnemsick-simp@gmail.com - 2.1.1-0

• Remove unnecessary use of validate_umask(), a deprecated simplib Puppet 3 function.
• Update the upper bound of stdlib to < 6.0.0
• Update a URL in the README.md

• Tue Nov 06 2018 Liz Nemsick lnemsick-simp@gmail.com - 2.1.0-0

• Update to onyxpoint OEL boxes in acceptance tests
• Update badges and contribution guide URL in README.md

• Thu Oct 11 2018 Nick Miller nick.miller@onyxpoint.com - 2.1.0-0

• Added $package_ensure and $oddbob::mkhomedir::package_ensure parameter
  • Changed the packages from 'latest' to 'installed'
  • It will also respect simp_options::package_ensure

• Fri Mar 23 2018 Trevor Vaughan tvaughan@onyxpoint.com - 2.1.0-0

• Add support for Puppet 5 and OEL

• Thu Jul 06 2017 Liz Nemsick lnemsick.simp@gmail.com - 2.0.1-0

• Confine puppet version in metadata.json

• Wed Nov 23 2016 Jeanne Greulich jgreulich@onyxpoint.com - 2.0.0-0

• Bump major version for SIMP 6.0

• Mon Nov 21 2016 Chris Tessmer chris.tessmer@onyxpoint.com - 1.0.2-0

• Minor cleanup

• Mon Nov 09 2015 Chris Tessmer chris.tessmer@onypoint.com - 1.0.0-2

• migration to simplib and simpcat (lib/ only)

• Fri Jan 16 2015 Trevor Vaughan tvaughan@onyxpoint.com - 1.0.0-1

• Changed puppet-server requirement to puppet

• Wed Jul 23 2014 Trevor Vaughan tvaughan@onyxpoint.com - 1.0.0-0

• Created the first cut at the oddjob module for use by PAM