Editing Eng:J2J:AdminGuide

{{EnglishVersion|J2J:AdminGuide}}
Installation and operation guide for [[J2J|J2J (Jabber-to-Jabber)]] [[gateway]].

== Installation and configuring ==

=== Dependencies ===

For J2J you will need:
* [[Python]] >=2.3
* [http://www.postgresql.org/ PostgreSQL] >=7.4.7
* [http://www.pygresql.org/ PyGreSQL] >=3.8
* [[Twisted]] >=2.4.0
* [[Zope]]
* Any Jabber-[[server]] (for example, [[ejabberd]] or [[Wildfire]]), that supports:
** {{xep|0114|Jabber Component Protocol}}
** [[Service Discovery|XEP-0030: Service Discovery]]

=== Source code downloads ===
You need to get sources of [[J2J]]. You can do it at [http://jrudevels.org/index.php?pg=downloads.php&dir=J2J JRuDevels Downloads], or with help of [http://subversion.tigris.org/ SVN]:

 <nowiki>svn co https://svn.jrudevels.org/j2j/trunk j2j/</nowiki>

=== Database setup ===

You need to setup a database to work with [[J2J]]:

Let's create a DB user:
 createuser -P j2j

A -P key means, that user is created with a password-prompt. Store it, because it will be needed for next steps.

Let's create a database for [[J2J]]:
 createdb j2j

And import a database structure:

 psql -U j2j j2j
 \i pgsql.schema

=== Gateway configuration ===

Configuration file config.py is needed for [[J2J]]. Let's copy example of this and edit it:
 cp config.py.example config.py
 nano -w config.py

Parameters:
* JID - JID of gateway. For example, 
 JID=u"j2j.server.com"
* HOST - IP or domain-name of your Jabber-server. For example,
 HOST="127.0.0.1"
* PORT - port on Jabber-server to which J2J will be connected. It must be the same as it specified in your Jabber-server's configuration.
* DB_HOST - IP or Domain-name of your database server.
* DB_USER - Database username (in our example is j2j)
* DB_NAME - Database name (in our example is j2j)
* DB_PASS - Password for this database username.
* DB_PREFIX - pass it as is.
* ADMINS - a list of [[JID]]s, for a notifications of new users registrations. For example,
 ADMINS=[u"vasya@server.ru",u"zhenya@server.com"]

=== Running ===

Let's start the gateway:
 python main.py

[[Category:Documentation]]
[[Category:English]]