diff --git a/Linux-debian.textile b/Linux-debian.textile new file mode 100644 index 0000000..c12f623 --- /dev/null +++ b/Linux-debian.textile @@ -0,0 +1,102 @@ +h1. Linux Debian + +h2. General Debian GNU/Linux installation + +A detailed howto written by c00i90wn can be found at c00i90wn's homepage "here":http://www.cooldown.com.ar/2006/12/16/install-tracks-on-ubuntu-or-debian/ there explains how to install it on Debian or Ubuntu. + +(These instructions were written by Thomas Themel) + +Installing tracks on Debian is a bit more complicated than it should be, mainly because Debian splits ruby into a multitude of packages, while authors of ruby packages seemingly tend to assume that they are all installed. + +Installing Tracks requires Ruby on Rails, which in turn requires RubyGems. + +To install RubyGems, you need to install the following Debian packages: + +* ruby1.8 +* libzlib-ruby +* libyaml-ruby + +When these and their dependencies are set up, it should be possible to install !RubyGems: + + +sokrates:/home/themel/ruby/rubygems-0.8.4# ruby setup.rb all +---> bin +[...] + Successfully built RubyGem + Name: sources + Version: 0.0.1 + File: sources-0.0.1.gem +sokrates:/home/themel/ruby/rubygems-0.8.4# + + +For installation of the rails GEM, more Debian packages are required: + +* libdrb-ruby +* liberb-ruby +* rdoc + +RubyGems can then install Ruby on Rails: + + +sokrates:/home/themel/ruby/rubygems-0.8.4# gem install rails +Attempting local installation of 'rails' +Local gem file not found: rails*.gem +Attempting remote installation of 'rails' +Updating Gem source index for: http://gems.rubyforge.org +Install required dependency rake? [Yn] y +Install required dependency activerecord? [Yn] +Install required dependency actionpack? [Yn] +Install required dependency actionmailer? [Yn] +Successfully installed rails, version 0.9.5 +Installing RDoc documentation for rails-0.9.5... +WARNING: Generating RDoc on .gem that may not have RDoc. + +lib/rails_generator.rb:34:46: Skipping require of dynamic string: "#{path}/#{name}_generator.rb" +Installing RDoc documentation for rake-0.4.15... +Installing RDoc documentation for activerecord-1.6.0... +Installing RDoc documentation for actionpack-1.4.0... + +lib/action_controller/scaffolding.rb:87:37: Skipping require of dynamic string: "#{model_id.id2name}" +Installing RDoc documentation for actionmailer-0.6.1... +sokrates:/home/themel/ruby/rubygems-0.8.4# + + +To run tracks, we need another Debian package: + +* libwebrick-ruby + +The final issue that I ran into is that the ruby MySQL client seems to expect the MySQL server socket in its default location in /tmp when the specified database host is localhost. Debian doesn't place the server socket in /tmp/mysql.socket, but rather in /var/run/mysqld/mysqld.socket. This causes the error + + +No such file or directory - /tmp/mysql.sock + + +when starting tracks. To fix this, add a socket line to the appropriate environments in your config/database.yml: + + +development: + adapter: mysql + database: tracks + host: localhost + username: root + password: + socket: /var/run/mysqld/mysqld.sock + + +Happy GTDing! + +Thomas Themel + +Radagast has also had some success with Debian and Tracks, and posts detailed instructions "here":http://rhosgobel.blogspot.com/2005/09/installing-tracks-on-debian.html. + +h2. Ubuntu Dapper Drake + +There are some very clear and straightforward instructions for "Ubuntu Dapper Drake here":http://www.rubyrailways.com/getting-ruby-on-rails-up-and-running-on-ubuntu-dapper/. + +h2. Ubuntu 6.10 (Edgy Eft) Installation + +Here are some [url=https://help.ubuntu.com/community/RubyOnRails]clear instructions[/url] for getting rails and Edgy to play well together. + +h2. Debian Subdirectory Installation + +Install notes for Debian Lenny, including specific details and patches required for installing in a subdirectory "here":http://bitcube.co.uk/content/getting-things-done-tracks \ No newline at end of file