Updated 7 March 2019
XMPP (Extensible Messaging and Presence Protocol, previously known as Jabber) is an XML-based, open, easy-to-use protocol for instant messaging and near real-time status information. User accounts and groups are stored on the server, and is used as a XMPP server. The necessary software is included with [Calculate Directory Server] (cds).
Calculate Utilities store user accounts and groups on a OpenLDAP server. First configure the LDAP service according to the manual.
Jabber server configuration
First install your Jabber service:
* WARNING: Running this program will modify the configuration files of the Jabber service (Ejabberd). If you want to continue, enter 'yes', else enter 'no': yes Enter password for firstname.lastname@example.org New password: Repeat new password: * User added to Jabber service * Added ldif file ... [ ok ] * Starting Ejabberd ... [ ok ] * Jabber service configured ... [ ok ]
Once completed, Jabber will be configured with default settings. The hostname of the Jabber service will be the hostname of the computer.
To specify additional Jabber hosts, use the parameter.
While setting up the service, enter the password for the account.
Each user on the network has a unique identifier, a Jabber ID, or . Like the email, a JID address contains the user name and the domain name of the server on which the user is registered, separated by the
@ sign. For example, a user registered on example.org will have the following JID address: email@example.com.
To add a Jabber account, use the
To add a user nicknamed
Guest , firstname.lastname@example.org, run:
New password: Repeat new password: * User added to Jabber service
To add user
email@example.com with nickname Guest~ and set a photo for them, run the following:
cl-useradd -p -c "Guest" -i pic/guest.png guest jabber
Supported image formats are determined by the functionality of ImageMagick. If it is not in the system, only the jpeg format will be available.
To change the password of a Jabber account, use
cl-passwd. For instance, to change the password for
New password: Repeat new password: * Password of Jabber user modified
To lock a user account, use
cl-usermod -L. For instance, to lock
* User guest of Jabber service locked
To unlock an account, run
cl-usermod -U. For instance, to unlock
* User guest of Jabber service unlocked
To remove an account from Jabber, run
cl-userdel. For instance, to remove
* User guest of Jabber service removed
A group is a set of used to send messages to several users at the same time. When a user connects to Jabber, they will automatically receive a list of groups and their members. Users without groups have to be added manually to the contact list. Each user can only belong to one group.
To create a Jabber group, use the
cl-groupadd command. For instance, to create a group named
"Testing Group", run:
* Group 'Testing Group' added to Jabber service
To rename an existing Jabber group, use
cl-groupmod. For example, to rename 'Testing Group' to 'My Test', run as follows:
* Group renamed to My Test
To manage a Jabber group, use the
cl-usermod commands. To add user
guest to group 'Guest Group', run
cl-usermod as shown below:
* User group modified
To remove user
guest from group 'Guest Group', run:
* Users removed from group Guest Group
To add users
guest and guest2 to 'Guest group', run:
* Users added to group Guest Group
If you have more than one network interface on your server while working on only one of them, add the corresponding
ip directive to : "192.168.0.2" to the section:
... listen: - port: 5223 module: ejabberd_c2s max_stanza_size: 65536 tls: true ip: "192.168.0.2" certfile: "/etc/jabber/ssl.pem" shaper: c2s_shaper access: c2s ...