Editing Eng:J2J:AdminGuide

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

== Installation and configuring ==

=== Dependencies ===

For J2J you will need:
* [http://python.org Python] >=2.3
* [http://twistedmatrix.com/ Twisted] >=8.0.1
* [http://www.postgresql.org/ PostgreSQL] >=7.4.7
* [http://www.pygresql.org/ PyGreSQL] >=3.8
(Note: there is experimental mysql support in 1.1.8, see Changelog.txt)

* Any Jabber-server (for example ejabberd, jabberd2 or Openfire), that supports:
** {{xep|0114|Jabber Component Protocol}}
** {{xep|0030|Service Discovery}}

=== Source code downloads ===
You need to get sources of [[Eng:J2J|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 [[Eng:J2J|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 [[Eng:J2J|J2J]]:
 createdb j2j

And import a database structure:

 psql -U j2j j2j
 \i pgsql.schema

=== Gateway configuration ===

Configuration file is needed for [[Eng:J2J|J2J]]. Default search paths for it is: ./j2j.conf, ~/.j2j/j2j.conf, /etc/j2j/j2j.conf. Let's copy example of this and edit it:
 cp j2j.conf.example j2j.conf
 nano -w j2j.conf

Parameters:
* Section component
** JID - JID of gateway. For example, 
 JID=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.
** Password - password on Jabber-server to which J2J will be connected.
* Section database
** Host - IP or Domain-name of your database server. Leave it blank to use postgres' UNIX-socket.
** Type - Type of your database server: postgres or mysql
** User - Database username (in our example is j2j)
** Name - Database name (in our example is j2j)
** Password - Password for this database username.
** Prefix - pass it as is.
* Section admins
** List - a list of JIDs, for a notifications of new users registrations. For example,
 List=vasya@server.ru,zhenya@server.com
* Section debug
** Pass it as is. If you will get errors in J2J's work try to turn on logging in it section.

=== Running ===

Let's start the gateway:
 python main.py

=== Command line options ===

Start [[Eng:J2J|J2J]] with the --help key for get the help on command-line options.

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