Document URL: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_JBoss_Web_Framework_Kit/2.3/html/TorqueBox_Quickstart_Guide/first-steps.html#first-steps-mac-linux Section Number and Name: Procedure 1.2. Your First Rails Application Describe the issue: When executing `gem install rails`, the Rails 4 is automatically installed now. Suggestions for improvement: I believe TorqueBox is meant to run with Rails 3, there should be description how to force to install Rails 3.
The recently released Rails 4 did break our quickstart guide, since Rails 4 and JRuby don't work together out of the box just yet. We should modify the `gem install rails` command to be `gem install rails -v "~> 3.2"` to force the latest Rails 3.2.x to be installed instead of picking up Rails 4.
I have tried the solution proposed in comment 1, it works. Many thanks Ben. This solution requires some additional modifications: Procedure 1.2. Your First Rails Application replace `gem install rails` by `gem install rails -v "~> 3.2"` replace lines: Successfully installed rails-3.2.8 27 gems installed by: Successfully installed rails-3.2.13 29 gems installed replace lines: Using rails (3.2.8) Installing sass (3.2.1) Installing sass-rails (3.2.5) Installing therubyrhino_jar (1.7.4) Installing therubyrhino (2.0.1) Installing uglifier (1.3.0) Your bundle is complete! Use `bundle show [gemname]` to see where a bundled gem is installed. by: Using rails (3.2.13) Installing sass (3.2.9) Installing sass-rails (3.2.6) Installing therubyrhino_jar (1.7.4) Installing therubyrhino (2.0.2) Installing uglifier (2.1.1) Your bundle is complete! Use `bundle show [gemname]` to see where a bundled gem is installed. Procedure 1.3. Subsequent Applications replace lines: Fetching: rack-1.4.1.gem (100%) Successfully installed rack-1.4.1 by: Fetching: rack-1.5.2.gem (100%) Successfully installed rack-1.5.2 Procedure 1.5. You First Rails Application - here the very similar modifications as for Procedure 1.2 have to be applied Procedure 1.6. Subsequent Applications - very similar modifications as for Procedure 1.3 have to be applied 2.1. TorqueBox Rails Template Example 2.1. Example Gemfile with the TorqueBox Gem - replace `gem 'rails', '3.2.8'` by `gem 'rails', '3.2.13'`
Fixed all version numbers throughout the guide. Docs stage URL: https://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_JBoss_Web_Framework_Kit/2.3/html-single/TorqueBox_Quickstart_Guide/index.html
Verified in WFK 2.3.0.CR2.