Ce document décrit les principales fonctionnalités et modifications apportés à ejabberd, dans sa version 0.9, comparativement à la dernière version publique, ejabberd 0.7.5.
Le code peut être téléchargé depuis la page de téléchargement.
Pour plus d'informations, référez-vous au Guide Utilisateur d'ejabberd (en anglais).
Hébergement virtuel - « Virtual Hosting »
ejabberd peut dorénavent hébergement plusieurs domaines dans la même instance. Si vous ne comptez pas utiliser les nouvelles fonctionnalités de la version 0.9 d'ejabberd, vous pouvez conserver le fichier de configuration d'ejabberd 0.7.5 en l'état. Ce fichier est compatible avec la nouvelle version.
Cette option est activée par l'utilisation de la directive
{hosts, ["erlang-projects.org", "erlang-fr.org"]}.
en remplacement de l'ancienne directive « host ».
Notez bien que vous précisez maintenant une liste. Le domaine principal sera le premier listé. Référez-vous à la section Migration un peu plus bas pour plus de détails.
Nom (name): l'identifiant JID complet de l'administrateur de ce serveur. Vous pouvez accorder les droits d'administrateur à un compte Jabber dans le fichier ejabberd.cfg.
Mot de passe (password): Le mot de passe pour ce compte Jabber.
Liste de contacts partagés - « Shared rosters »
Les listes de contacts partagés forment une nouvelle fonctionalité qui permet aux administrateurs d'ejabberd d'ajouter des utilisateurs jabber qui seront présents dans le roster de tous les utilisateurs du server.
Pour activer cette fonctionnalité, suivez les étapes suivantes:
- Ajoutez la directive {mod_shared_roster, []} à la fin de votre liste de modules de votre fichier ejabberd.cfg.
- Redémarrez ejabberd.
- Allez sur l'interface d'administration Web. Si le module est correctement activé, un nouveau lien 'Shared Roster' doit apparaître. Normalement, l'URL doit être: http://localhost:5280/admin/shared-roster/
- Créez un nouveau groupe avec un identifiant (par exemple: test).
- Le groupe va être ajouté à la liste des groupes. Cliquez dessus.
- Vous pouvez alors configurer ce groupe au travers du formulaire:
- Nom (name): Il s'agit du nom du groupe dans la liste de contact de l'utilisateur (par exemple: Groupe de test).
- Description: Brève description du groupe (par exemple: Ce groupe est juste un test).
- Membres (members): Liste des membres du groupe, avec un identifiant Jabber (JID) par ligne. Par exemple:
user1@localhost
user2@localhost
user3@localhost - Groupes affichés (displayed Groups): Saisissez ici l'identifiant du groupe (par exemple: test).
- Connectez-vous avec votre client Jabber habituel, avec un des utilisateurs définis dans le groupe. L'utilisateur doit alors avoir un groupe virtuel contenant tous les membres de ce groupe.
Support de PostgreSQL (ODBC)
Cette fonctionnalité est actuellement expérimentale, et n'est pas totalement documentée. Cette option est présentée à des fins de tests.
Vous devez avoir Erlang/OTP R10, compilé avec ODBC sur les différentes version *nix. De préférence, utilisez Erlang/OTP R10B-4, car le support d'ODBC est devenu plus simple avec cette version, et est compilée par défaut sur la version installable sous Windows.
Le support de PostgreSQL est activée en ajoutant le module suivant dans le fichier de configuration ejabberd.cfg, en remplacement de leurs versions standards :
- mod_last_odbc.erl
- mod_offline_odbc.erl
- mod_roster_odbc.erl
Le schéma de la base de données est situé dans le fichier src/odbc/pq.sql
Reportez-vous au fichier d'exemple src/ejabberd.cfg.example pour plus d'informations sur la configuration d'ejabberd avec le support ODBC, avec différentes bases de données.
Migration depuis ejabberd 0.7.5
La migration est relativement simple, la conversion du schema Mnesia s'effectuant automatiquement. Il est important toutefois de bien penser à effectuer une sauvegarde de votre base avant toute interventions sur celle-ci.
Voici les différentes étapes à suivre :
- Arrêtez votre instance d'ejabberd.
- Dans le fichier de configuration ejabberd.cfg, définissez votre
liste de domaines (host list). Remplacez la direction host
par la nouvelle directive hosts.
Avant : {host, "erlang-projects.org"}.
Après : {hosts, ["erlang-projects.org", "erlang-fr.org"]}.
Note : lorsque vous redémarrerez votre serveur, les utilisateurs existants seront affectés au premier domaine de la liste. Vous devriez donc placer en premier l'ancien domaine de la directive « host ». - Redémarrez ejabberd.
Correctifs
Cette version contient plusieurs correctifs et changements d'architecture. Référez-vous au fichier Changelog fournit avec cette version pour plus d'informations.
