wiki:DevelopmentEnvironmentWindows
Last modified 9 days ago Last modified on 05/15/12 08:10:22

ProjectTraXX Development Environment - Windows

Ruby

1.8.6 DO NOT USE THIS VERSION ANY MORE!

Use ruby 1.8.6 (2008-08-11 patchlevel 287) [i386-mswin32].

1.8.7

Use ruby 1.8.7 (2008-08-11 patchlevel 72) [i386-mswin32].

You might need to download seperate DLLs and copy them to your ruby/bin folder:

DevKit?

Install the DevKit? for ruby on rails.

Gem

Use gem version 1.3.6.

Install gem as well - you get it from the same page.

Rails & other Gems

Use Rails 2.3.5.

Install via command line with "gem install rails --include-dependencies".

  • 'gem install rake' for all kinds of support
  • 'gem install capistrano' for automatic deployment
  • 'gem install mysql' for mysql
  • 'gem install git-rails' for GIT support
  • 'gem install calendar_date_select' for calendar_date_select-1.16.1
  • 'gem install tlsmail' for SSL enabled ActionMailer?
  • 'gem install fastercsv' for faster_csv
  • 'gem install nokogiri' for XML parsing and processing
  • 'gem install shoulda' for shoulda - a framework for unit-tests
  • 'gem install will_paginate -v=2.3.16' for Will paginate - a Gem for pagination of listings (more about :​http://wiki.github.com/mislav/will_paginate/)

Rails Plugins

  • Active Merchant
  • Auto Complete
  • in place editing
  • open flash chart
  • flotomatic

Database

Use MySQL 5.1.3 Community Edition

You can download at ​http://dev.mysql.com/downloads/mysql/.

Please include all prerequisites such as the C++ redistributables. You find the corresponding link on the MySQL homepage.

FYI: Newer Versions had issues with MySQL drivers for RoR.

IDE

Currently Aptana Studio, build: 1.2.7.024747 is in use.

Together with RadRails? 1.2.0.23147-7H7g7K7oz0w9A08G8O8N8vz-1D96 and Ruby Development Tools 1.2.

Newer Version should work fine but havn't been used so far.

You need to install plugins for the IDE to support Ruby on Rails as well as Subversion:

  • Subversion Client
  • Ruby on Rails / RadRails? - Included in Version 3 of the Aptana Studio

Connect to Subversion

Use the following URL to connect to our subversion repository: ​https://svn2.hosted-projects.com/projecttraxx/projecttraxx.

Facilitate your user and your password (you received it by mail).

Initialize Database

run the command "rake db:migrate:reset" to initialize your database with the default set of data.

SVN Client

Install a SVN client. The SVC Client is necessary to run the automatic deployment scripts. You get a good client at the following site:

Putty

You will need a putty client to be able to connect to the Projecttraxx Production Server or any other machine.

Get Putty from the following URL:

Troubleshooting

Find below a couple of hints that made the installation process easier of fixed bugs in the configuration that we encountered so far.

Gems

If you have trouble to install all the required gems:

Comment out the libraries which do not install quickly as a workaround. E.g.: require 'libxml' from projects_controller.rb and project.rb

Plugins

if you get the error with plugin installation: .../reporting.rb:38:in `reopen': No such file or directory - /dev/null (Errno::ENOENT)

open the file in a text edit and find the line 38, Comment out the line:

#stream.reopen(RUBY_PLATFORM =~ /mswin/ ? 'NUL:' : '/dev/null')

and set next to a new line:

STDOUT.reopen('NUL:')

more about the similar error: ​http://blog.brzezinka.eu/

MySQL

If you have trouble with mySQL:

Download the libmySQL.dll from ​http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll and save it into your ruby/bin directory.

Mails

If you habe trouble with sending mails:

If you get the error "ERROR ArgumentError?: wrong number of arguments (3 for 2) / FILE config/initializers/smtp_tls.rb, line 8" when trying to send mails:

  • open the file config/initializers/smtp_tls.rb
  • comment out line 8: "#check_auth_args user, secret, authtype if user or secret "
  • add the following line instead: "check_auth_args user, secret"

Check out this site for detailed instructions: ​http://forums.site5.com/showthread.php?t=26335