This page is for issues, niggles and problems with the Gem and supporting infrastructure. If you've come across something and think others might benefit please add to this page.
There have been instances where mongrel refuses to pick up the latest version of the mongrel cluster plugin. What you get is an error stating that –clean is an invalid option.
The workaround is to remove all but the latest version of the mongrel_cluster gem.
There is a known bug in Capistrano 2.3.0 that prevents it from loading the Brightbox recipes properly. This has been fixed in version 2.4
There has been an instance of the Brightbox gem failing to update on MacOS. The workaround is to uninstall all versions of the Brightbox gem and then reinstall the latest version.
The gem tries to be helpful and installs any specified gems in your application using the new Rails 2.1 gem:install rake task. This task is run as root. Unfortunately that task initialises the Rails environment and fires any side effects in plugins. This can create files and directories that are then inaccessible by the default rails user.
If you run into this problem add:
task :environment, :roles => :app do
run rake_task("environment")
end
before "gems:install", "environment"
to you config/deploy.rb as a workaround.