# Configuration for development and test environments (GNU/Linux)

## Git

Git is officially maintained in Debian/Ubuntu:

```
sudo apt-get install git
```

## Ruby

Ruby versions packaged in official repositories are not suitable to work with consul (at least Debian 7 and 8), so we'll have to install it manually.

The preferred method is via rvm:

(only the multi user option installs all dependencies automatically, as we use 'sudo'.)

### As local user

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

### For all system users

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

and then add your user to rvm group

```
sudo usermod -a -G rvm <user>
```

and finally, add rvm script source to user's bash (~/.bashrc) (this step it's only necessary if you still can't execute rvm command)

```
[[ -s /usr/local/rvm/scripts/rvm ]] && source /usr/local/rvm/scripts/rvm
```

with all this, you are suppose to be able to install a ruby version from rvm, as for example version 2.3.0:

```
sudo rvm install 2.3.0
```

## Bundler

with

```
gem install bundler
```

or there is more methods [here](https://rvm.io/integration/bundler) that should be better as:

```
gem install rubygems-bundler
```

## PostgreSQL (>=9.4)

PostgreSQL version 9.4 is not official in debian 7 (wheezy), in 8 it seems to be officially maintained.

So you have to add a repository, the official postgresql works fine.

Add the repository to apt, for example creating file */etc/apt/sources.list.d/pgdg.list* with:

```
deb http://apt.postgresql.org/pub/repos/apt/ wheezy-pgdg main
```

afterwards you'll have to download the key, and install it, by:

```
wget https://www.postgresql.org/media/keys/ACCC4CF8.asc
apt-key add ACCC4CF8.asc
```

and install postgresql

```
apt-get update
apt-get install postgresql-9.4
```

Besides, you will also need the dev libraries and headers so that pg gem can be compiled when running `bundle install`. Also, you will need the postgresql postGIS scripts. You can install them by running a single command:

```
apt-get install postgresql-server-dev-9.4 postgresql-9.4-postgis-scripts
```

## Cloning the repository

Now, with all the dependencies installed, clone the CONSUL repository:

```
git clone https://github.com/consul/consul.git
cd consul
bundle install
cp config/database.yml.example config/database.yml
cp config/secrets.yml.example config/secrets.yml
```

Perhaps it's needed to create a superuser rol with password in postgresql, and write it in */config/database.yml* 'user:' and 'password:' fields.

Also, it seems that postgresql use as default an unix socket for localhost communications. If we encounter problems creating database (connection problems) we can change in */config/database.yml* the line:

```
host: localhost
```

for:

```
host: /var/run/postgresql
```

After this:

```
rake db:create
rake db:setup
rake db:dev_seed
RAILS_ENV=test bin/rake db:setup
```

If you get the following error message when running `rake db:create`:

```
PG::InvalidParameterValue: ERROR:  new encoding (UTF8) is incompatible with the encoding of the template database (SQL_ASCII)
HINT:  Use the same encoding as in the template database, or use template0 as template.
```

you probably have template1 using `SQL_ASCII` encoding instead of `UTF8`, to correct this run the following sequence of commands within the postgresql client to recreate the template1 with `UTF8` encoding:

```
UPDATE pg_database SET datistemplate = FALSE WHERE datname = 'template1';
DROP DATABASE template1;
CREATE DATABASE template1 WITH TEMPLATE = template0 ENCODING = 'UNICODE';
UPDATE pg_database SET datistemplate = TRUE WHERE datname = 'template1';
\c template1
VACUUM FREEZE;
```