The Puppet Labs Issue Tracker has Moved:

This issue tracker is now in read-only archive mode and automatic ticket export has been disabled. Redmine users will need to create a new JIRA account to file tickets using See the following page for information on filing tickets with JIRA:

Bug #6579

ext/rack/README clarifications

Added by Justin Honold about 5 years ago. Updated over 2 years ago.

Status:ClosedStart date:03/03/2011
Priority:NormalDue date:
Assignee:Nick Fagerlund% Done:


Target version:-
Keywords: Affected URL:

We've Moved!

Ticket tracking is now hosted in JIRA:


I set upon configuring a more scalable Puppet infrastructure. –> –> –>

I’m running 2.6.x, and it said “Please see ext/rack/README in the puppet source tree for instructions.” I took this to mean a redirect, as in “look there and stop reading this document.”

  • Rack 1.0.0 is explicitly stated, but I’ve found that the current 1.2.1 Gem works
  • It could be specified that “” is what needs to change to the host’s FQDN
  • [puppetmasterd] is suggested in puppet.conf, but manual runs warn that it’s deprecated in favor of [master]
  • It directs users toward a manifest which fails on Ubuntu 10.04 hosts (Could not find dependency Package[apache2] for File[/etc/apache2/conf.d/puppetmasterd])
  • The manifest is suggested as a reference for one’s own module, rather than necessary Passenger configuration
  • “the boring stuff” is not specified in the document, even in outline form
  • is referenced, but its source and destination locations aren’t
  • Looking back at the page, it became more clear to me that there were additional instructions past what was declared as the “Installation instructions” for older versions, which needed to be adapted
  • A file for 2.6.x isn’t declared on the wiki page along with the others

This part may be more of a ‘code’ issue, but the Puppet-included apache2.conf doesn’t have the “Suggested Tweaks” included at the bottom of the wiki page; if they are suggested, I would also expect them to be standard.

I think the instructions could be split into version-specific sections, so there are just distro-specific rather than version-specific settings. Overall, I would like to use either the README or the docs, but not a mix of both. For reference, the command set I used to configure an Ubuntu 10.04 LTS system with an already-functioning Gem-installed 2.6.5 puppetmasterd and Apache setup:

sudo gem install rack
sudo apt-get -y install libapache2-mod-passenger
sudo cp /var/lib/gems/1.8/gems/puppet-`puppet --version`/ext/rack/files/apache2.conf /etc/apache2/sites-available/puppet-passenger
sudo sed -i "s/`hostname -f`/" puppet-passenger /etc/apache2/sites-available/puppet-passenger
sudo mkdir -p /etc/puppet/rack/public
sudo cp /var/lib/gems/1.8/gems/puppet-`puppet --version`/ext/rack/files/ /etc/puppet/rack
sudo chown puppet /etc/puppet/rack/
sudo a2enmod ssl passenger
sudo a2ensite puppet-passenger
sudo service apache2 restart


#1 Updated by Ben Hughes about 5 years ago

  • Assignee set to Nick Fagerlund

#2 Updated by James Turnbull almost 5 years ago

  • Status changed from Unreviewed to Accepted

#3 Updated by Nigel Kersten over 2 years ago

Nick, can you check with eric0 and see whether he approves of just deleting this file?

It doesn’t feel appropriate in content or location.

#4 Updated by Nick Fagerlund over 2 years ago

  • Status changed from Accepted to Closed

Removing it. Pull request here ( Closing this bug.

#5 Updated by Justin Honold over 2 years ago

That document really tied the room together :)

Also available in: Atom PDF