Rails3Tasks » History » Version 13

Chris Cannam, 2013-01-07 04:11 PM

1 1 Chris Cannam
h1. Moving to Rails 3
2 1 Chris Cannam
3 1 Chris Cannam
h2. Test environment
4 1 Chris Cannam
5 1 Chris Cannam
We have a Redmine 2.2 pristine branch (redmine-2.2) and an integration branch (redmine-2.2-integration) in which to fix errors arising from merging our own changes back in to Redmine 2.2.
6 1 Chris Cannam
7 1 Chris Cannam
For Rails 2, we have been using Ruby Enterprise Edition v1.8.7 with Phusion Passenger v3.0.1.
8 1 Chris Cannam
9 1 Chris Cannam
For Rails 3 we want to use a more mainstream Ruby v1.9.3, with Phusion Passenger v3.0.18.
10 2 Chris Cannam
11 2 Chris Cannam
Ubuntu 10.04 LTS only has Ruby 1.9.1, so we use the Brightbox packages.
12 2 Chris Cannam
13 2 Chris Cannam
<pre>
14 2 Chris Cannam
 $ sudo apt-add-repository ppa:brightbox/ruby-ng
15 2 Chris Cannam
 $ sudo apt-get update
16 2 Chris Cannam
 $ sudo apt-get install ruby1.9.3
17 2 Chris Cannam
 $ sudo gem1.9.3 install rails
18 2 Chris Cannam
 $ sudo gem1.9.3 install passenger
19 2 Chris Cannam
 $ sudo apt-get install libcurl4-openssl-dev
20 2 Chris Cannam
 $ sudo passenger-install-apache2-module 
21 2 Chris Cannam
</pre>
22 3 Chris Cannam
23 3 Chris Cannam
The Passenger installer prints out:
24 3 Chris Cannam
25 3 Chris Cannam
<pre>
26 3 Chris Cannam
Please edit your Apache configuration file, and add these lines:
27 3 Chris Cannam
28 3 Chris Cannam
   LoadModule passenger_module /var/lib/gems/1.9.1/gems/passenger-3.0.18/ext/apache2/mod_passenger.so
29 3 Chris Cannam
   PassengerRoot /var/lib/gems/1.9.1/gems/passenger-3.0.18
30 3 Chris Cannam
   PassengerRuby /usr/bin/ruby1.9.1
31 3 Chris Cannam
</pre>
32 3 Chris Cannam
33 3 Chris Cannam
(Note that the Brightbox PPA "Ruby 1.9.1" is in fact 1.9.3, unlike the Ubuntu repo package which is 1.9.1 -- confusing)
34 4 Chris Cannam
35 5 Chris Cannam
Although the different versions of Ruby and Rails can coexist, the Passenger Apache module can be loaded once per Apache instance only, so introducing the new version will supersede entirely the old one. The Rails version is specified in each application config, but they will all get the same Ruby version.
36 6 Chris Cannam
37 6 Chris Cannam
So, we make the above change (in @mods-available/passenger.load@) and the existing sites break with "Ruby on Rails version '2.3.14' not found" -- fair enough, it isn't installed for the new version of Ruby. Rather than fix this, let's keep the situation simpler to understand by blundering into the world of Rails 3 only.
38 7 Chris Cannam
39 8 Chris Cannam
I'm also going to remove /usr/local/bin (i.e. REE) from the PATH:
40 8 Chris Cannam
41 8 Chris Cannam
<pre>$ echo $PATH
42 8 Chris Cannam
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games
43 8 Chris Cannam
$ PATH=/usr/sbin:/usr/bin:/sbin:/bin:/usr/games
44 8 Chris Cannam
</pre>
45 8 Chris Cannam
46 12 Chris Cannam
(@/usr/games@ ??) Unfortunately we seem to have @bundle@ for Ruby 1.9 installed in /usr/local/bin, so
47 1 Chris Cannam
48 12 Chris Cannam
<pre>
49 12 Chris Cannam
$ sudo /usr/local/bin/bundle install
50 12 Chris Cannam
</pre>
51 12 Chris Cannam
52 11 Chris Cannam
Now, to the web instance and @hg pull -u; hg update redmine-2.2-integration@. Then
53 11 Chris Cannam
54 11 Chris Cannam
<pre>
55 11 Chris Cannam
$ RAILS_ENV=development rake1.9.3 db:migrate
56 10 Chris Cannam
</pre>
57 13 Chris Cannam
58 13 Chris Cannam
And now we're into application incompatibility territory:
59 13 Chris Cannam
60 13 Chris Cannam
<pre>
61 13 Chris Cannam
DEPRECATION WARNING: You have Rails 2.3-style plugins in vendor/plugins! Support for these plugins will be removed in Rails 4.0. Move them out and bundle them in your Gemfile, or fold them in to your app as lib/myplugin/* and config/initializers/myplugin.rb. See the release notes for more on this: http://weblog.rubyonrails.org/2012/1/4/rails-3-2-0-rc2-has-been-released. (called from <top (required)> at /var/www/test-cannam/Rakefile:7)
62 13 Chris Cannam
Plugins in vendor/plugins (/var/www/test-cannam/vendor/plugins) are no longer allowed. Please, put your Redmine plugins in the `plugins` directory at the root of your Redmine directory (/var/www/test-cannam/plugins)
63 13 Chris Cannam
</pre>