helma / lazar-gui

Ruby on Rails webinterface for lazar (use opentox-app-lazar in the future)

This URL has Read+Write access

README.rdoc

LAZAR-GUI

This is an example GUI for the lazar prediction system and public data from the DSSTOX project.

Installation

Prerequisites

Debian and Ubuntu

The installation script (see below) installs all prerequisites. You have to have sudo (www.sudo.ws/) installed and configured.

Other distributions

You will have to install the prerequisites with your favorite package manager. Please make shure to have

Get the GUI source code

  • Clone the git repository git clone git://github.com/helma/lazar-gui.git

Install programs, libraries, plugins and data

  • Move into the directory (e.g. cd /var/www/lazar-gui)
  • Run script/app-install

This will download and install further programs, libraries, plugins and data that are required to run the GUI. The initial installation is quite time consuming, because we have to compile programs and libraries to obtain platform independence.

Start the lazar daemon

vendor/bin/rake lazar:daemon:start RAILS_ENV=production

Start the GUI server

vendor/bin/thin start -d -p 8000 -e production

The GUI will now be available at port 8000 of your machine. You can access it from any browser by pointing it to yourserver:8000. You will have to enable Java and Javascript in the client browsers to use the molecular editor.

If performance is an issue, you can use Thin (code.macournoyer.com/thin/) or Mongrel (mongrel.rubyforge.org) in conjunction with a traditional webserver (e.g. Apache) to serve the GUI. You can find installation instructions here.

Upgrading

  • Stop the GUI server: vendor/bin/thin stop
  • Stop the lazar daemon: vendor/bin/rake lazar:daemon:stop RAILS_ENV=production
  • Get the update: git pull
  • Rerun the installation scripts: script/app-upgrade
  • Start the lazar daemon: vendor/bin/rake lazar:daemon:start RAILS_ENV=production
  • Start the GUI server: vendor/bin/thin start -d -p 8000 -e production