← Back to branch summary

~nvalcarcel/ubuntu/lucid/puppet/fix-546677

« back to all changes in this revision

Viewing changes to ext/passenger/README

  • Committer: Bazaar Package Importer
  • Author(s): Chuck Short
  • Date: 2009-12-23 00:48:10 UTC
  • mfrom: (1.1.10 upstream) (3.1.7 squeeze)
  • Revision ID: james.westby@ubuntu.com-20091223004810-3i4oryds922g5n59
Tags: 0.25.1-3ubuntu1
* Merge from debian testing.  Remaining changes:
  - debian/rules:
    + Don't start puppet when first installing puppet.
  - debian/puppet.conf, lib/puppet/defaults.rb:
    + Move templates to /etc/puppet
  - lib/puppet/defaults.rb:
    + Fix /var/lib/puppet/state ownership.
  - man/man8/puppet.conf.8: 
    + Fix broken URL in manpage.
  - debian/control:
    + Update maintainer accordint to spec.
    + Puppetmaster Recommends -> Suggests
    + Created puppet-testsuite as a seperate. Allow the users to run puppet's 
      testsuite.
  - tests/Rakefile: Fix rakefile so that the testsuite can acutally be ran.

Show diffs side-by-side

added added

removed removed

Lines of Context:
ext/passenger/README
1
 
 
2
 
PUPPETMASTER INSIDE APACHE & PASSENGER
3
 
======================================
4
 
 
5
 
This is about running a puppetmaster inside Apache.
6
 
 
7
 
Please also see the docs at http://reductivelabs.com/trac/puppet/wiki/UsingPassenger
8
 
for further information.
9
 
 
10
 
 
11
 
WHAT IS IT?
12
 
===========
13
 
 
14
 
Passenger [1] (AKA mod_rails or mod_rack) is an Apache 2.x Extension for 
15
 
serving Rails or Rack applications.
16
 
 
17
 
This extension allows running a puppetmasterd as a Rack application;
18
 
it has only been tested with Passenger.
19
 
 
20
 
 
21
 
SHORT INSTALLATION INSTRUCTIONS
22
 
===============================
23
 
 
24
 
Make sure puppetmasterd ran at least once, so the SSL certificates
25
 
got set up. 
26
 
 
27
 
Install Rack:
28
 
  gem install -v 0.4.0 rack
29
 
 
30
 
Install Apache and Passenger:
31
 
  apt-get install apache2
32
 
  gem install passenger
33
 
  passenger-install-apache2-module
34
 
  (See the Passenger installation instructions [2] for details.)
35
 
 
36
 
Enable Apache modules:
37
 
  a2enmod ssl
38
 
  a2enmod headers
39
 
 
40
 
Configure Apache:
41
 
  cp apache2.conf /etc/apache2/conf.d/puppetmasterd
42
 
  vim /etc/apache2/conf.d/puppetmasterd (replace the server hostnames)
43
 
 
44
 
Install the rack application [3]:
45
 
  mkdir -p /usr/share/puppet/rack/puppetmasterd
46
 
  mkdir /usr/share/puppet/rack/puppetmasterd/public /usr/share/puppet/rack/puppetmasterd/tmp
47
 
  cp config.ru /usr/share/puppet/rack/puppetmasterd
48
 
  chown puppet /usr/share/puppet/rack/puppetmasterd/config.ru
49
 
 
50
 
Go:
51
 
/etc/init.d/apache2 restart
52
 
 
53
 
 
54
 
 
55
 
[1] http://www.modrails.com/
56
 
 
57
 
[2] http://www.modrails.com/install.html
58
 
 
59
 
[3] Passenger will not let applications run as root or the Apache user, 
60
 
instead an implicit setuid will be done, to the user whom owns 
61
 
config.ru. Therefore, config.ru shall be owned by the puppet user.
62
 
 
63