Signed-off-by: Jacob Helwig <[email protected]>
---
ext/passenger/README.markdown | 117 ++++++++++++++++++++++++++++++++++++
ext/passenger/dashboard-vhost.conf | 29 ---------
2 files changed, 117 insertions(+), 29 deletions(-)
create mode 100644 ext/passenger/README.markdown
delete mode 100644 ext/passenger/dashboard-vhost.conf
diff --git a/ext/passenger/README.markdown b/ext/passenger/README.markdown
new file mode 100644
index 0000000..08559b7
--- /dev/null
+++ b/ext/passenger/README.markdown
@@ -0,0 +1,117 @@
+Puppet Dashboard & Passenger
+============================
+
+Ubuntu 10.04
+------------
+
+1. Install Puppet Dashboard.
+
+2. Configure `config/database.yml`.
+
+3. Install Apache 2 and the build environment for Passenger:
+
+ aptitude install apache2 build-essential ruby-dev libopenssl-ruby
apache2-prefork-dev
+
+4. Install the Passenger gem:
+
+ gem install passenger
+
+5. Install the Passenger Apache module and follow its instructions for
setting up Apache:
+
+ passenger-install-apache2-module
+
+6. The previous step should have had you add something like the following to
`/etc/apache2/apache2.conf`:
+
+ LoadModule passenger_module
/usr/lib/ruby/gems/1.8/gems/passenger-2.2.15/ext/apache2/mod_passenger.so
+ PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-2.2.15
+ PassengerRuby /usr/bin/ruby1.8
+
+7. Add the vhost configuration in
`/etc/apache2/sites-available/puppet-dashboard`:
+
+ <VirtualHost *:80>
+ ServerName dashboard.example.com
+ DocumentRoot /usr/share/puppet-dashboard/public/
+ <Directory /usr/share/puppet-dashboard/public/>
+ AllowOverride All
+ Options -MultiViews
+ </Directory>
+
+ ErrorLog /var/log/apache2/dashboard.example.com_error.log
+ LogLevel warn
+ CustomLog /var/log/apache2/dashboard.example.com_access.log combined
+ ServerSignature On
+ </VirtualHost>
+
+8. Enable the vhost configuration:
+
+ cd /etc/apache2/sites-enabled && ln -s
../sites-available/puppet-dashboard .
+
+9. Restart Apache 2:
+
+ service apache2 restart
+
+CentOS 5
+--------
+
+1. Install Puppet Dashboard.
+
+2. Configure `config/database.yml`.
+
+3. Install Apache 2 and the build environment for Passenger:
+
+ yum install httpd httpd-devel gcc-g++
+
+4. Install the Passenger gem:
+
+ gem install passenger
+
+5. Install the Passenger Apache module and follow its instructions for
setting up Apache:
+
+ passenger-install-apache2-module
+
+6. The previous step should have had you add something like the following to
`/etc/httpd/conf/httpd.conf`:
+
+ LoadModule passenger_module
/usr/lib/ruby/gems/1.8/gems/passenger-2.2.15/ext/apache2/mod_passenger.so
+ PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-2.2.15
+ PassengerRuby /usr/bin/ruby
+
+7. Enable name-based virtual hosts by uncommenting the following line in
/etc/httpd/conf/httpd.conf:
+
+ NameVirtualHost *:80
+
+8. Add the vhost configuration to the end of `/etc/httpd/conf/httpd.conf`:
+
+ <VirtualHost *:80>
+ ServerName dashboard.example.com
+ DocumentRoot /usr/share/puppet-dashboard/public/
+ <Directory /usr/share/puppet-dashboard/public/>
+ AllowOverride All
+ Options -MultiViews
+ </Directory>
+
+ ErrorLog /var/log/httpd/dashboard.example.com_error.log
+ LogLevel warn
+ CustomLog /var/log/httpd/dashboard.example.com_access.log combined
+ ServerSignature On
+ </VirtualHost>
+
+9. Add a puppet-dashboard user, unless you have installed from the .rpm:
+
+ useradd -r -d /usr/share/puppet-dashboard -c 'Puppet Dashboard'
puppet-dashboard
+
+10. Make sure `config/environment.rb`, `log`, `public`, and `tmp` are owned by
puppet-dashboard:
+
+ mkdir /usr/share/puppet-dashboard/tmp
+ chown -R puppet-dashboard:puppet-dashboard
/usr/share/puppet-dashboard/{config/environment.rb,log,public,tmp}
+
+11. Turn off SELinux:
+
+ /usr/sbin/setenforce 0
+
+12. Disable SELinux at boot time by modifying `/etc/selinux/config`:
+
+ SELINUX=disabled
+
+13. Restart Apache 2:
+
+ service httpd restart
diff --git a/ext/passenger/dashboard-vhost.conf
b/ext/passenger/dashboard-vhost.conf
deleted file mode 100644
index 9f8f19c..0000000
--- a/ext/passenger/dashboard-vhost.conf
+++ /dev/null
@@ -1,29 +0,0 @@
-# You will need to update the module path and passenger version to suit your
environment
-# You will also need to specify the name of your virtual host and FQDN.
-
-LoadModule passenger_module
/var/lib/gems/1.8/gems/passenger-2.2.11/ext/apache2/mod_passenger.so
-PassengerRoot /var/lib/gems/1.8/gems/passenger-2.2.11
-PassengerRuby /usr/bin/ruby
-
-# you probably want to tune these settings
-PassengerHighPerformance on
-PassengerMaxPoolSize 12
-PassengerPoolIdleTime 1500
-# PassengerMaxRequests 1000
-PassengerStatThrottleRate 120
-RailsAutoDetect On
-
-<VirtualHost *:80>
- ServerName dashboard.example.com
- DocumentRoot /usr/share/puppet-dashboard/public/
- <Directory /usr/share/puppet-dashboard/public/>
- Options None
- AllowOverride AuthConfig
- Order allow,deny
- allow from all
- </Directory>
- ErrorLog /var/log/apache2/dashboard.example.com_error.log
- LogLevel warn
- CustomLog /var/log/apache2/dashboard.example.com_access.log combined
- ServerSignature On
-</VirtualHost>
--
1.7.3.1
--
You received this message because you are subscribed to the Google Groups
"Puppet Developers" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/puppet-dev?hl=en.
