Difference between revisions of "Eng:J2J:AdminGuide"
From JaWiki (Jabber/XMPP wiki)
(→Dependencies: new twisted version) |
m (links fixed Eng:J2J) |
||
| Line 1: | Line 1: | ||
{{EnglishVersion|J2J:AdminGuide}} | {{EnglishVersion|J2J:AdminGuide}} | ||
| − | Installation and operation guide for [[J2J|J2J (Jabber-to-Jabber) | + | Installation and operation guide for [[Eng:J2J|J2J]] (Jabber-to-Jabber) [[gateway]]. |
== Installation and configuring == | == Installation and configuring == | ||
| Line 16: | Line 16: | ||
=== Source code downloads === | === 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]: | + | 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> | <nowiki>svn co https://svn.jrudevels.org/j2j/trunk j2j/</nowiki> | ||
| Line 22: | Line 22: | ||
=== Database setup === | === Database setup === | ||
| − | You need to setup a database to work with [[J2J]]: | + | You need to setup a database to work with [[Eng:J2J|J2J]]: |
Let's create a DB user: | Let's create a DB user: | ||
| Line 29: | Line 29: | ||
A -P key means, that user is created with a password-prompt. Store it, because it will be needed for next steps. | 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]]: | + | Let's create a database for [[Eng:J2J|J2J]]: |
createdb j2j | createdb j2j | ||
| Line 39: | Line 39: | ||
=== Gateway configuration === | === 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: | + | 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 | cp j2j.conf.example j2j.conf | ||
nano -w j2j.conf | nano -w j2j.conf | ||
| Line 71: | Line 71: | ||
=== Command line options === | === Command line options === | ||
| − | Start J2J with the --help key for get the help on command-line options. | + | Start [[Eng:J2J|J2J]] with the --help key for get the help on command-line options. |
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:English]] | [[Category:English]] | ||
Revision as of 20:42, 22 April 2008
Эта страница доступна в версии на русском языке.
This page is also available in Russian.
Pages in English • Translated pages • Pages that have an english versionInstallation and operation guide for J2J (Jabber-to-Jabber) gateway.
Contents
Installation and configuring
Dependencies
For J2J you will need:
- Python >=2.3
- PostgreSQL >=7.4.7
- PyGreSQL >=3.8
- Twisted >=8.0.1
- Any Jabber-server (for example, ejabberd or Openfire), that supports:
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.
