Editing Eng:J2J:AdminGuide

From JaWiki (Jabber/XMPP wiki)
Jump to: navigation, search

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 8: Line 8:
 
For J2J you will need:
 
For J2J you will need:
 
* [http://python.org Python] >=2.3
 
* [http://python.org Python] >=2.3
−
* [http://twistedmatrix.com/ Twisted] >=10.2.0 (patch http://twistedmatrix.com/trac/attachment/ticket/4771/twisted-ticket-4771.patch is needed for 10.2.0)
+
* [http://www.postgresql.org/ PostgreSQL] >=7.4.7
−
* [http://www.postgresql.org/ PostgreSQL] >=8.2
+
 
* [http://www.pygresql.org/ PyGreSQL] >=3.8
 
* [http://www.pygresql.org/ PyGreSQL] >=3.8
−
* [http://pyopenssl.sourceforge.net/ PyOpenSSL] >=0.6
+
* [http://twistedmatrix.com/ Twisted] >=8.0.1
−
(Note: there is experimental [http://www.mysql.com/ Mysql] with [http://mysql-python.sourceforge.net/ mysql-python] support in 1.1.8 and beyond, see Changelog.txt)
+
−
 
+
 
* Any Jabber-server (for example ejabberd, jabberd2 or Openfire), that supports:
 
* Any Jabber-server (for example ejabberd, jabberd2 or Openfire), that supports:
 
** {{xep|0114|Jabber Component Protocol}}
 
** {{xep|0114|Jabber Component Protocol}}
Line 21: Line 18:
 
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]:
 
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 svn://svn.jrudevels.org/j2j/trunk j2j/</nowiki>
+
  <nowiki>svn co https://svn.jrudevels.org/j2j/trunk j2j/</nowiki>
  
 
=== Database setup ===
 
=== Database setup ===
  
 
You need to setup a database to work with [[Eng:J2J|J2J]]:
 
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]]:
 
Let's create a database for [[Eng:J2J|J2J]]:
−
* postgresql:
 
 
  createdb j2j
 
  createdb j2j
−
* mysql
 
−
mysql -h localhost -u root -p -e "CREATE DATABASE j2j;"
 
  
−
Let's create a DB user:
+
And import a database structure:
−
* postgresql:
+
−
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. Same with yourpassword in mysql:
+
−
* mysql:
+
−
mysql -h localhost -u root -p -e "GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP ON j2j.* TO 'j2j'@'localhost' IDENTIFIED BY 'yourpassword';"
+
  
−
And import a database structure:
 
−
* postgresql:
 
 
  psql -U j2j j2j
 
  psql -U j2j j2j
 
  \i pgsql.schema
 
  \i pgsql.schema
−
* mysql
 
−
mysql -h localhost -u root -p -e "use j2j; \. mysql.schema"
 
  
 
=== Gateway configuration ===
 
=== Gateway configuration ===
  
−
Configuration file is needed for [[Eng:J2J|J2J]]. Default search paths for it is: ./j2j.conf, ~/.j2j/j2j.conf and /etc/j2j/j2j.conf; also you can use "-c /path/j2j.conf" in main.py, see later. 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 78: Line 68:
 
Let's start the gateway:
 
Let's start the gateway:
 
  python main.py
 
  python main.py
−
it should spit "Connected", see also your jabber server log.
 
−
 
−
=== Problems ===
 
−
* If you see:
 
−
<nowiki>Exception exceptions.AttributeError: "database instance has no attribute 'dbCursor'" in <bound method
 
−
database.__del__ of <database.database instance at 0x85f1bec>> ignored</nowiki>
 
−
Check if you have installed python db access support ( i.e. python-pygresql, python-mysqldb in debian) and if it is up to date. Otherwise, is postgresql/mysql rdbms accesible with the parameters in [database] section in your j2j.conf? is it up?
 
−
* If you see :
 
−
Traceback (most recent call last):
 
−
  File "/usr/src//j2j/main.py", line 11, in ?
 
−
    import j2j
 
−
  File "/usr/src/j2j/j2j.py", line 14, in ?
 
−
    from client import Client
 
−
  File "/usr/src/j2j/client.py", line 10, in ?
 
−
    from twisted.names.error import DNSNameError
 
−
ImportError: No module named error
 
−
 
−
In debian etch twisted is too old: required twisted 8.01 is in etch+1; ubuntu 8.04 is ok too.
 
−
And with FreeBSD you need also py-twistedNames, it's not installed with twisted.
 
−
 
−
* Sometimes main.py doesn't spit nothing, check your jabber server log, maybe there is an authentication password problem so recheck [component] section in j2j.conf
 
−
* In j2j.conf are declared some paths to log files, do these files exist? do they have write permissions?
 
  
 
=== Command line options ===
 
=== Command line options ===
  
−
Start [[Eng:J2J|J2J]] with the --help key to get help about 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]]

Please note that all contributions to JaWiki (Jabber/XMPP wiki) may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see JaWiki (Jabber/XMPP wiki):Copyrights for details). Do not submit copyrighted work without permission!

Cancel | Editing help (opens in new window)

Templates used on this page:

Retrieved from "http://jawiki.jrudevels.org/Eng:J2J:AdminGuide"