Difference between revisions of "Eng:J2J:AdminGuide"

From JaWiki (Jabber/XMPP wiki)
Jump to: navigation, search
m (links fixed Eng:J2J)
m (Links removed)
Line 1: Line 1:
 
{{EnglishVersion|J2J:AdminGuide}}
 
{{EnglishVersion|J2J:AdminGuide}}
Installation and operation guide for [[Eng:J2J|J2J]] (Jabber-to-Jabber) [[gateway]].
+
Installation and operation guide for [[Eng:J2J|J2J]] (Jabber-to-Jabber) gateway.
  
 
== Installation and configuring ==
 
== Installation and configuring ==
Line 7: Line 7:
  
 
For J2J you will need:
 
For J2J you will need:
* [[Python]] >=2.3
+
* [http://python.org Python] >=2.3
 
* [http://www.postgresql.org/ PostgreSQL] >=7.4.7
 
* [http://www.postgresql.org/ PostgreSQL] >=7.4.7
 
* [http://www.pygresql.org/ PyGreSQL] >=3.8
 
* [http://www.pygresql.org/ PyGreSQL] >=3.8
* [[Twisted]] >=8.0.1
+
* [http://twistedmatrix.com/ Twisted] >=8.0.1
* Any Jabber-[[server]] (for example, [[ejabberd]] or [[Openfire]]), that supports:
+
* Any Jabber-server (for example, ejabberd or Openfire), that supports:
 
** {{xep|0114|Jabber Component Protocol}}
 
** {{xep|0114|Jabber Component Protocol}}
** [[Service Discovery|XEP-0030: Service Discovery]]
+
** {{xep|0030|Service Discovery}}
  
 
=== Source code downloads ===
 
=== Source code downloads ===
Line 59: Line 59:
 
** Prefix - pass it as is.
 
** Prefix - pass it as is.
 
* Section admins
 
* Section admins
** List - a list of [[JID]]s, for a notifications of new users registrations. For example,
+
** List - a list of JIDs, for a notifications of new users registrations. For example,
 
  List=vasya@server.ru,zhenya@server.com
 
  List=vasya@server.ru,zhenya@server.com
 
* Section debug
 
* Section debug

Revision as of 23:07, 24 April 2008

Эта страница доступна в версии на русском языке.

This page is also available in Russian.

Pages in EnglishTranslated pagesPages that have an english version

Installation and operation guide for J2J (Jabber-to-Jabber) gateway.

Installation and configuring

Dependencies

For J2J you will need:

Source code downloads

You need to get sources of J2J. You can do it at JRuDevels Downloads, or with help of SVN:

svn co https://svn.jrudevels.org/j2j/trunk j2j/

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 is needed for 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 J2J with the --help key for get the help on command-line options.