augeasproviders_grub
Version information
This version is compatible with:
- Puppet >= 2.7.0 < 4.0.0
- , ,
This module has been deprecated by its author since Oct 19th 2022.
The author has suggested puppet-augeasproviders_grub as its replacement.
Start using this module
Documentation
grub: type/provider for grub files for Puppet
This module provides a new type/provider for Puppet to read and modify grub config files using the Augeas configuration library.
The advantage of using Augeas over the default Puppet parsedfile
implementations is that Augeas will go to great lengths to preserve file
formatting and comments, while also failing safely when needed.
This provider will hide all of the Augeas commands etc., you don't need to know anything about Augeas to make use of it.
Requirements
Ensure both Augeas and ruby-augeas 0.3.0+ bindings are installed and working as normal.
See Puppet/Augeas pre-requisites.
Installing
On Puppet 2.7.14+, the module can be installed easily (documentation):
puppet module install herculesteam/augeasproviders_grub
You may see an error similar to this on Puppet 2.x (#13858):
Error 400 on SERVER: Puppet::Parser::AST::Resource failed with error ArgumentError: Invalid resource type `kernel_parameter` at ...
Ensure the module is present in your puppetmaster's own environment (it doesn't
have to use it) and that the master has pluginsync enabled. Run the agent on
the puppetmaster to cause the custom types to be synced to its local libdir
(puppet master --configprint libdir
) and then restart the puppetmaster so it
loads them.
Compatibility
Puppet versions
Minimum of Puppet 2.7.
Augeas versions
Augeas Versions | 0.10.0 | 1.0.0 | 1.1.0 | 1.2.0 |
---|---|---|---|---|
PROVIDERS | ||||
kernel_parameter (grub) | yes | yes | yes | yes |
kernel_parameter (grub2) | yes | yes | yes | yes |
Documentation and examples
Type documentation can be generated with puppet doc -r type
or viewed on the
Puppet Forge page.
kernel_parameter provider
This is a custom type and provider supplied by augeasproviders
. It supports
both GRUB Legacy (0.9x) and GRUB 2 configurations.
manage parameter without value
kernel_parameter { "quiet":
ensure => present,
}
manage parameter with value
kernel_parameter { "elevator":
ensure => present,
value => "deadline",
}
manage parameter with multiple values
kernel_parameter { "rd_LVM_LV":
ensure => present,
value => ["vg/lvroot", "vg/lvvar"],
}
manage parameter on certain boot types
Bootmode defaults to "all", so settings are applied for all boot types usually.
Apply only to the default boot:
kernel_parameter { "quiet":
ensure => present,
bootmode => "default",
}
Apply only to normal boots. In GRUB legacy, normal boots consist of the default boot plus non-recovery ones. In GRUB2, normal bootmode is just an alias for default.
kernel_parameter { "quiet":
ensure => present,
bootmode => "normal",
}
Only recovery mode boots (unsupported with GRUB 2):
kernel_parameter { "quiet":
ensure => present,
bootmode => "recovery",
}
delete entry
kernel_parameter { "rhgb":
ensure => absent,
}
manage parameter in another config location
kernel_parameter { "elevator":
ensure => present,
value => "deadline",
target => "/mnt/boot/grub/menu.lst",
}
Issues
Please file any issues or suggestions on GitHub.
Types in this module release
Changelog
2.2.0
- Add support for bootmode 'default' (issue #3)
2.1.0
- Set default to grub2 provider on el7 based systems (fix #9)
- Load lenses from lib/augeas/lenses in tests
- Add Puppet 4 to test matrix
2.0.1
- Fix metadata.json
- Various minor updates to Travis test configuration
2.0.0
- First release of split module.
Dependencies
- herculesteam/augeasproviders_core (>=2.0.0)
augeasproviders: alternative Augeas-based providers for Puppet Copyright (c) 2012-2014 Dominic Cleal and Raphaël Pinson Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.