Editing Eng:J2J:AdminGuide
From JaWiki (Jabber/XMPP wiki)
Warning: The database has been locked for maintenance, so you will not be able to save your edits right now. You may wish to copy and paste your text into a text file and save it for later.
The administrator who locked it offered this explanation: MediaWiki upgrading
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
{{EnglishVersion|J2J:AdminGuide}} | {{EnglishVersion|J2J:AdminGuide}} | ||
− | Installation and operation guide for [[ | + | Installation and operation guide for [[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://www.postgresql.org/ PostgreSQL] >=7.4.7 | |
− | * [http://www.postgresql.org/ PostgreSQL] >= | + | |
* [http://www.pygresql.org/ PyGreSQL] >=3.8 | * [http://www.pygresql.org/ PyGreSQL] >=3.8 | ||
− | * [ | + | * [[Twisted]] >=8.0.1 |
− | + | * Any Jabber-[[server]] (for example, [[ejabberd]] or [[Openfire]]), that supports: | |
− | + | ||
− | * Any Jabber-server (for example ejabberd | + | |
** {{xep|0114|Jabber Component Protocol}} | ** {{xep|0114|Jabber Component Protocol}} | ||
− | ** | + | ** [[Service Discovery|XEP-0030: Service Discovery]] |
=== Source code downloads === | === Source code downloads === | ||
− | You need to get sources of [[ | + | 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 | + | <nowiki>svn co https://svn.jrudevels.org/j2j/trunk j2j/</nowiki> |
=== Database setup === | === Database setup === | ||
− | You need to setup a database to work with [[ | + | You need to setup a database to work with [[J2J]]: |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
Let's create a DB user: | Let's create a DB user: | ||
− | |||
createuser -P j2j | 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. | + | |
− | + | 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: | And import a database structure: | ||
− | + | ||
psql -U j2j j2j | psql -U j2j j2j | ||
\i pgsql.schema | \i pgsql.schema | ||
− | |||
− | |||
=== Gateway configuration === | === Gateway configuration === | ||
− | Configuration file is needed for [[ | + | 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 | cp j2j.conf.example j2j.conf | ||
nano -w j2j.conf | nano -w j2j.conf | ||
Line 69: | Line 59: | ||
** Prefix - pass it as is. | ** Prefix - pass it as is. | ||
* Section admins | * Section admins | ||
− | ** List - a list of | + | ** List - a list of [[JID]]s, 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 | ||
Line 78: | Line 68: | ||
Let's start the gateway: | Let's start the gateway: | ||
python main.py | python main.py | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Command line options === | === Command line options === | ||
− | Start | + | Start J2J with the --help key for get the help on command-line options. |
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:English]] | [[Category:English]] |