This is the web app for the BioBoard. Below is an install guide to help you get started with the software for your BioBoard.
Installing the Web App
Create a directory for the software:
sudo apt-get install ruby-full
Go to http://rubygems.org/ and download the rubygems tgz.
extract the files:
tar xvzf rubygems-1.7.2.tgz
sudo ruby setup.rb
sudo ln -s gem1.8 gem
Install Ruby on Rails:
sudo gem install rails --no-rdoc --no-ri
Make sure you have git installed:
sudo apt-get install git-core
Get the code for the web app:
Install web app dependencies:
sudo apt-get install libsqlite3-dev
Initialize the database:
tar xvf config_examples.tar
Start the web app to see if it works:
You should get something like the following:
=> Booting WEBrick
=> Rails 3.0.5 application starting in development on http://0.0.0.0:3000
=> Call with -d to detach
=> Ctrl-C to shutdown server
[2011-05-01 21:57:44] INFO WEBrick 1.3.1
[2011-05-01 21:57:44] INFO ruby 1.8.7 (2010-06-23) [i686-linux]
Open your web-browser and go to:
You should see the welcome page. If you did: Congratulations! You're almost there :-) Let the webserver run, open up a new terminal and continue to the next section.
Installing the log & comet server
This assumes that you have installed the web app on the same computer. You can have the log & comet server on a different computer, but for that you're on your own.
Get the code:
Install the dependencies:
sudo aptitude install build-essential
sudo gem install eventmachine --no-ri --no-rdoc
sudo gem install json
Start the log server:
Note that the server assumes your sqlite database is at "../BioBoardSite/db/dev.sqlite". This will be true if you followed this guide. If you want to keep your sqlite database elsewhere, you need to modify the line "dbpath = '../BioBoardSite/db/dev.sqlite'" in the file "BioBoardLogServer/server.rb", and the line "database: db/dev.sqlite" in the file "BioBoardSite/config/database.yml".
Testing the setup
Now you are ready to test if everything works.
Open up a new terminal and go to the log server directory:
To test the setup, you can start a small program that simulates an attached BioBioard:
This will begin sending fake data to the server you started previously. You can now go back to your web browser to verify that the data is there.
In the project list at the bottom, click the "BATCH1" project.
If everything is working, you should see a graph with two lines. You can hit refresh in the browser to update the graphs with the new data.
Using the software
For information on how to use this software, go to: https://www.noisebridge.net/wiki/BioBoard/Documentation/PC_Software#Using_the_software