/rackspace_sysctl

Development repo for rackspace_sysctl cookbook

Primary LanguageRuby

rackspace_sysctl

This cookbook allows for setting syctl attributes by use of either a LWRP or by populating a known hash which will write out all values to sysctl.conf.

Description

Set sysctl values from Chef!

Attributes

  • node['rackspace_sysctl']['config'] - A predetermined hash for sysctl settings.

Usage

There are two ways of setting sysctl values:

  1. Set chef attributes in the rackspace_sysctl namespace. The key should be the exact directive expected by sysctl:

     node.set['rackspace_sysctl']['config']['vm.swappiness'] = 10

  2. Set values in a cookbook_file Resource.

  3. With Ressource/Provider.

Resource/Provider

This Cookbook includes two LWRPs:

  1. rackspace_sysctl
  2. rackspace_sysctl_multi

rackspace_sysctl

Actions

  • :save - Save and set a sysctl value (default).
  • :set - Set a sysctl value.
  • :remove - Remove a (previous set) sysctl.

Attribute Parameters

  • variable - Variable to manage. e.g. net.ipv4.ip_forward, vm.swappiness.
  • value - Value to affect to variable. e.g. 1, 0.
  • path - Path to a specific file.

Examples

###ruby

# Set 'vm.swappiness' to '60'. Will create /etc/sysctl.d/40-vm.wappiness.conf
rackspace_sysctl 'vm.swappiness' do
    value '40'
end

####the same. will create /etc/sysctl.d/40-vm_swappiness_to_60.conf

rackspace_sysctl 'vm swappiness to 60' do
  variable 'vm.swappiness'
  value '60'
end

####Remove /etc/sysctl.d/40-ip_config.conf rackspace_sysctl 'ip config' do action :remove end

Set swappiness but don't save it.

rackspace_sysctl 'vm.swappiness' do
  action :set
  value '40'
end

rackspace_sysctl_multi

Actions

  • :save - Save and set a sysctl value (default).
  • :set - set a sysctl value.
  • :remove - remove a (previous set) sysctl.

Attribute Parameters

  • instructions - Hash with instruction. e.g. {variable => value, variable2 => value2}. Override use of 'variable' and 'value'.
  • path - Path to a specific file.

Examples

####ruby

set multi variables. will create /etc/sysctl.d/69-ip_config.conf

rackspace_sysctl_multi 'ip config' do
  instructions {
    'net.ipv4.ip_forward' => '1',
    'net.ipv6.conf.all.forwarding' => '1',
    'net.ipv4.tcp_syncookies' => '1'}
end

Contributing

Testing

Licsense and Author

Copyright:: 2009-2013 Opscode, Inc

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.