Learning Ruby on Rails

Once the installation has completed, we need to tell RVM which version of Ruby we currently want to use: rvm use 1.9.2. Next, test it by checking the version number: ruby -v. On my computer, this returns ruby 1.9.2p290 (2011-07-09 revision 32553) x8664-darwin11.1.0. Good job, you're now using Ruby 1.9.2. There's just one last thing to deal with. Let's look at the installation instructions for Rails' Framework on Windows, Mac OS X, and Linux. Rails Installation on Windows. First, let's check to see if you already have Ruby installed. Bring up a command prompt and type C: ruby -v. If Ruby responds, and if it shows a version number at or above 1.8.6, then type C: gem -version.

Advanced Ruby on Rails 2.1

Advanced Ruby on Rails 2.1

Quick Reference Guide

Ruby on Rails 2.1 Useful Resources

Selected Reading

To develop a web application using Ruby on Rails Framework, you would need to install the following software −

Ruby
The Rails framework
A Web Server
A Database System

We assume that you already have installed a Web Server and Database System on your computer. You can always use the WEBrick Web Server, which comes with standard installation of Ruby. Most sites, however, use Apache or lightTPD in production.

Rails works with many database systems, including MySQL, PostgreSQL, SQLite, Oracle, DB2 and SQL Server. Please refer to a corresponding Database System Setup manual to setup your database.

Let's look at the installation instructions for Rails' Framework on Windows, Mac OS X, and Linux.

Rails Installation on Windows

First, let's check to see if you already have Ruby installed. Bring up a command prompt and type C:> ruby -v. If Ruby responds, and if it shows a version number at or above 1.8.6, then type C:> gem --version. If you don't get an error, skip to step 3. Otherwise, we'll do a fresh installation for Ruby.

If Ruby is not installed, then download an installation package from rubyinstaller.rubyforge.org.Follow the download link, and run the resulting installer. This is an exe like ruby186-25.exe and will be installed in a single click. You may as well install everything. It's a very small package, and you'll get RubyGems as well along with this package.
With RubyGems loaded, you can install all of Rails and its dependencies through the command line −

The above command may take some time to install all dependencies. Make sure you are connected to the internet while installing gems dependencies.

Congratulations! You are now on Rails over Windows.

NOTE − In case you face any problem with the above installation, there are chances that you may not have the latest versions of Ruby or other Gems. So just issue the following command and you will have everything updated automatically.

Then try above command with updated gems.

Rails Installation on Mac OS X

First, let's check to see if you already have Ruby installed. Bring up a command prompt and type $ ruby -v. If Ruby responds, and if it shows a version number at or above 1.8.6 then skip to step 3. Otherwise, we'll do a fresh installation for Ruby. To install a fresh copy of Ruby, the Unix instructions that follow should help.
Next, you have to install RubyGems. Go to rubygems.rubyforge.org and follow the download link. OS X will typically unpack the archive file for you, so all you have to do is navigate to the downloaded directory and (in the Terminal application) type the following −

Now, use RubyGems to install Rails. Issue the following command.

The above command may take some time to install all dependencies. Make sure you are connected to the internet while installing gems dependencies.

Congratulations! You are now on Rails over Mac OS X.

NOTE − In case you face any problem with above installation, there are chances that you may not have the latest versions of Ruby or other Gems. So just issue the following command and you will have everything updated automatically.

Then try the above command with updated gems.

Rails Installation on Linux

First, let's check to see if you already have Ruby installed. Bring up a command prompt and type $ ruby -v. If Ruby responds, and if it shows a version number at or above 1.8.6, then skip to step 5. Otherwise, we'll do a fresh installation for Ruby.
Download ruby-x.y.z.tar.gz from www.ruby-lang.org
Untar the distribution, and enter the top-level directory.
Do the usual open-source build as follows −

Install RubyGems. Go to rubygems.rubyforge.org, and follow the download link. Once you have the file locally, enter the following at your command prompt −

Now use RubyGems to install Rails. Still in the shell, issue the following command.

The above command may take some time to install all dependencies. Make sure you are connected to the internet while installing gems dependencies.

Congratulations! You are now on Rails over Linux.

NOTE − In case you face any problem with above installation, there are chances that you may not have the latest versions of Ruby or other Gems. So, just issue the following command and you will have everything updated automatically.

Then try the above command with updated gems.

Ruby Rails For Mac

Keeping Rails Up-to-Date

Assuming you have installed Rails using RubyGems, keeping it up-to-date is relatively easy. Issue the following command −

This will automatically update your Rails installation. The next time you restart your application, it will pick up this latest version of Rails. While giving this command, make sure you are connected to the internet.

Download Ruby On Rails

Installation Verification

You can verify if everything is setup according to your requirements or not. Use the following command to create a demo project in Rails environment.

This will create a demo rails' project using SQLite database. Note that Rails uses SQLite as its default database.

We can create an application that will use MySQL database. Assuming you have MySQL database setup on your machine, issue the following command to create an application that will use MySQL database −

We will discuss the database setup part in subsequent chapters. Currently we have to check if our environment is setup properly or not. Use the following commands to run WEBrick web server on your machine −

Now open your browser and type the following address text box.

You should receive a message like 'Welcome aboard' or 'Congratulations'.

How to Upgrade?

Ruby On Rails Windows

If you are already running an old version of Rails, then here is the procedure to upgrade it to the latest version 2.1 −

If you want to move your application to Rails 2.0, you should first move it to Rails 1.2.6.
If your application runs fine on 1.2.6 with no deprecation warnings, there's a good chance that it'll run straight up on 2.0.
To complete the upgrade, you would have to upgrade your extractions. If you are using pagination, you will need to install the classic_pagination plugin. If you are using Oracle, you will need to install the activerecordoracle-adapter gem.