MOD amélioration (légère) de la présentation de la page d'admin
[euphorik.git] / doc / installation.txt
1 -- Description de l'installation de Euphorik --\r
2 \r
3 Voici les différentes étapes décrivant l'installation du site euphorik. Certaines données sont a adaptées en fonction des besoins. L'installation est décrite pour le système d'exploitation Debian.\r
4 \r
5 * On admet que le dossier de base est "/euphorik".\r
6 * On admet que l'utilisateur courant est "toto" et qu'il possède "/euphorik"\r
7 * Tout ce qui commence par un '$' correspond à une ligne de commande tapée dans le shell de l'OS.\r
8 * Tout ce qui commence par un '>' correspond à une instruction dans le shell de erlang.\r
9 \r
10 \r
11 1. Installer Yaws\r
12    a) $apt-get install yaws\r
13 \r
14 2. Configurer Yaws\r
15    a) Ajouter les lignes suivantes dans /etc/yaws/yaws.conf :\r
16       - "ebin_dir = /euphorik/modules/ebin"\r
17       - "include_dir = /euphorik/modules/include"\r
18    b) Le serveur virtuel est définit comme ceci dans /etc/yaws/conf.d/localhost.conf :\r
19       <server localhost>\r
20          port = 8081\r
21          listen = 0.0.0.0\r
22          docroot = /euphorik\r
23          allowed_scripts = [yaws]\r
24          appmods = <request, euphorik_requests>\r
25       </server>\r
26    c) Editer '/etc/init.d/yaws' et remplacer cette ligne :\r
27       script="$DAEMON -I $YAWS_ID $@"\r
28       par celle ci :\r
29       script="$DAEMON --erlarg \"-smp auto\" --sname yaws --mnesiadir '\"/euphorik/BD\"' -I $YAWS_ID $@"\r
30       FIXME : trouver une méthode plus élégante.\r
31 \r
32 3. Créer la base de donnée\r
33    a) Arreter Yaws (en root) :\r
34       $/etc/init.s/yaws stop\r
35    b) Lancer un noeud Erlang\r
36       - Se placer dans le répertoire /euphorik/modules/ebin\r
37       - Executer : \r
38          $erl -sname yaws -mnesia dir '"/euphorik/BD"'\r
39    c) Charger le module :\r
40       >l(euphorik_bd).\r
41    d) Créer la base :\r
42       >euphorik_bd:create().\r
43    e) Démarrer Yaws (en root) :\r
44       $/etc/init.s/yaws start\r
45    \r
46 4. Adminisatration du site Euphorik\r
47    a) Connexion au noeud "yaws"\r
48          erl -sname gb\r
49       puis dans la console :\r
50          CTRL-G\r
51          r yaws@overnux\r
52          c 2\r
53       Pour plus d'infos : http://www.ejabberd.im/interconnect-erl-nodes\r
54       Il est possible de connecter un shell directement sur le noeud de yaws comme ceci :\r
55          erl -sname gb -remsh yaws@overnux\r
56       \r
57    b) Utiliser les outils des modules\r
58       - Par exemple :\r
59          >euphorik_minichat:messages(10).\r
60          pour voir les 10 derniers messages   \r
61       \r
62    c) Ancienne méthode de connexion (plus compliqué)\r
63       - Le cookie de Yaws (/var/run/yaws/.erlang.cookie ou /var/cache/yaws/.erlang.cookie) et celui de l'utilisateur courant (~/.erlang.cookie) doit être le même.\r
64          (si le cookie de yaws est modifié il faut relancer yaws).\r
65       - Se placer dans le répertoire /euphorik/modules/ebin\r
66       - Executer : \r
67          $erl -sname toto\r
68          où "toto" est le nom du noeud (tout sauf "yaws")\r
69       - Charger le module du minichat :\r
70          >l(euphorik_minichat)\r
71       - Se connecter au noeud yaws :\r
72          >euphorik_minichat:connect()\r
73          la valeur retournée doit être : {ok,[yaws@overnux]}\r
74          \r
75    d) Informations sur la mémoire consommée :\r
76       Mémoire totale (ko) :\r
77           trunc(element(2, lists:nth(1, memory())) / 1024).\r
78       voir c:i() également\r