UPGRADING.rdoc

Path: UPGRADING.rdoc
Last Update: Mon Aug 22 22:48:30 +0000 2011

How to upgrade/downgrade Rubygems:

For RubyGems 1.5.0 and 1.5.1:

RubyGems 1.5.0 and 1.5.1 shipped with a broken gem update —system. You will need to use the Manual Upgrade Recipe below.

On Ruby 1.9.x:

From stock ruby shipping with 1.9:

Use the Normal Upgrade Method below. (finally!)

On Ruby 1.8.x:

From rubygems 1.3.x:

Use the Normal Upgrade Recipe below.

From rubygems 1-1.x through 1.2.x:

RubyGems 1.1 and 1.2 have problems upgrading when there is no rubygems-update installed. You will need to use the following instructions if you see "Nothing to update".

Use the Manual Upgrade Recipe below.

From rubygems < 1.1.x:

Use the Normal Upgrade Recipe below.

Downgrade Recipe

Normal Downgrade

With rubygems 1.5.2 and higher:

    $ gem update --system 1.3.7

With rubygems 1.5.1 and lower:

Use sudo/su as appropriate:

    $ gem install rubygems-update -v 1.3.7
    $ update_rubygems _1.3.7_

Replace 1.3.7 with whatever version you want to downgrade to. This recipe can also be used to upgrade to a specific version instead of the latest.

Do make sure that you don‘t have any other versions of rubygems-update installed when you run the second command.

1.9.2 Downgrade from Rubygems 1.4.x+ to stock 1.9 rubygems:

Use sudo/su as appropriate:

    $ ruby --disable-gems -S gem which rubygems
    ~/.rvm/rubies/ruby-1.9.2-p136/lib/ruby/site_ruby/1.9.1/rubygems.rb
    $ rm ~/.rvm/rubies/ruby-1.9.2-p136/lib/ruby/site_ruby/1.9.1/rubygems.rb
    $ rm -rf ~/.rvm/rubies/ruby-1.9.2-p136/lib/ruby/site_ruby/1.9.1/rubygems
    $ gem -v
    1.3.7

Upgrade Recipes

Normal Upgrade

Use sudo/su as appropriate:

    $ gem update --system

Manual Upgrade

If you have an older version of RubyGems installed, then you can still do it in two steps:

Use sudo/su as appropriate:

    $ gem install rubygems-update
    $ update_rubygems

Manual Install

If you don‘t have any RubyGems install, there is still the pre-gem approach to getting software, doing it manually:

Use sudo/su as appropriate:

[Validate]