103 Installing Rails 2.3 LTS without Bundler

Updated . Posted . Visible to the public.

This document describes install Rails 2.3 LTS when you are not using Bundler Show archive.org snapshot and you do not want to upgrade to Bundler Show archive.org snapshot .

If your project does use Bundler, please see our instructions on installing Rails 2.3 LTS with Bundler instead.

Prerequisites

  1. Make sure your project satisfies the system requirement for Rails LTS. This involves upgrading to Rails 2.3.18.

Installation

  1. Remove all existing version of Rails gems:

    gem uninstall rails activeresource actionmailer actionpack activerecord activesupport
    
  2. Install the latest Rails 2.3 LTS gems.

    As a customer of a paid plan (Startup, Standard, Enterprise), run the following:

    gem install rails --version "~> 2.3.18" --source "https://user:password@gems.railslts.com" --no-ri --no-rdoc
    

    Replace username and password with your personal credentials that you received after subscribing to Rails LTS.
    Make sure a colon (:) separates username and password.

    As a subscriber to the free Community edition, you need to build the Rails LTS gems before installing:

    git clone -b 2-3-lts https://github.com/makandra/rails.git rails-2-3-lts
    cd rails-2-3-lts
    bundle install
    rake railslts:gems:build
    

    This will build put some .gem files into the pkg/ directory, which you can now install:

    gem install --no-ri --no-rdoc pkg/activesupport-2.3.*.gem
    gem install --no-ri --no-rdoc pkg/activerecord-2.3.*.gem
    gem install --no-ri --no-rdoc pkg/actionpack-2.3.*.gem
    gem install --no-ri --no-rdoc pkg/actionmailer-2.3.*.gem
    gem install --no-ri --no-rdoc pkg/activeresource-2.3.*.gem
    gem install --no-ri --no-rdoc pkg/railties-2.3.*.gem
    gem install --no-ri --no-rdoc pkg/rails-2.3.*.gem
    
  3. Open config/environment.rb within your project directory and look for the following line:

    RAILS_GEM_VERSION = '2.3.xx' unless defined? RAILS_GEM_VERSION
    

    Now change that line so it refers to the latest Rails 2.3 LTS version from the Changelog. Note that a Rails LTS version numbers has three dots instead of two:

    RAILS_GEM_VERSION = '2.3.xx.yy' unless defined? RAILS_GEM_VERSION
    
  4. Decide whether to enable optional security enhancements shipped with Rails LTS.

  5. You may want to briefly confirm that you are running the latest version.

  6. Follow your normal release process (run tests, push, deploy to staging, do smoke testing, deploy to production).

Congratulations! You successfully deployed your application using Rails LTS. If you have chosen to subscribe to the Rails LTS Notification List when signing up, you will be notified whenever a new patch for Rails LTS becomes available.

Breaking changes

  • By default, Rails LTS does not allow for strings to be used in polymorphic path helpers, e.g. url_for(['edit', @user]) is not allowed. Symbols are fine. You can opt out of this change
  • Mimicking Rails 5, Rails 2.3 LTS will try to use YAML.safe_load to deserialize certain database column. See details
Henning Koch
Last edit
Tobias Kraze
License
Source code in this card is licensed under the MIT License.
Posted by Henning Koch to Rails LTS documentation (2013-05-30 22:57)