Developer:UbuntuInstallation

From myExperiment
Jump to: navigation, search

Step-by-step Installation

Install dependencies

Note: While running the following commands you will be prompted to enter a password for the MySQL root user several times.

sudo apt-get update

sudo -n apt-get install -y build-essential exim4 git-core curl libcurl3 libcurl3-gnutls libcurl4-gnutls-dev openssl libreadline6 libreadline6-dev zlib1g \
 zlib1g-dev libssl-dev libyaml-dev mysql-server libmysqlclient-dev libxml2-dev libxslt-dev autoconf libc6-dev ncurses-dev automake libtool bison \
 git libmagickwand-dev graphviz gcj-jre-headless

Install RVM and Ruby

\curl -L https://get.rvm.io | bash -s stable --ruby=1.9.2

Checkout myExperiment from source control

git clone https://github.com/myExperiment/myExperiment.git

Change Terminal settings

Only necessary if installing from the Desktop, disregard if installing over SSH

Edit > Profile Preferences > Title and Commmand > Enable "Run command as a login shell"

Close and re-open terminal window.

Gnome terminal login shell.png

Install gems

Switch to the myExperiment directory:

cd myexperiment

Then execute the following command to install an old version of RubyGems that is compatible with myExperiment:

gem update --system 1.8.25

Then install the gems:

bundle install

Configuration

First, you need to create the database config file from the template by running the following command:

cp config/database.yml.pre config/database.yml

This file contains the database names and log-in credentials for your myExperiment MySQL databases.

Other myExperiment settings can be found in config/default_settings.yml, however you should not modify this file.

Instead, create a config/settings.yml file and any settings you define in there will override the defaults.

touch config/settings.yml

Set up databases

Create databases

bundle exec rake db:create:all

Create table structure

bundle exec rake db:migrate

Run the server

script/server

Then navigate to http://localhost:3000

Enable search

To start Solr, which powers myExperiment's search feature, run the following command:

bundle exec rake sunspot:solr:start

and to stop:

bundle exec rake sunspot:solr:stop

Installation script for Ubuntu/Debian/Linux Mint

An installer for Ubuntu, Debian or Linux Mint is available in the Github repository myExperiment-installers:

 git clone https://github.com/myExperiment/myExperiment-installers.git
 ubuntu/install.bash
 

This installs a minimally configured instance of myExperiment (for Rails 2) on a Ubuntu/Debian system. It should provide the myExperiment web interface at http://localhost/ (substitute with hostname as appropriate) as well as configure email delivery, as long as in the settings file you specify a email server that can relay email without authentication.

This installer has been developed on a freshly installed Ubuntu 10.04 LTS server build. The installer should work on later versions of Ubuntu and Debian, as well as working with non-freshly installed systems, however it is possible you may experience some problems.

UPDATE - May 2012: The installer has been tested and now works on Ubuntu 12.04 LTS as well as 10.04 LTS.

For more details see the README.txt file included in the SVN checkout.