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]] >=2.4.0 |
− | + | * Any Jabber-[[server]] (for example, [[ejabberd]] or [[Wildfire]]), 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 config.py is needed for [[J2J]]. Let's copy example of this and edit it: |
− | cp | + | cp config.py.example config.py |
− | nano -w | + | nano -w config.py |
Parameters: | Parameters: | ||
− | + | * JID - JID of gateway. For example, | |
− | + | JID=u"j2j.server.com" | |
− | 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. | |
− | * | + | * 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 === | === Running === | ||
Line 78: | Line 61: | ||
Let's start the gateway: | Let's start the gateway: | ||
python main.py | python main.py | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:English]] | [[Category:English]] |