Developer:UbuntuInstallation

Table of Contents Step-by-step Installation Install dependencies Install RVM and Ruby Checkout myExperiment from source control Change Terminal settings Install gems Configuration Set up databases Create databases Create table structure Run the server Enable search Installation script for Ubuntu/Debian/Linux Mint

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.

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:

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.