This is a module for managing simp_ipa server and client installations.
See REFERENCE.md for the full module reference.
This module is a component of the System Integrity Management Platform, a compliance-management framework built on Puppet.
If you find any issues, they may be submitted to our bug tracker.
The simp_ipa module is quite minimal at the moment, it can only join and
remove hosts from an IPA domain.
The simp_ipa class is a just a placeholder for now.
simp_ipa::client::install and related parameters will run ipa-client-install on systems if it needs it. You can either use discovery
(provided you have DNS set up correctly) or manually set all the parameters
required. See the reference material for further documentation.
Join a domain using ipa-client-install:
bolt task run simp_ipa::join --nodes <nodes> server=ipa.example.com options='--verbose --mkhomedir'Other options can be added to the options parameter, like
options='--mkhomedir --verbose'.
Leave a domain:
bolt task run simp_ipa::leave --nodes <nodes> domain=<domain> options='--verbose'Tasks are also available from the Puppet Enterprise console.
Please read our Contribution Guide.
This module includes Beaker acceptance tests using the SIMP Beaker Helpers. By default the tests use Vagrant with VirtualBox as a back-end; Vagrant and VirtualBox must both be installed to run these tests without modification. To execute the tests run the following:
bundle install
bundle exec rake beaker:suitesNOTE: When testing this module, you will probably want to run with
BEAKER_destroy=no, install the simp_ipa client locally and connect to the
running VM to ensure proper functionality.
Please refer to the SIMP Beaker Helpers documentation for more information.