Today when I started my Ruby on Rails application I received this error.
> ruby script/server
ruby: no such file to load -- ubygems (LoadError)
After Googling for this error message I realized somehow my Ruby gems installation was corrupted. I had been planning on upgrading my Ruby from 1.85 to 1.86-26 so now seemed as a good time as ever. 🙂
Fortunately after installing the latest version of Ruby and updating to Ruby on Rails 1.2.6 everything seemed fine.
A few years ago I ran a basketball tournament to raise funds for North Korean refugee orphans. The tournament was a big success and I enjoyed creating the site for it using Ruby on Rails. On the site people could register their team, update it, pay their registration fee and donate.
The site is Hoops For Orphans.
I created a simple demonstration Ruby on Rails store for my church, Highrock Church, called the Highrock Store.
The implementation relied heavily on the wonderful book Agile Web Development with Rails, 2nd Edition.
Today I upgraded to Rails 1.2.6 as I prepare to move towards Rails 2.0. Notes on this release can be found here.
Here are the steps I took.
- Upgrade Ruby Gems to the latest version (in this case 1.0.1).
gem update --system
- Upgrade Ruby on Rails to the latest version (in this case 2.0.2).
gem install rails
To specify upgrading to Ruby on Rails 1.2.6 do this.
gem install rails -v 1.2.6
(What I probably should have done was a gem update because now I have installed 1.2.6 and 1.2.3.)
- Update configuration.
set RAILS_GEM_VERSION to â€˜1.2.6â€™ in config/environment.rb
If some of your Ruby on Rails tests are failing with method not found errors, it could be because Ruby cannot find the class that has this method. For example the methods might be in some of the mock classes. To fix this I did.
$ ruby -Itest/mocks/test test/functional/user_controller_test.rb
The following link is to an excellent post about Ruby symbols, especially important considering Ruby on Rails uses symbols all the time.
Understanding Ruby Symbols
On Tuesday, November 15, 2005 I will be presenting an introduction to Ruby on Rails to the ACM Greater Boston Web Tech Chapter.
- install Ruby using the one click installer
Note that 1.8.2-15 has a small problem, the Ruby Gems Package Manager shortcut does not work because it is pointing to ruby\bin\gemhelp.cmd which does not exist. To use the Ruby Gems Package Manager open a cmd window and then enter the gems command. Or you can create the gemhelp.cmd file which has only one line in it, cmd /k gem or download it from here.
Ruby on Rails
(see also Getting Started With Rails)
- install rails gem (and all its dependencies)
gem install rails --remote
- when doing an upgrade I sometimes had to force it by doing an install of the version I wanted to upgrade to
gem install --remote --version '0.13.1' rails
Salted Hash Login & Authentication Generator
(see also Salted Login Generator Quick Start)
- install salted login generator gem
gem install --remote salted_login_generator
- install localization gem
gem install --remote localization_generator
- Iconv is a library used for charset conversion and required by the Salted Hash Login Generator. Download this iconv package with simple installation instructions, unzip the package, and run the installer.
Setup has detected Ruby at c:\devel\ruby
and Windows/System32 at C:\WINDOWS/System32
Install Iconv there? [yN] y
cp iconv.so c:\devel\ruby/lib/ruby/1.8/i386-mswin32
cp iconv.dll C:\WINDOWS/System32
cp charset.dll C:\WINDOWS/System32
Update, the above iconv package link no longer works. Instead you have to follow the more laborious task of getting
iconv.so and installing it in
ruby\lib\ruby\1.8\i386-mswin32 and getting
iconv.dll and installing it in
C:\WINDOWS\System32. More detailed instructions can be found on the iconv in Ruby on Rails page.
(see also RMagick Install FAQ)
- download latest RMagick Windows gem ZIP archive from http://rubyforge.org/projects/rmagick/
- unzip Windows gem archive
- go into unzipped directory and do a local gem install
C:\tmp\RMagick-1.9.1-IM-6.2.3-win32>gem install RMagick-win32-1.9.2-mswin32.gem
- run post installer
RMagick 1.9.2 win32 Post Installation (see enclosed README for license information)
detecting available fonts, writing to config/type-windows.xml...ok.
setting MAGICK_CONFIGURE_PATH to 'c:/devel/ruby/lib/ruby/gems/1.8/gems/RMagick-win32-1.9.2-mswin32/config'.
setting is only for current user.
Copying 5 dlls to c:/devel/ruby/bin...done.
- install MySQL 4.1 (use the Windows Essential installer)
- create tables, for example
mysql -u fkim -p < zipcodes.sql
Excellent web based MySQL administration tool.
- download phpMyAdmin package
- unzip package and configure Apache to locate that package
- I use phpMyAdmin for administration tasks such as creating users and database