Development:Setup:Linux:Debian

From Expertiza_Wiki
Jump to navigation Jump to search

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

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. 1.8.7

rvm install 1.8.7
rvm use 1.8.7

Create Expertiza Gemset (optional)

rvm use 1.8.7
rvm gemset create expertiza
rvm use 1.8.7@expertiza

Create a .rvmrc File (optional)

echo 'rvm use 1.8.7@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

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

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