Install and setup
- download and install ruby
- get SQLite3
- download the required ruby gems
- download, configure and launch dradis
download and install ruby
In order to use dradis, you will need to download and
install the ruby language interpreter
for your platform.
Use the package management system of your ditribution:
apt-get install ruby irb rdoc ruby1.8-dev
You will also need some extra packages and tools:
- Rake: the ruby build program with capabilities similar to GNU Make.
- RubyGems, the ruby packaging system.
Again you can do this by downloading and compiling from source, or using your package system:
apt-get install rake rubygems
get SQLite3
SQLite3 is a lightweight database engine. It stores the entire contents of a database in a single file, thus it is very convenient for us.
The only thing you need to do is to download the SQLite3 libraries:
apt-get install libsqlite3-0 libsqlite3-dev
download the required ruby gems
Because ruby is an interpreted language, it needs bindings to link to some native libraries (you may need to become root for this):-
sqlite3-ruby gem# gem install sqlite3-ruby
Bulk updating Gem source index for: http://gems.rubyforge.org
Select which gem to install for your platform (i486-linux)
1. sqlite3-ruby 1.2.1 (mswin32)
2. sqlite3-ruby 1.2.1 (ruby)
3. sqlite3-ruby 1.2.0 (mswin32)
4. sqlite3-ruby 1.2.0 (ruby)
5. sqlite3-ruby 1.1.0 (mswin32)
6. sqlite3-ruby 1.1.0 (ruby)
7. sqlite3-ruby 1.0.1 (ruby)
8. sqlite3-ruby 1.0.1 (mswin32)
9. sqlite3-ruby 1.0.0 (mswin32)
10. sqlite3-ruby 1.0.0 (ruby)
11. sqlite3-ruby 0.9.0 (ruby)
12. sqlite3-ruby 0.9.0 (mswin32)
13. sqlite3-ruby 0.6.0 (ruby)
14. sqlite3-ruby 0.5.0 (ruby)
15. Cancel installation
>
Select 2.
wxruby gemwxWidgets is the library used to build dradis' graphical interface. wxruby are the bindings needed to use wxWidgets inside ruby. To install them, open a console and type:-
# gem install wxruby
Select which gem to install for your platform (i486-linux)
1. wxruby 1.9.4 (x86_64-linux)
2. wxruby 1.9.4 (x86-linux)
3. wxruby 1.9.4 (i386-mswin32)
4. wxruby 1.9.3 (x86-linux)
5. wxruby 1.9.3 (i386-mswin32)
6. wxruby 1.9.3 (universal-darwin)
7. wxruby 1.9.2 (x86_64-linux)
8. wxruby 1.9.2 (powerpc-darwin8.10.0)
9. wxruby 1.9.2 (i686-darwin8.8.2)
10. wxruby 1.9.2 (i386-mswin32)
11. wxruby 1.9.2 (i686-linux)
12. wxruby 1.9.1 (powerpc-darwin8.3.0)
13. wxruby 1.9.1 (x86_64-linux)
14. wxruby 1.9.1 (i686-linux)
15. wxruby 1.9.1 (i686-darwin8.4.1)
16. wxruby 1.9.1 (i386-mswin32)
17. wxruby 1.9.0 (i686-darwin8.4.1)
18. wxruby 1.9.0 (powerpc-darwin8.10.0)
19. wxruby 1.9.0 (i686-linux)
20. wxruby 1.9.0 (i386-mswin32)
21. Cancel installation
>
Once again, select 2. Please make sure that you select the version 1.9.4 of the gem. The wxruby people have released a few versions afterwards and dradis was built with the 1.9.4 release.
A quick note on this for Debian stable users, you may not be able to use wxruby in your platform because there is a problem with GLIBC_2.4. If this is the case, please use the Qt interface of dradis.
You will need to download and install both th Qt library and its binding for the ruby language:
apt-get install libqt4-core libqt4-gui libqt4-ruby
download, configure and launch dradis
Platform independent instructions are provided in the download, configure and launch page.
If you need more information try the full user manual or the documentation page.