Merge branch 'fix_munin_plguin_install' into 'master'
[puppet_passenger.git] / README
1 Passenger (mod_rails) puppet module
2 -----------------------------------
3
4 This puppet module handles a passenger setup, it installs the
5 packages, and configures some munin graphs.
6
7 Dependencies
8 ------------
9
10 This module expects you to have:
11  . apache module
12
13 Optional:
14  . munin module
15
16 Getting started
17 ---------------
18
19 Simply do 'include passenger' and it will be installed. 
20
21 Configuration
22 -------------
23
24 If you need to install a specific version of passenger or
25 librack-ruby, you can specify the version to be installed by providing
26 a variable, for example:
27
28 class { 'passenger': 
29   passenger_ensure_version => '2.2.23-2~bpo50+1',
30   librack-ruby_ensure_version = "1.0.0-2~bpo50+1"
31 }
32
33 If you wish to use gems, pass 'use_gems => true'.
34
35 By default munin will be used, but you can disable that by passing
36 'use_munin => false'.
37
38 If you need to set different munin plugin configuration values, you
39 can also do so as follows:
40
41 $passenger_memory_munin_config = "user root\nenv.passenger_memory_stats /opt/bin/passenger-memory-stats"
42 $passenger_stats_munin_config = "user root\nenv.PASSENGER_TMPDIR /var/tmp\n"