Installation de Emoncms sur Ubuntu / Debian / Raspberry Pi

Ce guide a été écrit lors de l'installation d'emoncms sur une Raspberry Pi avec une distribution raspbian “wheezy”, les étapes ci-dessous devrait donc fonctionner sur l'ensemble des distributions basées sur Debian.

1) Installer mysql

$ sudo apt-get install mysql-server mysql-client

Lorsque l'invite de commande apparaît, indiquez un mot de passe pour l'utilisateur root (notez ce mot de passe car vous en aurez besoin plus tard).

2) Installer apache2

$ sudo apt-get install apache2

3) Installer php

$ sudo apt-get install php5 libapache2-mod-php5
$ sudo apt-get install php5-mysql

4) Activer le mod rewrite

$ sudo a2enmod rewrite
$ sudo nano /etc/apache2/sites-enabled/000-default

Modifiez les lignes 7 et 11: "AllowOverride None" to "AllowOverride All".
Enregistrez : [Ctrl + X ] puis [Y] et enfin [Entrée].

5) Redémarrez le serveur afin de prendre en compte les modifications

$ sudo /etc/init.d/apache2 restart

 

Installation  de emoncms:

6) Installer git (optionnel)

$ sudo apt-get install git-core

Vous pouvez suivre ce tutoriel afin de générer les clés SSH nécessaires au bon fonctionnement de git avec github.
https://help.github.com/articles/generating-ssh-keys

Utile : Si vous générez vos clés en depuis un terminal SSH, utilisez la commande $ cat /home/pi/.ssh/id_rsa.pub pour afficher les clés dans votre terminal. Vous pouvez alors copier ces clés (en utilisant [Ctrl+Maj+C]) puis les coller sur la page de configuration GitHub.

7) Télécharger Emoncms

Rendez vous dans le répertoire /var/ :

$ cd /var/

Changer les droits du répertoire /var/www pour autoriser l'utilisateur pi à modifier ce répertoire :

$ sudo chown pi www

Rentrez dans le répertoire

$ cd www

Téléchargez la  version stable de emoncms grâce à la commande git clone :

$ git clone git://github.com/emoncms/emoncms.git

Vous pouvez également télécharger la dernière version de emoncms et la dézipper sur votre serveur :
https://github.com/emoncms/emoncms

8) Créer une base de données MySQL

$ mysql -u root -p

Vous devez indiquez ici le mot de passe que vous avez tapé à l'étape 1.

Créez la base de données appelée emoncms :

mysql> CREATE DATABASE emoncms;

Quittez en tapant :

mysql> exit

9) Configurer la base de données emoncms

Changez de répertoire pour modifier le fichier de configuration :

$ cd /var/www/emoncms/

Copiez le fichier default.settings.php et renommez le settings.php :

$ cp default.settings.php settings.php

Ouvez settings.php :

$ nano settings.php

Vous devriez avoir ceci:

Modifiez le fichier en indiquand vos paramètres.

Enregistrez : [Ctrl+X], puis tapez [Y]

10) Lancez emoncms depuis votre navigateur

http://YOURIP/emoncms

La base de données va être automatiquement configurée la première fois que vous lancez emoncms. Vous n'avez plus qu'à créer un nouveau compte en tapant un nom d'utilisateur et un mot de passe. Enfin, cliquez sur S'inscrire.

11) Configuration du module PHP Suhosin (Optionel - Debian 6)

Si vous rencontrez des problèmes lors de la modification de votre Tableau de Bord. Cela peut être dû à la valeur maximale des arguments HTTP GET (qui sous Debian 6 est fixaée à 512 octets).

Pour remédier à ce problème, vous pouvez modifier  suhosin.get.max_value_length dans le fichier /etc/php5/conf.d/suhosin.ini" (une valeur comprise entre 8000, 16000 devrait être suffisante).