This tutorial explains how to install jGGtrans, a Gadu-Gadu transport for XMPP.

1. Install the Transport

   • Debian

     Add the following repository containing jGGtrans to /etc/apt/sources.list:

     echo "deb http://www.kofeina.net/eloy/debian/ ./" >> /etc/apt/sources.list

     After an update, you can download and install jGGtrans:

     apt-get update
     apt-get install jabber-gg-transport

   • FreeBSD

     Install jGGtrans and select the option 'EJABBERD':

     cd /usr/ports/net-im/jggtrans && make all install clean

2. Install the Transport Configuration File

   • Debian

     1. Download this configuration file for jGGtrans and put it into /etc/jabber/

     2. Open this configuration file with your favourite text editor and change at least the following capitalized values:

        SERVER.COM
        SECRET
        GG_TRANSPORT_ADMIN@SERVER.COM

     3. Edit /etc/default/jabber-gg-transport with your favourite text editor. That file should contain next line:

        DAEMON_OPTS="/etc/jabber/jabber-gg-transport.xml"

   • FreeBSD

     1. Copy the sample configuration to the right location:

        cp /usr/local/etc/jggtrans.xml.sample /usr/local/etc/jggtrans.xml

     2. Open this configuration file with your favourite text editor and change the following values:

        <service jid="gg.SERVER.COM"/>
        <connect>
         <port>5237</port> <!--in this tutorial '5237'-->
         <secret>SECRET</secret> <!--kind of a 'transport password'-->
        </connect>
        <admin>GG_TRANSPORT_ADMIN@SERVER.COM</admin> <!--should not match ejabberd admin-->
        <spool>/var/lib/jabber/spool/gg.SERVER.COM/</spool>

3. Directories

   • Debian

     Create some directories:

     mkdir /var/spool/jabber/gg.SERVER.COM/ \
     /etc/jabber /etc/init.d/jabber /var/log/jabber \
     /var/run/jabber /var/spool/jabber
     chmod o-rx /var/log/jabber/

     And set permissions:

     chmod 770 /var/spool/jabber/gg.SERVER.COM/
     chgrp daemon /var/spool/jabber/gg.SERVER.COM/ \
     /var/log/jabber/ /var/run/jabber /var/spool/jabber

     Do not forget to replace "SERVER.COM" with what you specified in jabber-gg-transport.xml.

   • FreeBSD

     Create some directories:

     mkdir -p /var/lib/jabber/spool/gg.SERVER.COM/

     And set permissions:

     chown -R ejabberd /var/lib/jabber/

4. Configure ejabberd

   These instructions assume you are running the transport on the same machine as ejabberd. To configure ejabberd, you can choose between two methods. Do not forget to change the capitalized values; they need to match to what you specified in jGGtrans' configuration file above.

   • Using the Web Administration Interface

     Go in the web interface to Nodes/your node/Listened Ports, enter the following information on the last line, and press the Add button:

     Port	Module	Options
     5237	ejabberd_service	[{host, "gg.SERVER.COM", [{password, "SECRET"}]}]

   • Using ejabberd.cfg

     Edit ejabberd's configuration file; add the following two lines in the section starting with '{listen,' (also described in the guide). You have to restart ejabberd afterwards to apply the changes:

     {5237, ejabberd_service, [{host, "gg.SERVER.COM",
                                [{password, "SECRET"}]}]},

     Remark that there is no ending comma needed in the last entry. However, all entries before the last one need to end with a comma!

5. Start jGGtrans

   To start jGGtrans:

   • Debian

     /etc/init.d/jabber-gg-transport start

   • FreeBSD

     Add the following line to /etc/rc.conf:

     jggtrans_enable="YES"

     And then start jGGtrans:

     /usr/local/etc/rc.d/jggtrans start