====== Issues, Niggles and Workarounds ======

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.

===== Mongrel cluster not recognising --clean =====

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.

===== Windows - fails to load recipes =====

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

===== Brightbox gem fails to update =====

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.

===== Handling plugin side effects =====

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:

<code>task :environment, :roles => :app do
  run rake_task("environment")
end
before "gems:install", "environment"
</code>

to you ''config/deploy.rb'' as a workaround.