blocksnet Code
Brought to you by:
da1l6
Menu
▾
▴
Tree [a5c110] master / History
Fireball
Read Me
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + BIG FAT WARNING + Don't use sqlite3 ruby bindings (sqlite-ruby) versions 1.3.x!! + +++++++++++++++++++ They completely break BlocksNet. Cause is currently under investigation. + + Use sqlite-ruby Version 1.2.4 !!! + ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ########################## # Installation on Linux: # ########################## # Requirements: # Package | Download at: ------------------------------------------------+------------------------------------------------------------- Ruby (1.9.1 recommended, at least 1.8.7) | http://www.ruby-lang.org Ruby development headers | " (should be included in ofical ruby package) OpenSSL bindings for ruby | " (should be included in ofical ruby package) SQLite bindings for ruby | http://rubyforge.org/projects/sqlite-ruby/ Inotify bindings for ruby (optional, Linux only)| http://dinhe.net/~aredridel/projects/ruby/ruby-inotify.html FUSE bindings for ruby (optional, Linux only?) | http://rubyforge.org/projects/fusefs/ Essential C headers and compiler (optional) | Note 1: Your distribution propably has all of this already packaged for you. It is recommended just to use your package manager to install it. Note 2: 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 manually. Note 3: The recommended ruby version is 1.9.1. There is compatibility code for ruby 1.8.7 in there so this should also work. 1.8.6 will NOT work. Note 4: Many distros split ruby packages more or less. Be sure you install development headers (those -dev or -devel packages) and openssl support if packaged seperately. Note 5: Some distro (specifically Ubuntu Karmic) have multiple ruby versions in their repositories, don't mix packages that belong to different ruby versions. Install the newest version if possible. # Actual Installation: # 1. ./configure (Check output for errors or warnings.) 2. make 3. make install (as root) You can now run BlocksNet from your desktop environment (KDE, Gnome, whatever) Menu or by entering "blocksnet" into a terminal. ####################################### # Installation on MacOS/Other Unixes: # ####################################### Should be similar to the Linux installation, except that there is no package manager on MacOS, is there? I have never tried this. So if you have a Mac and want to help, contact me at: da1l6@douwd.org ############################ # Installation on Windows: # ############################ The easiest way is to grab and unpack the Win32AllInOne archive from SourceForge. If you read this you may already have it. Just double click the blocksnet.bat file and there you go. If you get DLL errors, these are propably caused by a conflicting OpenSSL version. The packaged ruby interpreter is build against 0.9.8. This OpenSSL version is shiped with the package, but Windows seems to ignore that when another version is already installed in the system. As a work around, install the right OpenSSL version manuelly: http://www.slproweb.com/download/Win32OpenSSL_Light-0_9_8n.exe OpenSSL also depends on the MS Visual C++ Runtime which can't be shiped with this package for legal reasons (yes it sucks, blame MS). If your system does not come with it, download and install: http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF Note: FastXOR acceleration does not work out of the box. If you want it, you need to compile it manually in src/fastxor. You need mingw (specifically gcc and make) to compile it. Open a Terminal, go to src\fastxor and run: ..\..\ruby\bin\ruby.exe extconf.rb make I never got mingw make to work, if you manage mail me! da1l6@douwd.org
