Puppet Class: confdroid_apache::params

Summary

This class holds all parameters for the confdroid_apache module, which are inherited by all classes except defines.

Overview

confdroid_apache::params.pp Module name: confdroid_apache Author: 12ww1160 (12ww1160@confdroid.com)

Parameters:

  • pkg_ensure (String) (defaults to: 'present')

    Specify which package type to use, i.e. latest, present or absent.

  • ae_manage_user (Boolean)

    Whether or not to manage details for the httpd service user. This is generally only required when using httpd on a number of servers sharing storage resources, i.e. NFS, where UID and GID settings must be same across all nodes.

  • ae_user_name (String)

    Specify the user name for the httpd user. only active if ae_manage_user is set to true.

  • ae_user_uid (String)

    Specify the UID for the httpd service user. only active if ae_manage_user is set to true.

  • ae_u_comment (String)

    Specify the user comment for /etc/passwd. Shows up in email notifications as sender information. only active if ae_manage_user is set to true.

  • ae_u_groups (String)

    Specify any secondary groups the httpd service user should be in. Must not contain the primary group. only active if ae_manage_user is set to true.

  • ae_user_home (String)

    Specify the home of the httpd service user. only active if ae_manage_user is set to true.

  • ae_user_shell (String)

    Specify the shell for the httpd service user, which normally should not be allowed to log in . only active if ae_manage_user is set to true.

  • ae_manage_cfg (Boolean) (defaults to: false)

    Whether or not to manage the httpd configuration. httpd is very often a sub system used by many other services, and the required configuration depends on the use case. If using httpd as sub-service ( i.e. for phpmyadmin, Nagios etc.), the main configuration should be done on that end, not in confdroid_apache. IN that case, set ae_manage_cfg to false.

  • ae_manage_dirs (Boolean) (defaults to: true)

    Whether or not main directories required to run httpd should be managed. Typically this should be set to true.

  • ae_allow_user_dirs (Boolean) (defaults to: false)

    Whether or not to allow user directories should be allowed to share content through httpd. Usually this is a security problem and as such should be disabled.

  • ae_incl_target (Boolean) (defaults to: true)

    whether or not to allow nagios monitoring.

  • ae_order_no (String) (defaults to: '50')

    the order number for the firewall rules

  • ae_http_port (String) (defaults to: '80')

    the port to use for the http protocol

  • ae_https_port (String) (defaults to: '443')

    the port to use for the https protocol

  • ae_target_service (String) (defaults to: '/etc/nagios/conf.d/httpd_service.cfg')

    which service to monitor with nagios

  • ae_manage_fw (Boolean) (defaults to: false)

    whether to manage firewall settings

  • reqpackages (Array) (defaults to: ['httpd','mod_ssl'])

    List of packages to install.



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
# File 'manifests/params.pp', line 46

class confdroid_apache::params (

# installation
  String $pkg_ensure         = 'present',
  Array $reqpackages        = ['httpd','mod_ssl'],

# configuration files
  Boolean $ae_manage_cfg      = false,
  Boolean $ae_manage_dirs     = true,
  Boolean $ae_allow_user_dirs = false,

# nagios
  Boolean $ae_incl_target     = true,
  String $ae_target_service  = '/etc/nagios/conf.d/httpd_service.cfg',

# firewall
  Boolean $ae_manage_fw       = false,
  String $ae_order_no        = '50',
  String $ae_http_port       = '80',
  String $ae_https_port      = '443',

) {
# service
  $ae_service         = 'httpd'

# directories
  $ae_main_dir        = '/etc/httpd'
  $ae_conf_dir        = "${ae_main_dir}/conf"
  $ae_conf_d_dir      = "${ae_main_dir}/conf.d"
  $ae_conf_mods_d     = "${ae_main_dir}/conf.modules.d"
  $ae_var_logs_dir    = '/var/log/httpd'
  $ae_logs_dir        = "${ae_main_dir}/logs"
  $ae_usr_lib_dir     = '/usr/lib64/httpd'
  $ae_usr_mods_dir    = "${ae_usr_lib_dir}/modules"
  $ae_mods_dir        = "${ae_main_dir}/modules"
  $ae_run_dir         = '/run/httpd'
  $ae_run_link        = "${ae_main_dir}/run"
  $ae_share_httpd     = '/usr/share/httpd'
  $ae_cache_httpd     = '/var/cache/httpd'

# files
  $ae_conf_file       = "${ae_conf_dir}/httpd.conf"
  $ae_conf_file_erb   = 'confdroid_apache/httpd_conf.erb'
  $ae_magic_file      = "${ae_conf_dir}/magic"
  $ae_magic_file_erb  = 'confdroid_apache/magic.erb'
  $ae_ssl_file        = "${ae_conf_d_dir}/ssl.conf"
  $ae_ssl_file_erb    = 'confdroid_apache/ssl_conf.erb'
  $ae_autoindex_file  = "${ae_conf_d_dir}/autoindex.conf"
  $ae_autoindex_erb   = 'confdroid_apache/autoindex_conf.erb'
  $ae_userdir_file    = "${ae_conf_d_dir}/userdir.conf"
  $ae_userdir_erb     = 'confdroid_apache/userdir_conf.erb'
  $ae_index_file      = '/var/www/html/index.html'
  $ae_index_erb       = 'confdroid_apache/index_html.erb'

# includes must be last
  include confdroid_apache::main::config
}