Files @ 8fbdd54451c0
Branch filter:

Location: libtransport.git/docs/guide/configure_xmpp_server.textile

Vitaly Takmazov
Added curl 7.28.1 as MSVC dependency

To use Spectrum 2 in gateway mode, you have to configure your XMPP server to work with your Spectrum 2 instances.
The configuration details you give to your XMPP server of course have to correspond to the details you give in the Spectrum 2 configuration file.

h2. DNS records configuration

For every Spectrum 2 instance you have to create a nameserver record for the transport's Jabber ID, if you want users of other servers to connect to your transport. A SRV record for "server to server" connections like in the following example is preferred:

<pre>
_xmpp-server._tcp.j2j.example.com. IN SRV 0 5 5269 jabber.example.com.
</pre>

Otherwise you could set an A level record for the JID of your instances.

See also: "http://prosody.im/doc/dns":http://prosody.im/doc/dns

h2. Ejabberd

In the Ejabberd configuration file (by default in /etc/ejabberd/ejabberd.cfg), you have to add a field to the "listen" directive. 

In the section that says: ‘{listen,’ add these lines:

<pre>
{{5347, "127.0.0.1"}, ejabberd_service, [
                                        {access, all},
                                        {host, "icq.example.com", [{password, "secret"}]}
]}
</pre>

* @5347@ is port on which Ejabberd will listen for Spectrum 2 so Spectrum 2 can connect this port and start serving the hostname you've configured. Each Spectrum 2 instance has to be connected to different port.
* "@icq.example.com@" is the hostname of your Spectrum 2 transport.
* "@secret@" is the password which will be used by Spectrum 2 to authenticate itself to the Ejabberd server.
* "@{access, all}@" lets everybody use your transport. 

To use the new settings, you can either just restart Ejabberd or use Ejabberd's web-interface to add the new port to the running instance. You can find the Settings under Nodes -> <your node> -> Listened Ports. For full information on how to add external components (like Spectrum 2) to your Ejabberd installation, also refer to the "Ejabberd guide":http://www.process-one.net/en/ejabberd/guide_en.

h2. Prosody

In the prosody configuration file (normally in /etc/prosody/prosody.cfg.lua) there is configuration line for components.

It looks like this:

<pre>
--Component "gateway.example.com"
--      component_secret = "password"
</pre>

You have to edit this line to make Spectrum 2 work:

Example: ICQ

<pre>
Component "icq.example.com"
     component_secret = "mysecreticqpassword"
</pre>
 
For every spectrum transport you want to use, you have to add those two lines:

Example:

<pre>
Component "icq.example.com"
     component_secret = "mysecreticqpassword"

Component "msn.example.com"
     component_secret = "mysecretmsnpassword"

Component "yahoo.example.com"
     component_secret = "mysecretyahoopassword"
</pre>

Save the file and restart your Prosody server.