Libervia

De Goffiwiki.


Cette page en fin de traduction comporte sous doute des erreurs et une relecture s'impose. Les instructions originales se trouvent sur la page en anglais.


Libervia est l'interface web de SàT

Contents

Installation

L'installation de Libervia est relativement délicate.

Prérequis

Salut à Toi

  • SAT doit être installé et configuré ainsi que ses médias téléchargés et décompressés dans un dossier spécifique.

Serveur XMPP

  • Il faut installer un serveur local XMPP. Nous recommandons d'utiliser prosodie. Entrez ces commandes sous Debian et dérivés ou adaptez-les à votre distribution:
 hg clone http://hg.prosody.im/trunk prosody-hg
 cd prosody-hg
 configure --ostype=debian
 make

Si vous rencontrez une erreur consultez le fichier INSTALL et compléter les dépendances. Utiliser prosody.cfg.lua.dist pour créer votre propre configuration:

 cp prosody.cfg.lua.dist prosody.cfg.lua

Voici une configuration possible de prosodie avec le domaine XMPP "example.net" qu'il faut lancer depuis le répertoire de travail ( c'est à dire sans faire "make install"). Si vous installez il vous faut modifier le chemin du fichier de pid:

 [...]
 modules_enabled = {
               [...]
               "posix"; -- POSIX functionality, sends server to background, enables syslog, etc.
               [...]
 }
 allow_registration = true
 pidfile = "prosody.pid"
 [...]
 VirtualHost "example.net"
 [...]

Remarque: pour déclarer un hôte Virtuel supplémentaire "localhost" et éviter tout problème par la suite, SàT doit utiliser son propre nom de domaine comme "example.net". Vous devez ensuite modifier le fichier /etc/hostname afin qu'il ne contienne que cette ligne:

 example.net

et /etc/hosts pour qu'il contienne au minimum les lignes suivantes:

 127.0.0.1    localhost
 127.0.0.1    example.net

Important: pour l'instant le domaine XMPP qui doit être utilisé par Libervia est encore codée en dur dans un plugin SAT. Vous devez éditer le fichier sat/src/plugins/plugin_misc_account.py et adapter les paramètres suivants, puis réinstallez SAT:

 _REG_EMAIL_FROM = "NOREPLY@example.net"
 _REG_EMAIL_SERVER = "localhost"
 _REG_ADMIN_EMAIL = "admin@example.net"
 _NEW_ACCOUNT_SERVER = "localhost"
 _NEW_ACCOUNT_DOMAIN = "example.net"
 _NEW_ACCOUNT_RESOURCE = "libervia"
 _PROSODY_PATH = "/home/<user>/workspace/prosody-hg"
 _PROSODYCTL = "/home/<user>/workspace/prosody-hg/prosodyctl"

l'Éxécution du serveur de messagerie n'est pas obligatoire, mais nécessaire pour obtenir la confirmation de création du compte.

  • Étape supplémentaire pour activer la fonction de micro-blogging avec le serveur XMPP prosodie

Vérifiez que module remote_roster fait partie de l'installation de prosodie:

 cd prosody/plugins
 ls mod_remote_roster.lua

Si mod_remote_roster.lua existe déjà, nous allons le remplacer (attention, c'est une méthode temporaire pour utiliser SàT PubSub):

 mv mod_remote_roster.lua mod_remote_roster.lua.ori

maintenant, nous allons télécharger la version patchée pour utiliser SàT PubSub

 wget http://paste.debian.net/download/121248 -O mod_remote_roster.lua

Re-éditez le fichier prosodi.cfg.lua pour ajouter le module:

 modules_enabled = {
               [...]
               "remote_roster";
               [...]
 }

Ajoutez également ces deux lignes à la fin du fichier en les adaptant à votre domaine de serveur XMPP (hôte virtuel) et entrez un mot de passe:

 Component "sat-pubsub.<xmpp_domain>"
         component_secret = "<password>"

sat_pubsub

  • installez sat_pubsub
 hg clone http://repos.goffi.org/sat_pubsub

Suivez la procédure telle que décrite dans le fichier INSTALL en portant attention aux dépendances ainsi qu'à la création de la base de données. Vous pourriez avoir besoin d'une commande comme:

 sudo -u postgres createuser -d -P `whoami`
 createdb pubsub
 psql pubsub < sat_pubsub/db/pubsub.sql

Dépendances

  • Installez txJSON-RPC. Le script d'installation actuel de la version stable est buggé mais il a été fixé dans le dépôt Bazar. Il vous faut donc cloner le dépôt Bazaar ou git:
 bzr branch lp:txjsonrpc

ou

 git clone git://github.com/oubiwann/txjsonrpc

Vous pouvez maintenant passer à l’installation:

 cd txjsonrpc
 python setup.py install (en root, "sudo python setup.py install" pour *buntu)
  • installez python2-gobject2 depuis vos propres dépôts
  • installez la version git de pyjamas:
 git clone git://pyjs.org/git/pyjamas.git
 cd pyjamas
 python boostrap.py (vous pourriez avoir besoin de forcer une version de python si la compilation de libervia ne fonctionne pas, par exemple python2.6: python2.6 boostrap.py)

Contrôlez que tout est fonctionnel en compilant "helloworld":

 cd examples/helloworld
 ./build.sh

si vous n'avez aucun message d'erreur c'est que ça doit être bon :)

Libervia

  • Installer Libervia en utilisant setuptools. L'exécutable pyjsbuild doit être accessible à partir de votre variable d'environnement "PATH". Le plus simple serait encore:
 cd pyjamas
 sudo ln -sf bin/pyjsbuild /usr/bin/pyjsbuild 
  • clonez le dépôt libervia:
 hg clone http://repos.goffi.org/libervia
  • installez Libervia:
 cd libervia
 python setup.py install
  • créer un compte "libervia@votreserveur.tld" (remplacez "votreserveur.tld" par "example.net") sur votre serveur XMPP, créer un profil sur SAT nommé "libervia", et connectez votre profil SAT à ce compte .

Utilisation

Les quatre composants doivent être chargés dans cet ordre:

  • prosody
 cd prosody && prosodyctl start
  • sat_pubsub (domaine xmpp et mot de passe tels que déclarés dans prosodi.cfg.lua)
 twistd sat_pubsub --jid=sat-pubsub.<domaine_xmpp> --secret=<mot_de_passe>
  • sat
 sat
  • le serveur web libervia
 libervia

Voici un script bash pour vous aider à redémarrer les services durant la phase d’installation (sat sera réinstallé et libervia reconstruit avant chaque démarrage): Helping_script_to_launch_a_Libervia_server/en

Si vous avez des questions ou si vous rencontrez des problèmes vous pouvez vous connecter au salon sat@chat.jabberfr.org ou utiliser la liste des développeurs à http://lists.goffi.org

Autres langues