Development:Setup:OSX: Difference between revisions

From Expertiza_Wiki
Jump to navigation Jump to search
No edit summary
Line 77: Line 77:
This step is not necessary, but it is advised to set a root mysql password.
This step is not necessary, but it is advised to set a root mysql password.
<pre style="white-space:normal;">mysqladmin -u root password</pre>
<pre style="white-space:normal;">mysqladmin -u root password</pre>
====DEPRECATED [Use .sql script instead]
====DEPRECATED [Use .sql script instead]====
=====Log in to MySql=====
=====Log in to MySql=====
<pre style="white-space:normal;">mysql -uroot -p</pre>
<pre style="white-space:normal;">mysql -uroot -p</pre>
The following commands are executed inside mysql
The following commands are executed inside mysql
====DEPRECATED


====Create the Expertiza User====
=====Create the Expertiza User=====
<pre style="white-space:normal;">create user expertiza@localhost;</pre>
<pre style="white-space:normal;">create user expertiza@localhost;</pre>


====Create the Databases====
=====Create the Databases=====
<pre style="white-space:normal;">create database expertiza_development;</pre>
<pre style="white-space:normal;">create database expertiza_development;</pre>
<pre style="white-space:normal;">create database expertiza_test;</pre>
<pre style="white-space:normal;">create database expertiza_test;</pre>


====Grant Privileges to the Expertiza User====
=====Grant Privileges to the Expertiza User=====
<pre style="white-space:normal;">grant all on expertiza_development.* to expertiza@localhost;</pre>
<pre style="white-space:normal;">grant all on expertiza_development.* to expertiza@localhost;</pre>
<pre style="white-space:normal;">grant all on expertiza_test.* to expertiza@localhost;</pre>
<pre style="white-space:normal;">grant all on expertiza_test.* to expertiza@localhost;</pre>
====DEPRECATED====


==Build the Expertiza Database==
==Build the Expertiza Database==

Revision as of 16:55, 12 March 2017

Prerequisites

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

Install Git

Git for OS X

Get Expertiza

Fork Expertiza to your Github

  • If you don't have a Github account, register one, and remember the password!!
  • go to https://github.com/expertiza/expertiza and click on the "Fork" button on the upper right side.
  • When asked "Where should we fork this repository?" choose your account, which usually looks like this "@YourUsername"
  • Then go to https://github.com/[YourUsername]/expertiza and click on the "Clone or Download" button
  • Copy the url, which usually looks like "https://github.com/[YourUsername]/expertiza.git"
  • Then go to your terminal and go to a folder of your choice where the codes will be downloaded into.
  • To clone the project, type in "git clone https://github.com/[YourUsername]/expertiza.git"
  • when asked for a password, enter your password

Merge your changes to Expertiza

  • When you're done editing the code, commit the code to your local repository by executing this in terminal:
    • git add -A #mark all changed files to be committed to the repository
    • git commit -m "say what you have done to the code" #commit your changes to the local repository
    • git push #sync your changes to the remote repository
  • Do commit as often as needed to store the states of the code. Do commit before you do changes that you're not sure about. It'd allow you to revert back to your previous states if you screw up the code.
  • Do push less often (maybe every 5-10 commits)
  • Before requesting for a merge, please refactor your code and put comments. Bad code won't be merged!
  • After you're done with beautifying your project, go to https://github.com/[YourUsername]/expertiza, and click on "New pull request" on the left side.
  • Your code will be reviewed and merged if the quality is good enough!

[DEPRECATED. DO NOT USE UNLESS ADVISED]

Expertiza Repository URLs
Default [DEPRECATED]
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

Install Homebrew

http://mxcl.github.io/homebrew

Install RBENV

$ brew update
$ brew install rbenv
$ brew install ruby-build

Install Ruby v. 2.1.5

https://github.com/sstephenson/ruby-build/wiki#installing-187-on-os-x-108-mountain-lion

Install Native Expertiza Dependencies

Dependencies are for the gems raspell, rjb, nokogiri, and mysql.

brew install aspell gcc47 libxml2 libxslt graphviz openssl

Install Bundled Gems

Set JAVA_HOME for the rjb gem (set it to a valid location, your path may vary):

export JAVA_HOME=/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home/
bundle install

Possible alternate step if _bundle install_ command has build errors:

$ bundle config build.eventmachine --with-cppflags=-I/usr/local/opt/openssl/include
$ brew install apple-gcc42
$ brew unlink apple-gcc42
$ brew link apple-gcc42
$ export CC=/usr/local/Cellar/apple-gcc42/4.2.1-5666.3/bin/gcc-4.2
$ export CXX=/usr/local/Cellar/apple-gcc42/4.2.1-5666.3/bin/g++-4.2
$ export CPP=/usr/local/Cellar/apple-gcc42/4.2.1-5666.3/bin/cpp-4.2

Set Up the Database

Set the MySql Root Password

This step is not necessary, but it is advised to set a root mysql password.

mysqladmin -u root password

DEPRECATED [Use .sql script instead]

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 expertiza_development;
create database expertiza_test;
Grant Privileges to the Expertiza User
grant all on expertiza_development.* to expertiza@localhost;
grant all on expertiza_test.* to expertiza@localhost;

DEPRECATED

Build the Expertiza Database

First, you have to copy the sample database config to a real one.

cp config/database.yml.example config/database.yml

Then edit the file and put your mysql password in there so it can log into the db

vi config/database.yml

Notice: You may need to prepend the following commands with bundle exec.

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 production load_data