X-Git-Url: http://git.euphorik.ch/?p=euphorik.git;a=blobdiff_plain;f=doc%2Finstallation.txt;h=57bb63088312ce54d9603ea13f5f69344937b4dc;hp=4f712859764f139b868e1c63575fc9526e60a8c2;hb=2424ba818818a6bd0b547fa540742f9b54db990b;hpb=e82b363f65838828948a62ef4452e752743ef661 diff --git a/doc/installation.txt b/doc/installation.txt index 4f71285..57bb630 100644 --- a/doc/installation.txt +++ b/doc/installation.txt @@ -1,79 +1,79 @@ --- Description de l'installation de Euphorik -- - -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. - -* On admet que le dossier de base est "/euphorik". -* On admet que l'utilisateur courant est "toto" et qu'il possède "/euphorik" -* Tout ce qui commence par un '$' correspond à une ligne de commande tapée dans le shell de l'OS. -* Tout ce qui commence par un '>' correspond à une instruction dans le shell de erlang. - - -1. Installer Yaws - a) $apt-get install yaws - -2. Configurer Yaws - a) Ajouter les lignes suivantes dans /etc/yaws/yaws.conf : - - "ebin_dir = /euphorik/modules/ebin" - - "include_dir = /euphorik/modules/include" - b) Le serveur virtuel est définit comme ceci dans /etc/yaws/conf.d/localhost.conf : - - port = 8081 - listen = 0.0.0.0 - docroot = /euphorik - allowed_scripts = [yaws] +-- Description de l'installation de Euphorik -- + +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. + +* On admet que le dossier de base est "/euphorik". +* On admet que l'utilisateur courant est "toto" et qu'il possède "/euphorik" +* Tout ce qui commence par un '$' correspond à une ligne de commande tapée dans le shell de l'OS. +* Tout ce qui commence par un '>' correspond à une instruction dans le shell de erlang. + + +1. Installer Yaws + a) $apt-get install yaws + +2. Configurer Yaws + a) Ajouter les lignes suivantes dans /etc/yaws/yaws.conf : + - "ebin_dir = /euphorik/modules/ebin" + - "include_dir = /euphorik/modules/include" + b) Le serveur virtuel est définit comme ceci dans /etc/yaws/conf.d/localhost.conf : + + port = 8081 + listen = 0.0.0.0 + docroot = /euphorik + allowed_scripts = [yaws] appmods = - start_mod = euphorik_daemon - - c) Editer '/etc/init.d/yaws' et remplacer cette ligne : - script="$DAEMON -I $YAWS_ID $@" - par celle ci : - script="$DAEMON --sname yaws --mnesiadir \"/euphorik/BD\" -I $YAWS_ID $@" - FIXME : trouver une méthode plus élégante. - -3. Créer la base de donnée - a) Arreter Yaws (en root) : - $/etc/init.s/yaws stop - b) Lancer un noeud Erlang - - Se placer dans le répertoire /euphorik/modules/ebin - - Executer : - $erl -sname yaws -mnesia dir '"/euphorik/BD"' - c) Charger le module : - >l(euphorik_bd). - d) Créer la base : - >euphorik_bd:create(). - e) Démarrer Yaws (en root) : - $/etc/init.s/yaws start - -4. Adminisatration du site Euphorik - a) Connexion au noeud "yaws" - erl -sname gb - puis dans la console : - CTRL-G - r yaws@overnux - c 2 - Pour plus d'infos : http://www.ejabberd.im/interconnect-erl-nodes - Il est possible de connecter un shell directement sur le noeud de yaws comme ceci : - erl -sname gb -remsh yaws@overnux - - b) Utiliser les outils des modules - - Par exemple : - >euphorik_minichat:messages(10). - pour voir les 10 derniers messages - - c) Ancienne méthode de connexion (plus compliqué) - - 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. - (si le cookie de yaws est modifié il faut relancer yaws). - - Se placer dans le répertoire /euphorik/modules/ebin - - Executer : - $erl -sname toto - où "toto" est le nom du noeud (tout sauf "yaws") - - Charger le module du minichat : - >l(euphorik_minichat) - - Se connecter au noeud yaws : - >euphorik_minichat:connect() - la valeur retournée doit être : {ok,[yaws@overnux]} - - d) Informations sur la mémoire consommée : - Mémoire totale (ko) : - trunc(element(2, lists:nth(1, memory())) / 1024). - voir c:i() également + start_mod = euphorik_daemon + + c) Editer '/etc/init.d/yaws' et remplacer cette ligne : + script="$DAEMON -I $YAWS_ID $@" + par celle ci : + script="$DAEMON --sname yaws --mnesiadir \"/euphorik/BD\" -I $YAWS_ID $@" + FIXME : trouver une méthode plus élégante. + +3. Créer la base de donnée + a) Arreter Yaws (en root) : + $/etc/init.s/yaws stop + b) Lancer un noeud Erlang + - Se placer dans le répertoire /euphorik/modules/ebin + - Executer : + $erl -sname yaws -mnesia dir '"/euphorik/BD"' + c) Charger le module : + >l(euphorik_bd). + d) Créer la base : + >euphorik_bd:create(). + e) Démarrer Yaws (en root) : + $/etc/init.s/yaws start + +4. Adminisatration du site Euphorik + a) Connexion au noeud "yaws" + erl -sname gb + puis dans la console : + CTRL-G + r yaws@overnux + c 2 + Pour plus d'infos : http://www.ejabberd.im/interconnect-erl-nodes + Il est possible de connecter un shell directement sur le noeud de yaws comme ceci : + erl -sname gb -remsh yaws@overnux + + b) Utiliser les outils des modules + - Par exemple : + >euphorik_minichat:messages(10). + pour voir les 10 derniers messages + + c) Ancienne méthode de connexion (plus compliqué) + - 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. + (si le cookie de yaws est modifié il faut relancer yaws). + - Se placer dans le répertoire /euphorik/modules/ebin + - Executer : + $erl -sname toto + où "toto" est le nom du noeud (tout sauf "yaws") + - Charger le module du minichat : + >l(euphorik_minichat) + - Se connecter au noeud yaws : + >euphorik_minichat:connect() + la valeur retournée doit être : {ok,[yaws@overnux]} + + d) Informations sur la mémoire consommée : + Mémoire totale (ko) : + trunc(element(2, lists:nth(1, memory())) / 1024). + voir c:i() également