Puppet Class: httpd::mpm

Defined in:
modules/httpd/manifests/mpm.pp

Overview

SPDX-License-Identifier: Apache-2.0

Class: httpd::mpm

This class allows you to select an Apache Multi-Processing Module (or MPM). MPMs are mutually exclusive; you can only enable one. The MPMs available for you to choose from are prefork, worker, and event.

Worker and event scale better, but they don't work with any modules which are not thread-safe, like PHP.

See <httpd.apache.org/docs/current/mpm.html> for details.

Parameters

mpm

Name of the chosen MPM. Must be 'prefork', 'worker', or 'event'. The default is 'prefork'.

source

A puppet URL to a file containing the mpm specific configuration required. Defaults to undef.

content

A template that contains path to erb file. Defaults to undef.

Parameters:

  • mpm (Enum['prefork', 'event', 'worker']) (defaults to: 'worker')
  • source (Optional[String]) (defaults to: undef)
  • content (Optional[String]) (defaults to: undef) 


28
29
30
31
32
33
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
 
# File 'modules/httpd/manifests/mpm.pp', line 28

class httpd::mpm(
    Enum['prefork', 'event', 'worker'] $mpm = 'worker',
    Optional[String] $source  = undef,
    Optional[String] $content  = undef,
) {
    ensure_packages('apache2')
    $selected_mod = "mpm_${mpm}"
    $available_mpms = ['prefork', 'worker', 'event']

    # mod_php* is unsafe for threaded MPMs
    if $mpm != 'prefork' {
        httpd::mod_conf { ['php5', 'php7.0', 'php7.2','php7.4']:
            ensure => absent,
            before => Httpd::Mod_conf[$selected_mod],
        }
    }

    # Module config
    file { "/etc/apache2/mods-available/mpm_${mpm}.load":
        ensure => present,
        owner  => 'root',
        group  => 'root',
        mode   => '0444',
    }

    if $source or $content {
        file { "/etc/apache2/mods-available/mpm_${mpm}.conf":
            ensure  => present,
            owner   => 'root',
            group   => 'root',
            mode    => '0444',
            source  => $source,
            content => $content,
        }
    }

    # Disable the other mpms, enable the selected one.
    $rejected_mpms = prefix(reject($available_mpms, $mpm), 'mpm_')
    httpd::mod_conf { $rejected_mpms:
        ensure => absent,
    }

    httpd::mod_conf { "mpm_${mpm}":
        ensure => present,
        notify => Exec['apache2_test_config_and_restart']
    }
}