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
$restart        - optional - defaults to true
$requestreopen  - optional - defaults to true

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',
  requestreopen  => false,
}

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)
  • restart (Any) (defaults to: true)
  • requestreopen (Any) (defaults to: true) 


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
126
127
128
129
130
131
132
133
134
135
 
# File 'manifests/global.pp', line 64

class network::global (
  $hostname       = undef,
  $gateway        = undef,
  $gatewaydev     = undef,
  $ipv6gateway    = undef,
  $ipv6defaultdev = undef,
  $nisdomain      = undef,
  $vlan           = undef,
  $ipv6networking = false,
  $nozeroconf     = undef,
  $restart        = true,
  $requestreopen  = true,
) {
  # 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_bool($restart)
  validate_bool($requestreopen)

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

  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'),
  }

  if $restart {
    File['network.sysconfig'] {
      notify  => Service['network'],
    }
  }
}