Puppet Class: network::global

Defined in:
manifests/global.pp

Overview

Class: network::global

Configures /etc/sysconfig/network

Parameters:

$hostname       - optional - Changes the hostname (be aware that it will break
                             something)
                             Note: When you reboot/restart puppet, it will
                             generate a new certificate and a new certificate
                             request, based on the new hostname; you will have to
                             sign it (if autosign is off).  You will also have to
                             provide a new node definition in the manifest based
                             on the new hostname.
$gateway        - optional - Sets the default gateway
$gatewaydev     - optional - Determines the device to use as the default gateway
                             Overrides $gateway in network::global.  Must have
                             $gateway defined in network::if or network::bond.
$ipv6gateway    - optional - Sets the default gateway for the IPv6 address - IPv6 must be enabled
$ipv6defaultdev - optional - Determines the device to use as the default gateway
                             for IPV6 traffic.
$nisdomain      - optional - Configures the NIS domainname.
$vlan           - optional - yes|no to enable VLAN kernel module
$ipv6networking - optional - enables / disables IPv6 globally
$nozeroconf     - optional

Actions:

Deploys the file /etc/sysconfig/network.

Requires:

Service['network']

Sample Usage:

class { 'network::global':
  hostname       => 'host.domain.tld',
  gateway        => '1.2.3.1',
  gatewaydev     => 'eth0',
  ipv6gateway    => '123:4567:89ab:cdef:123:4567:89ab:1',
  ipv6defaultdev => 'eth0',
  nisdomain      => 'domain.tld',
  vlan           => 'yes',
  ipv6networking => true,
  nozeroconf     => 'yes',
}

TODO:

Authors:

Mike Arnold <mike@razorsedge.org>

Copyright © 2011 Mike Arnold, unless otherwise noted.

Parameters:

  • hostname (Any) (defaults to: undef)
  • gateway (Any) (defaults to: undef)
  • gatewaydev (Any) (defaults to: undef)
  • ipv6gateway (Any) (defaults to: undef)
  • ipv6defaultdev (Any) (defaults to: undef)
  • nisdomain (Any) (defaults to: undef)
  • vlan (Any) (defaults to: undef)
  • ipv6networking (Any) (defaults to: false)
  • nozeroconf (Any) (defaults to: undef) 


61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
 
# File 'manifests/global.pp', line 61

class network::global (
  $hostname       = undef,
  $gateway        = undef,
  $gatewaydev     = undef,
  $ipv6gateway    = undef,
  $ipv6defaultdev = undef,
  $nisdomain      = undef,
  $vlan           = undef,
  $ipv6networking = false,
  $nozeroconf     = undef
) {
  # Validate our data
  if $gateway {
    if ! is_ip_address($gateway) { fail("${gateway} is not an IP address.") }
  }
  if $ipv6gateway {
    if ! is_ip_address($ipv6gateway) { fail("${ipv6gateway} is not an IPv6 address.") }
  }

  validate_bool($ipv6networking)

  # Validate our regular expressions
  if $vlan {
    $states = [ '^yes$', '^no$' ]
    validate_re($vlan, $states, '$vlan must be either "yes" or "no".')
  }

  validate_bool($ipv6networking)

  include '::network'

  case $::operatingsystem {
    /^(RedHat|CentOS|OEL|OracleLinux|SLC|Scientific)$/: {
      case $::operatingsystemrelease {
        /^[456]/: { $has_systemd = false }
        default: { $has_systemd = true }
      }
    }
    'Fedora': {
      case $::operatingsystemrelease {
        /^(1|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17)$/: { $has_systemd = false }
        default: { $has_systemd = true }
      }
    }
    default: {}
  }

  if $hostname and $has_systemd {
    exec { 'hostnamectl set-hostname':
      command => "hostnamectl set-hostname ${hostname}",
      unless  => "hostnamectl --static | grep ^${hostname}$",
      path    => '/bin:/usr/bin',
    }
  }

  file { 'network.sysconfig':
    ensure  => 'present',
    mode    => '0644',
    owner   => 'root',
    group   => 'root',
    path    => '/etc/sysconfig/network',
    content => template('network/network.erb'),
    notify  => Service['network'],
  }
}