heuliad

h1. Installation pour le développeur

h2. Installation RVM

Pour installer la dernière version stable de RVM utiliser la commande suivante : 

<pre>

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

</pre>

h2. Installation Ruby

h3. Installation d'une version de Ruby

La commande pour installer la version *** de Ruby à l'aide de RVM :

<pre>

rvm install ***

</pre>

Par exemple : 

<pre>

rvm install-2.3.0

</pre>

h3. Choisir et afficher une version

h4. Choisir la version a utiliser

<pre>rvm ruby -v 2.0</pre>

h4. Afficher la version utilisé actuellement

<pre>ruby -v</pre>

h4. Lister toutes les versions installées sur le poste

<pre>rvm list</pre>

h2. Création et configuration du Gemset

h3. Création

<pre>rvm gemset create gemset_name</pre>

h3. Liaison de la version de Ruby au gemset

<pre>rvm ruby_version@gemset_name  # specify Ruby version and our new gemset</pre>

h2. Clonage du projet heuliad

h3. Prérequis

Configurer git pour l'accès au serveur gitiuem + "Tutoriel git":https://www-iuem.univ-brest.fr/feiri/soutiens-scientifique/calcul-scientifique/wiki/utilisation-de-git

h3. Clonage

Si vous avez un compte sur le dépôt git de l'IUEM (accès en écriture) :

<pre>git clone gitiuem:heuliad</pre>

Sinon :

<pre>git clone ssh://git@tucuxi.univ-brest.fr/heuliad</pre>

h3. Installer l'environnement Ruby et ses gems

Si bundler n'est pas installé

<pre>gem install bundler</pre>

Installation des gems listées dans le Gemfile

<pre>bundle install</pre>

h2. Installer la base de données

h3. Installation postgis et postgresql

<pre>apt-get install postgis</pre>

<pre>apt-get install posgresql</pre>

h3. Création compte

Une fois posgresql installé, un compte administrateur "postgres" est défini par défaut, 

il faut donc changer d'utilisateur pour gérer postgresql et se créer son propre compte.

Commande pour changer d'utilisateur :

<pre>sudo -i -u postgres</pre>

Charger la console postgres :

<pre>psql</pre>

Commande pour créer un nouvel utilisateur (en mode postgres) :

<pre>CREATE USER <nom_utilisateur>;</pre>

Donner le droit de créer une base de donnée à celui ci :

<pre>ALTER ROLE <nom_utilisateur> WITH CREATEDB;</pre>

h3. Création base de données personelle (utiliser le nom nom_utilisateur pour la base permet une connexion automatique)

<pre>CREATE DATABASE <nom_base_de_donnee> OWNER <nom_utilisateur>;</pre>

Sécuriser l'accès à la base par un mot de passe :

<pre>ALTER USER <nom_utilisateur> WITH ENCRYPTED PASSWORD 'mon_mot_de_passe';</pre>

Quitter le mode postgres :

<pre>\q</pre>

Quitter l'utilisateur "postgres" :

<pre>exit</pre>

Ouvrir la base de donnée :

<pre>psql -U <nom_utilisateur> -h localhost -W</pre>

* entrer son mot de passe

Créer base de donnée pour heuliad

<pre>CREATE DATABASE heuliad;</pre>

h2. /config/database.yml

h3. Configurer l'environnement

Dans le dossier config se trouve un fichier exemple de configuration de base de donnée nommé "database.yml.example"

Vous pouvez donc copier ce texte et changer le nom du fichier en database.yml (il faut remplacer les champs en fonction du compte postgres) 

<pre>

default: &default

  adapter: sqlite3

  pool: 5

  timeout: 5000

development: &local

  adapter: postgis

  host: localhost

  port: 5432

  password: 'mon_mot_de_passe'

  username: <nom_utilisateur>

  database: heuliad

#  schema_search_path: "public,postgis"

  script_dir: /usr/share/postgresql/9.1/contrib/postgis-1.5

test:

  <<: *local

  database: heuliad_test

</pre>

h2. Console et Serveur

h3. Mise en place de la base de données

Premièrement il est nécessaire d'installer le package "postgresql-9.3-postgis-scripts" afin que tout le code soit reconnu

<pre>apt install postgresql-9.3-postgis-scripts</pre>

Ensuite on peut effectuer les migrations, permettant d'initialiser la base de donnée en fonction des modèles Ruby

<pre>rake db:migrate</pre>

h3. Connexion à la base de données

Maintenant il est possible de se connecter à la base

<pre>rails db</pre>

ou de lancer la console pour effectuer des tests

<pre>rails c</pre>

ou encore de lancer le serveur

<pre>rails s</pre>