Difference between revisions of "Eng:J2J:AdminGuide"

Revision as of 10:43, 2 June 2007

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

Installation and configuring

Dependencies

For J2J you will need:

• Python >=2.3
• PostgreSQL >=7.4.7
• PyGreSQL >=3.8
• Twisted >=2.4.0
• Any Jabber-server (for example, ejabberd or Wildfire), that supports:
  • XEP-0114: Jabber Component Protocol
  • XEP-0030: Service Discovery

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

Настройка компонента

Необходимо получить конфигурационный файл для компонента с именем config.py. Для этого скопируем пример такого файла и отредактируем его:

cp config.py.example config.py
nano -w config.py

Параметры:

• JID - JID компоненты. Например,

JID=u"j2j.server.com"

• HOST - IP или доменное имя сервера, к которому необходимо присоединить компонент. Например,

HOST="127.0.0.1"

• PORT - порт на сервере, к которому необходимо подключаться. Должен совпадать с аналогичным, прописанным в конфигурации Вашего Jabber-сервера.
• DB_HOST - IP или доменное имя сервера БД.
• DB_USER - имя пользователя БД (в нашем примере - j2j)
• DB_NAME - имя базы данных (в нашем примере - j2j)
• DB_PASS - пароль от БД для данного пользователя БД.
• DB_PREFIX - в общем случае остается без изменений.
• ADMINS - список JIDов, на которые будут приходить уведомления о новых регистрациях. Пример:

ADMINS=[u"vasya@server.ru",u"zhenya@server.com"]

Запуск

Теперь все готово к запуску:

python main.py

Администрирование транспорта