====== Ruby Enterprise Edition Packages ======

We're providing 32bit Ruby EE packages for Ubuntu Lucid and Hardy.  The packages include the copy on write memory improvements developed by the team at Phusion, plus some general performance improvements over the default Ubuntu packages that can increase the speed of basic built-in Ruby methods by a great deal.

The packages upgrade (i.e replace) the standard 1.8 Ruby installation, which might not be acceptable for everyone.  This means all your gems stay the same, and everything on your system immediately starts using them.

The packages are available on the [[docs:brightboxaptrepository]] for the Lucid and Hardy distributions under the component "rubyee".

<note tip>Ruby Enterprise Edition has been installed by default on all new Brightboxes since early 2009.  If you're on an older Hardy Brightbox, or on a 3rd party Ubuntu Hardy box, just follow these instructions to install the packages manually</note>

Install our key:

<code bash>
wget http://apt.brightbox.net/release.asc -O - | sudo apt-key add -
</code>

and add the following line to the file ''/etc/apt/sources.list.d/brightbox-rubyee.list''

<code>
deb http://apt.brightbox.net/ hardy rubyee
</code>

then make sure you re-update your apt cache with the new source:

<code bash>
sudo apt-get update
</code>

You should be able to get this working with just one package upgrade (which pulls in some dependencies):

<code bash>
sudo apt-get install libruby1.8
</code>

Or just do an normal ''sudo apt-get upgrade''.

If you're using [[docs:phusion-passenger|Passenger]] just restart Apache and you're all COWed up!

===== Reverting back to standard Ubuntu Ruby =====

If you want to revert back to the normal packages, add the following lines to the file ''/etc/apt/preferences''

<code>
Package: libopenssl-ruby1.8 libreadline-ruby1.8 libruby1.8 ruby1.8 ruby1.8-dev irb1.8 rdoc1.8 ri1.8
Pin: release l=Ubuntu
Pin-Priority: 600
</code>

And either run another ''sudo apt-get upgrade'' or explicitly downgrade the ruby packages like this:

<code bash>
apt-get install irb1.8 libopenssl-ruby1.8 libreadline-ruby1.8 libruby1.8 rdoc1.8 ri1.8 ruby1.8
</code>