Development:Setup:Linux:Debian

Prerequisites

• You must have shell access
• You must have root access (via sudo), or the required software must already be installed

Install Git

sudo apt-get install git curl

Get Expertiza

Expertiza Repository URLs

• (ssh, read/write) git@github.com:expertiza/expertiza.git
• (https, read/write) https://github.com/expertiza/expertiza.git
• (git, read-only) git://github.com/expertiza/expertiza.git

Default

git clone <remote>

git clone git@github.com:expertiza/expertiza.git

Options

git clone -b <branch> <remote>

git clone -b production git@github.com:expertiza/expertiza.git

To Rename the Central Remote

git remote rename <current_name> <desired_name>

git remote rename origin upstream

Install RVM

RVM Install

Single User Mode (Recommended)

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

Load RVM as a Function

source ~/.rvm/scripts/rvm

Multi User Mode (Not Recommended)

\curl -L https://get.rvm.io | sudo bash -s stable

Load RVM as a Function

source /etc/profile

Post-Installation

Is RVM a Function?

$ type rvm | head -1
rvm is a shell function

If not, try loading RVM as a function again. If it is still not a function, try reinstalling RVM.

Make sure all the dependencies are met for RVM

rvm requirements

This will show a yum command. Run it to install the dependancies for Ruby. For example:

sudo apt-get --no-install-recommends -y install build-essential openssl libreadline6 libreadline6-dev curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev libgdbm-dev ncurses-dev automake libtool bison subversion pkg-config libffi-dev

Install Ruby v. 2.1.5

rvm install 2.1.5

rvm use 2.1.5

Create Expertiza Gemset (optional)

rvm use 2.1.5

rvm gemset create expertiza

rvm use 2.1.5@expertiza

Create a .rvmrc File (optional)

echo 'rvm use 2.1.5@expertiza' > .rvmrc

Install Native Expertiza Dependencies

Dependencies are for the gems raspell, rjb, nokogiri, and mysql. You may be prompted multiple times to set a root password for mysql. This password is up to you, but it can be left blank.

sudo apt-get install openjdk-6-jre-headless openjdk-6-source mysql-client mysql-server libmysqlclient-dev libaspell-dev libpq-dev

Install Bundled Gems

Set JAVA_HOME for the rjb gem: Your path may be different. You can generally find out the path by looking at the symbolic link at /etc/alternatives/java

ls -la /etc/alternatives/java

This outputs something like '/usr/lib/jvm/java-6-openjdk-amd64/jre/bin/java'. Only part of this path may need to be set to JAVA_HOME. In this instance, it is '/usr/lib/jvm/java-6-openjdk-amd64'.

export JAVA_HOME=/usr/lib/jvm/java-6-openjdk-amd64

bundle install

Set Up the Database

Enable and Start the MySql Daemon

sudo service mysqld enable

sudo service mysqld start

Set the MySql Root Password

mysqladmin -u root password

Automatic Configuration

mysql -uroot < db/grant_expertiza.sql

Manual Configuration

Log in to MySql

mysql -uroot -p

The following commands are executed inside mysql

Create the Expertiza User

create user expertiza@localhost;

Create the Databases

create database pg_development;

create database pg_test;

Grant Privileges to the Expertiza User

grant all on pg_development.* to expertiza@localhost;

grant all on pg_test.* to expertiza@localhost;

Build the Expertiza Database

rake db:migrate

rake db:test:prepare

Import Production Data (Optional)

This step requires that you have your ssh private/public key pairs loaded in the production server under the rails user.
How to Add SSH Keys to the Expertiza Production Server
You must run the following command from your local Expertiza project directory.

cap load_production_data