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
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.3.1
rvm install 2.3.1
rvm use 2.3.1
Create Expertiza Gemset (optional)
rvm use 2.3.1
rvm gemset create expertiza
rvm use 2.3.1@expertiza
Create a .rvmrc File (optional)
echo 'rvm use 2.3.1@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
Setup Redis
Please install redis on your machine and then run redis-server command. These commands will help you run redis easily: $ wget http://download.redis.io/releases/redis-4.0.1.tar.gz $ tar xzf redis-4.0.1.tar.gz $ cd redis-4.0.1 $ make $ src/redis-server
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