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
- Make sure your project satisfies the system requirement for Rails LTS. This involves upgrading to Rails 2.3.18.
Installation
-
Remove all existing version of Rails gems:
gem uninstall rails activeresource actionmailer actionpack activerecord activesupport
-
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
andpassword
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 thepkg/
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
-
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
-
Decide whether to enable optional security enhancements shipped with Rails LTS.
-
You may want to briefly confirm that you are running the latest version.
-
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