http://wiki.brightbox.co.uk/ 2008-07-04T17:33:50+01:00 http://wiki.brightbox.co.uk/ http://wiki.brightbox.co.uk/lib/images/favicon.ico text/html 2008-06-23T10:05:47+01:00 Neil Wilson http://wiki.brightbox.co.uk/docs:gemv2:start?rev=1214211947&do=diff The Brightbox Gem is a set of extensions to the Capistrano deploy recipes that makes it very easy indeed to deploy a Rails application onto a Brightbox. If you've not used the gem before try out Quick Start Guide * Installing the Gem * Using Repositories * Domains and Domain Aliases * Local Shared Areas * Sharing database.yml between releases * Adding SSL support * How to do staging * Deployment Essentials * Issues and Niggles * Monit Default Limits * Updating your confi… text/html 2008-06-20T16:52:55+01:00 Neil Wilson http://wiki.brightbox.co.uk/docs:howtosetupfiveruns?rev=1213977175&do=diff To set up Fiveruns Manage on your Brightbox, do the following: sudo wget http://manage.fiveruns.com/system/downloads/client/manage-installer-linux-ubuntu-32bit-intel.sh sudo sh manage-installer-linux-ubuntu-32bit-intel.sh It asks for a location - just hit enter to leave this as the default. text/html 2008-06-18T11:02:29+01:00 Neil Wilson http://wiki.brightbox.co.uk/docs:faq?rev=1213783349&do=diff How do I get my Rails app onto my Brightbox? There are a number of ways, the easiest is to use our Brightbox Capistrano recipes. How do I get root access on my Brightbox? Login over SSH as the rails user and run commands using the sudo tool, which asks for your rails user password and then runs the command as root: text/html 2008-06-18T10:18:15+01:00 Neil Wilson http://wiki.brightbox.co.uk/docs:gemv2:niggles?rev=1213780695&do=diff 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. text/html 2008-06-17T16:11:00+01:00 Neil Wilson http://wiki.brightbox.co.uk/docs:gemv2:share_database_yml?rev=1213715460&do=diff One of the great benefits of our Local Shared Area is that you can get the database.yml file out of your version control system but still have everything work as planned. Adjust the deploy.rb config Make sure you have adjusted your local area config to include the database.yml file: text/html 2008-06-17T15:25:11+01:00 Neil Wilson http://wiki.brightbox.co.uk/docs:gemv2:staging?rev=1213712711&do=diff This is a way of creating and using a staging environment to check out a production version of an application before you update the 'live' environment. We've found it a useful approach in our own work and we hope you do too. Essentially we deploy two production copies of an application. One called myapp_staging and one called myapp_production - linked to appropriate branches created in the version control system. text/html 2008-06-16T17:02:37+01:00 Neil Wilson http://wiki.brightbox.co.uk/docs:gemv2:ssl?rev=1213632157&do=diff You can tell the Brightbox gem to setup an SSL configuration for your application in Apache, by giving it the name of an installed SSL certificate. Adding the certificate The simplest way is to set the ssl_certificate variable, e.g: set :ssl_certificate, "brightbox" text/html 2008-06-16T12:41:44+01:00 Neil Wilson http://wiki.brightbox.co.uk/docs:gemv2:monitlimits?rev=1213616504&do=diff The gem creates a default monit configuration for your application that tries to keep it within sensible limits. You can edit these limits if you find your application breaches them regularly within normal operation. * restart if the mongrel memory usage exceeds 110Mb for 3 checks. * restart if the mongrel cpu usage exceeds 80% for 5 checks. * unmonitor application if constantly restarting. * restart if the application fails to respond to within 30 seconds. text/html 2008-06-13T17:19:51+01:00 Neil Wilson http://wiki.brightbox.co.uk/docs:gemv2:capistrano?rev=1213373991&do=diff Below is a guide to the standard Capistrano tasks as augmented by the Brightbox gem. deploy deploy is the standard task for running a deployment. This: * creates a new release * creates symbolic links to the shared directories and files * updates the application gems (if configured) * moves the current symbolic link to the new release. * cleans up old releases * restarts the mongrels to pick up the new release. * ensures that the mongrels are being watched by monit. * restar…