Installation et Configuration de jabberd2

Le but de ce document et de proposer une façon simple et rapide d'installer un serveur jabberd2. Pour une configuration plus détaillée, il faut se référer à la documentation officielle de jabberd2 qui a servi à l'élaboration de cette page.

Pour garder les informations liées aux utilisateurs, vous devez avoir un serveur de base de donnée installé (postgre, mysql…).

Cette façon de procéder doit marcher pour dapper et edgy (il y a de forte chance que ce soit toujours valable pour feisty).

sudo apt-get update
sudo apt-get install jabberd2

Vous pouvez également utiliser Synaptic.

Votre nom de serveur doit être renseigné à la fois dans sm.xml et dans c2s.xml.

Editez sm.xml :

gksudo gedit /etc/jabberd2/sm.xml

Renseignez le champ id de la section sm (~ ligne 1) :

  <!-- Session manager configuration -->
  <sm>
    <!-- Our ID on the network. Users will have this as the domain part of
         their JID. If you want your server to be accessible from other
         Jabber servers, this ID must be resolvable by DNS.s
         (default: localhost) -->
    <id>ma_machine.mon_domaine.com</id>    

Editez c2s.xml :

gksudo gedit /etc/jabberd2/c2s.xml

Renseignez le champ id de la section local (~ ligne 63) :

  <!-- Local network configuration -->
  <local>
    <!-- Who we identify ourselves as. This should correspond to the
         ID (host) that the session manager thinks it is. You can
         specify more than one to support virtual hosts, as long as you
         have additional session manager instances on the network to
         handle those hosts. The realm attribute specifies the auth/reg
         or SASL authentication realm for the host. If the attribute is
         not specified, the realm will be selected by the SASL
         mechanism, or will be the same as the ID itself. Be aware that
         users are assigned to a realm, not a host, so two hosts in the
         same realm will have the same users.
         If no realm is specified, it will be set to be the same as the
         ID. -->
    <id>ma_machine.mon_domaine.com</id>

Comme il est mentionné dans le fichier c2s.xml, le nom du serveur (qui est concaténé à l'id jabber) doit pouvoir être résolu par DNS (ou via /etc/hosts) EVITEZ localhost ou une adresse ip, une ID jabber est <nom d'utilisateur>@<nom de serveur>, donc lorsqu'un client se connecte à votre serveur il doit avoir le bon nom de serveur et pas une adresse ip (et évidemment pas localhost)

Dans un terminal :

sudo su postgres
createdb jabberd2
createuser -SDRP jabberd2
createdb -O jabberd2 jabberd2
psql -U jabberd2 -h 127.0.0.1

Dans la session psql :

jabberd2=>\i /usr/share/doc/jabberd2/db-setup.pgsql
jabberd2=>\q

(Ne pas faire attention à la première ligne d'erreur) N'oubliez pas de vous déconnecter de la session postgres :

exit

Editez sm.xml et dans la section Storage database configuration, renseignez le champ driver avec pgsql (PostgreSQL) :

gksudo gedit /etc/jabberd2/sm.xml

  <!-- Storage database configuration -->
  <storage>
    <!-- By default, we use the MySQL driver for all storage -->
    <driver>pgsql</driver>   

Toujours dans sm.xml dans la section PostgreSQL driver configuration, remplacez secret avec le mot de passe de l'utilisateur jabberd2 de PostgreSQL. Changez le nom de l'utilisateur et/ou de la base si vous n'utilisez pas ceux par défaut (jabberd2 et jabberd2) :

  <!-- PostgreSQL driver configuration -->
  <pgsql>
    <!-- Database server host and port -->
    <host>localhost</host>
    <port>5432</port>
 
    <!-- Database name -->
    <dbname>jabberd2</dbname>
 
    <!-- Database username and password -->
    <user>jabberd2</user>
    <pass>secret</pass>
 
    <!-- Transaction support. If this is commented out, transactions
         will be disabled. This might make database accesses faster,
         but data may be lost if jabberd crashes. -->
    <transactions/>
  </pgsql>

Vous ne devez changer le champ host que si votre base de données ne se trouve pas sur la même machine que le serveur jabberd2. Si vous n'utilisez pas le port par défaut de PostgreSQL (5432), vous devez modifier le champ port.

Jabberd2 est maintenant configurer pour stocker ses informations dans une base PostgreSQL.

Il reste à configurer l'authentification. On peut recourir à d'autres solutions que PostgreSQL pour cela (PAM ou OpenLDAP), mais cela dépasse mais compétence.

Dans c2s.xml sous la section Authentication/registration database configuration, modifiez le champ module avec la valeur pgsql (PostgreSQL):

gksudo gedit /etc/jabberd2/c2s.xml

  <!-- Authentication/registration database configuration -->
  <authreg>
    <!-- Backend module to use -->
    <module>pgsql</module>      

Toujours dans c2s.xml, dans la section PostgreSQL module configuration, remplacez secret avec le mot de passe de l'utilisateur jabberd2 de PostgreSQL. Changez le nom de l'utilisateur et/ou de la base si vous n'utilisez pas ceux par défaut (jabberd2 et jabberd2) :

  <!-- PostgreSQL module configuration -->
  <pgsql>
    <!-- Database server host and port -->
    <host>localhost</host>
    <port>5432</port>
 
    <!-- Database name -->
    <dbname>jabberd2</dbname>
 
    <!-- Database username and password -->
    <user>jabberd2</user>
    <pass>secret</pass>
  </pgsql>

Vous ne devez changer le champ host que si votre base de données ne se trouve pas sur la même machine que le serveur jabberd2. Si vous n'utilisez pas le port par défaut de PostgreSQL (5432), vous devez modifier le champ port.

Jabberd2 est maintenant configurer. Il ne vous reste plus qu'à tester votre installation.

A faire – je n'utilise pas Mysql et ne me sens donc pas à l'aise dans l'adaptation de la documentation de jabberd2, si une bonne âme passe par ici…

Le serveur jabberd2 étant lancé dès l'installation du paquet, il faut redémarrer celui-ci afin de prendre en compte les étapes précédente :

sudo /etc/init.d/jabberd2 restart

Ensuite configurez un client jabber (gaim par exemple) depuis une machine du réseau local pour vous connecter à votre serveur jabberd2. Si ça ne marche pas, bonne chance ! Allez tout de même jetter un coup d'oeuil dans les logs (/var/log/jabberd2/).

Si cette opération réussit et que vous voulez que votre serveur soit accessible depuis internet, recommencez l'opération depuis une machine extérieure à votre réseau.