apache2

This is focused on the needs that we have, specifically around Apache2 on OpenSuSE.
As such, it is not currently capable of managing every aspect of Apache2.
Please take a look at the .pp files to see default values for arguments.

Basic usage looks like this:

	#
	# Set up a basic Apache2 installation.
	#
	# reloadOnChange (bool): if true, reload after config changes
	# useDefaultModules (bool): if true, load standard set of modules
	#	defined in params.pp
	# (un)loadModules (array): module names to ensure are (un)loaded. This
	#	works with the defaultModules, adding or removing and creating
	#	a single final list of modules to enable.
	# serverInfoAccessIp (ip): allow this ip to access /server-info (if the
	#	info module is enabled)
	# serverStatusAccessIp (ip): allow this ip to access /server-status (if
	#	the status module is enabled)
	#
	# The AccessIp configs could also be done via apache2::grantAccessToIp
	#
	class { 'apache2':
		reloadOnChange          => true,
		useDefaultModules       => true,
		loadModules             => [ 'desiredModule' ],
		unloadModules           => [ 'undesiredModule' ],
		serverInfoAccessIp      => '192.168.1.0/24',
		serverStatusAccessIp    => '192.168.1.0/24',
	}

	#
	# Set up the ldap module.
	# This loads the ldap module and sets up /ldap-status. There is no need
	# to add 'ldap' to the loadModules list above if you use this class.
	#
	# ldapStatusAccessIp (ip): allow this ip to access /ldap-status
	#
	class { 'apache2::ldap' :
		ldapStatusAccessIp      => '192.168.1.0/24',
	}

	#
	# Set up the jk module for use with Tomcat.
	# This installs the apache2-mod_jk package and loads the jk module.
	#
	# jkLogLevel (string): sets the same param for JK
	# jkWorkerHost (string): sets the same param for JK
	# jkWorkerPort (string): sets the same param for JK
	# apps (array): set up a jkMount for the specified locations.
	#
	class { 'apache2::jk' :
		jkLogLevel	=> 'error',
		jkWorkerHost	=> 'localhost',
		jkWorkerPort	=> 8009,
		apps		=> [ 'manager' ],
	}

	#
	# You can also specify jkMount locations this way:
	#
	apache2::jk::addApp { 'host-manager' : }

	#
	# Add access to any location based on ip.  Can also add access based
	# on host by using grantAccessToHost with a "host" argument.
	# Note: this access control works for anything you can reference via
	#       Apache's <Location> blocks.
	#
	apache2::grantAccessToIp { 'jk-manager-cts' :
		location        => '/manager',
		ip              => '192.168.1.0/24',
	}
	apache2::grantAccessToIp { 'jk-host-manager-cts' :
		location        => '/host-manager',
		ip              => '192.168.1.0/24',
	}

	#
	# Turn on php5 (currently 5.4 in OpenSuSE 13.1)
	# This installs the apache2-php5 module and loads the php5 module.
	# Arguments specified in here override the defaults in php.ini, and
	# that file is left un-touched.
	# The apps "turn on" php for a specific <Location> or <Directory>. This
	# allows us to limit php use to the places where it is needed.
	#
	# phpVersion (string): one of [ '5.4', '5.5', '5.6' ] (default is 5.4)
	# phpMemoryLimit (string): overrides the memory_limit
	# phpErrorLog (string): location of the php-specific error log
	# phpExposePhp (string): on/off -- don't let on that php is running
	# phpTimezone (string): some things are angry if this isn't set
	# appDirs (array): set up php for the specified <Directory>(s)
	# appLocs (array): set up php for the specified <Location>(s)
	#
	class { 'apache2::php' :
		phpVersion	=> '5.4',
		phpMemoryLimit  => '96M',
		appDirs         => [ '/srv/www/htdocs/phpapp' ],
		appLocs         => [ '/phpapp2' ],
	}


Contact
-------
nospam@macwebb.com


Support
-------

Please log tickets and issues at the GitHub site. (https://github.com/sharumpe/puppet-apache2)