Puppet Class: motd

Defined in:
manifests/init.pp

Summary

This module configures a system message of the day on a wide variety of systems.

Overview

Examples:

Basic usage

include motd

Parameters:

  • dynamic_motd (Boolean) (defaults to: true) —

    Enables or disables dynamic motd on Debian systems.

  • template (Optional[String]) (defaults to: undef) —

    Specifies a custom template. A template takes precedence over ‘content`. Valid options: ’/mymodule/mytemplate.erb’.

  • content (Optional[String]) (defaults to: undef) —

    Specifies a static string as the motd content.

  • issue_template (Optional[String]) (defaults to: undef) —

    Specifies a custom template to process and save to ‘/etc/issue`. A template takes precedence over `issue_content`.

  • issue_content (Optional[String]) (defaults to: undef) —

    Specifies a static string as the ‘/etc/issue` content.

  • issue_net_template (Optional[String]) (defaults to: undef) —

    Specifies a custom template to process and save to ‘/etc/issue.net`. A template takes precedence over `issue_net_content`.

  • issue_net_content (Optional[String]) (defaults to: undef) —

    Specifies a static string as the ‘/etc/issue.net` content.

  • windows_motd_title (String) (defaults to: 'Message of the day') —

    Specifies a static string to be used for: ‘HKEY_LOCAL_MACHINESoftwareMicrosoftWindowsCurrentVersionpoliciessystemlegalnoticetext’ and ‘HKEY_LOCAL_MACHINESoftwareMicrosoftWindowsCurrentVersionpoliciessystemlegalnoticecaption’ The ‘legalnoticetext’ registry key is shown before login on a Windows system.



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
 
# File 'manifests/init.pp', line 34

class motd (
  Boolean $dynamic_motd                 = true,
  Optional[String] $template            = undef,
  Optional[String] $content             = undef,
  Optional[String] $issue_template      = undef,
  Optional[String] $issue_content       = undef,
  Optional[String] $issue_net_template  = undef,
  Optional[String] $issue_net_content   = undef,
  String $windows_motd_title            = 'Message of the day',
) {
  if $template {
    if $content {
      warning('Both $template and $content parameters passed to motd, ignoring content')
    }
    $motd_content = epp($template)
  } elsif $content {
    $motd_content = $content
  } else {
    $motd_content = epp('motd/motd.epp')
  }

  if $issue_template {
    if $issue_content {
      warning('Both $issue_template and $issue_content parameters passed to motd, ignoring issue_content')
    }
    $_issue_content = epp($issue_template)
  } elsif $issue_content {
    $_issue_content = $issue_content
  } else {
    $_issue_content = false
  }

  if $issue_net_template {
    if $issue_net_content {
      warning('Both $issue_net_template and $issue_net_content parameters passed to motd, ignoring issue_net_content')
    }
    $_issue_net_content = epp($issue_net_template)
  } elsif $issue_net_content {
    $_issue_net_content = $issue_net_content
  } else {
    $_issue_net_content = false
  }

  $owner = $facts['kernel'] ? {
    'AIX'   => 'bin',
    default => 'root',
  }

  $group = $facts['kernel'] ? {
    'AIX'   => 'bin',
    'FreeBSD' => 'wheel',
    default => 'root',
  }

  $mode = $facts['kernel'] ? {
    default => '0644',
  }

  File {
    owner => $owner,
    group => $group,
    mode  => $mode,
  }

  if $facts['kernel'] in ['Linux', 'SunOS', 'FreeBSD', 'AIX'] {
    if $facts['kernel'] == 'FreeBSD' {
      if versioncmp($facts['os']['release']['major'], '13') >= 0 {
        $_motd_location = '/etc/motd.template'
      } else {
        $_motd_location = '/etc/motd'
      }
    } else {
      $_motd_location = '/etc/motd'

      if $_issue_content {
        file { '/etc/issue':
          ensure  => file,
          backup  => false,
          content => $_issue_content,
        }
      }

      if $_issue_net_content {
        file { '/etc/issue.net':
          ensure  => file,
          backup  => false,
          content => $_issue_net_content,
        }
      }
    }

    file { $_motd_location:
      ensure  => file,
      backup  => false,
      content => $motd_content,
    }

    if ($facts['os']['family'] == 'Debian') and ($dynamic_motd == false) {
      if $facts['os']['name'] == 'Debian' and versioncmp($facts['os']['release']['major'], '7') > 0 {
        $_line_to_remove = 'session    optional     pam_motd.so  motd=/run/motd.dynamic'
      } elsif $facts['os']['name'] == 'Ubuntu' and versioncmp($facts['os']['release']['major'], '16.00') > 0 {
        $_line_to_remove = 'session    optional     pam_motd.so  motd=/run/motd.dynamic'
      } else {
        $_line_to_remove = 'session    optional     pam_motd.so  motd=/run/motd.dynamic noupdate'
      }

      file_line { 'dynamic_motd':
        ensure => absent,
        path   => '/etc/pam.d/sshd',
        line   => $_line_to_remove,
      }
    }
  } elsif $facts['kernel'] == 'windows' {
    registry_value { 'HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\policies\system\legalnoticecaption':
      ensure => present,
      type   => string,
      data   => $windows_motd_title,
    }
    registry_value { 'HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\policies\system\legalnoticetext':
      ensure => present,
      type   => string,
      data   => $motd_content,
    }
  }
}