Requirements

Ruby 1.8 (1.9 not tested, JRuby will not work)

  • Download at: http://www.ruby-lang.org
  • Debian Packages: ruby1.8 ruby1.8-dev libopenssl-ruby

SQLite bindings for ruby

  • Download at: http://rubyforge.org/projects/sqlite-ruby/
  • Debian Packages: libsqlite3-ruby

SQLite

  • Download at: http://www.sqlite.org

Inotify bindings for ruby (Optional, linux only)

  • Download at: http://dinhe.net/~aredridel/projects/ruby/ruby-inotify.html
  • Debian Packages: libinotify-ruby

Essential C headers and compiler (Optional)

  • Debian Packages: build-essential

Note that RubyGEMs is tried to load on startup. I was told that if it is installed it will fetch and install dependencies automatically. It didn’t quite work for me, so you are propably better off installing them manuelly.

On Debian based systems this should do the job:
apt-get install ruby1.8-dev build-essential libopenssl-ruby libsqlite3-ruby

On Wndows you need:
Ruby from http://www.ruby-lang.org/de/downloads/
The 1.8.6 One-Click installer has been tested and seems to work.
SQLite from http://www.sqlite.org/sqlitedll-3_6_7.zip
Download and unpack into the BlocksDB directory
SQLite3-Ruby from http://rubyforge.org/frs/?group_id=254&release_id=25302
sqlite3-ruby-1.2.3-mswin32.gem has been tested and seems to work.
Open the command prompt cd to the download directory and run “gem install sqlite3-ruby-1.2.3-mswin32.gem” to install.

Preparing on Linux/MacOS:

  1. cd BlocksDB/fastxor
  2. ruby extconf.rb
  3. make
  4. cd ..

Preparing on Windows:

Sorry, i don’t really have a clue how to do that, here is a generic howto:
http://blogs.law.harvard.edu/hoanga/2006/12/14/getting-a-ruby-c-extension-to-compile-on-windows/

If you manage to get it to work, please mail me: da1l6@douwd.org

NOTE: The preparing step is optional, but performance will be much better is you make it.

Running

ruby Blocks.rb

Accessing

By default there is a command line interface and a web interface enabled.
You can access the web interface at http://127.0.0.1:8090

One command line interface is started with the application core, but you can use telnet or netcat to open more instances. Connect to 127.0.0.1:2323

A GUI is available and can be started using the Plugin Manager. Qt4 is required to make it work.