Editing 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 1: Line 1:
 
{{eng}}
 
{{eng}}
−
Руководство по установке и администрированию [[gateway|транспорта]] [[J2J|J2J (Jabber-to-Jabber)]].
+
Руководство по установке и администрированию [[gateway|транспорта]] [[J2J|J2J (Jabber-to-Jabber)]].
−
 
+
−
Руководство пользователя находится на [[J2J|следующей странице]].
+
  
 
== Установка и настройка ==
 
== Установка и настройка ==
Line 10: Line 8:
 
Для работы J2J необходимо:
 
Для работы J2J необходимо:
 
* [[Python]] >=2.3
 
* [[Python]] >=2.3
−
* [http://www.postgresql.org/ PostgreSQL] >=8.2
+
* [http://www.postgresql.org/ PostgreSQL] >=7.4.7
 
* [http://www.pygresql.org/ PyGreSQL] >=3.8
 
* [http://www.pygresql.org/ PyGreSQL] >=3.8
−
* [[Twisted]] >=10.2.0 (необходимо наложить патч http://twistedmatrix.com/trac/attachment/ticket/4771/twisted-ticket-4771.patch)
+
* [[Twisted]] >=2.4.0
−
* [http://pyopenssl.sourceforge.net/ PyOpenSSL] >=0.6
+
 
* Любой Jabber-[[server]] (например, [[ejabberd]] или [[Openfire]]), поддерживающий:
 
* Любой Jabber-[[server]] (например, [[ejabberd]] или [[Openfire]]), поддерживающий:
 
** {{xep|0114|Jabber Component Protocol}}
 
** {{xep|0114|Jabber Component Protocol}}
Line 22: Line 19:
 
Необходимо получить исходный код транспорта. Это можно сделать, пройдя по [http://jrudevels.org/index.php?pg=downloads.php&dir=J2J ссылке], либо с помощью [http://subversion.tigris.org/ SVN]:
 
Необходимо получить исходный код транспорта. Это можно сделать, пройдя по [http://jrudevels.org/index.php?pg=downloads.php&dir=J2J ссылке], либо с помощью [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>
  
 
=== Настройка базы данных ===
 
=== Настройка базы данных ===
Line 40: Line 37:
 
  psql -U j2j j2j
 
  psql -U j2j j2j
 
  \i pgsql.schema
 
  \i pgsql.schema
−
 
−
=== Настройка Jabber-сервера ===
 
−
 
−
==== ejabberd ====
 
−
Вся настройка сводится к добавлению строки вида:
 
−
 
−
{8888, ejabberd_service, [
 
−
                        {ip, {127, 0, 0, 1}},
 
−
                        {access, all},
 
−
                        {shaper_rule, fast},
 
−
                        {host, "j2j.server.com",
 
−
                        [{password, "secret"}]}
 
−
                        ]}
 
−
 
−
В секцию listen файла ejabberd.cfg.
 
−
Обратите внимание, при указании JID транспорта используется ключевое слово host, а не hosts.
 
−
Замените JID и пароль на свои.
 
  
 
=== Настройка компонента ===
 
=== Настройка компонента ===
  
−
Необходимо получить конфигурационный файл для компонента. По умолчанию, пути поиска для конфигурационного файла - ./j2j.conf, ~/.j2j/j2j.conf, /etc/j2j/j2j.conf. Для этого скопируем пример такого файла и отредактируем его:
+
Необходимо получить конфигурационный файл для компонента с именем config.py. Для этого скопируем пример такого файла и отредактируем его:
−
  cp j2j.conf.example j2j.conf
+
  cp config.py.example config.py
−
  nano -w j2j.conf
+
  nano -w config.py
  
 
Параметры:
 
Параметры:
−
* Секция component:
+
* JID - JID компоненты. Например,  
−
** JID - JID компоненты. Например,  
+
 
  JID=u"j2j.server.com"
 
  JID=u"j2j.server.com"
−
** Host - IP или доменное имя сервера, к которому необходимо присоединить компонент. Например,
+
* HOST - IP или доменное имя сервера, к которому необходимо присоединить компонент. Например,
−
  Host="127.0.0.1"
+
  HOST="127.0.0.1"
−
** Port - порт на сервере, к которому необходимо подключаться. Должен совпадать с аналогичным, прописанным в конфигурации Вашего Jabber-[[server|сервера]].
+
* PORT - порт на сервере, к которому необходимо подключаться. Должен совпадать с аналогичным, прописанным в конфигурации Вашего Jabber-[[server|сервера]].
−
** Password - пароль на сервере, к которому необходимо подключаться. Должен совпадать с аналогичным, прописанным в конфигурации Вашего Jabber-[[server|сервера]].
+
* DB_HOST - IP или доменное имя сервера БД.
−
* Секция database:
+
* DB_USER - имя пользователя БД (в нашем примере - j2j)
−
** Host - IP или доменное имя сервера БД, оставьте пустым для использования UNIX-сокета Postgres
+
* DB_NAME - имя базы данных (в нашем примере - j2j)
−
** Type - тип используемой СУБД - postgres или mysql
+
* DB_PASS - пароль от БД для данного пользователя БД.
−
** User - имя пользователя БД (в нашем примере - j2j)
+
* DB_PREFIX - в общем случае остается без изменений.
−
** Name - имя базы данных (в нашем примере - j2j)
+
* ADMINS - список [[JID]]ов, на которые будут приходить уведомления о новых регистрациях. Пример:
−
** Password - пароль от БД для данного пользователя БД.
+
  ADMINS=[u"vasya@server.ru",u"zhenya@server.com"]
−
** Prefix - в общем случае остается без изменений. Его требуется изменять, если запускается одновременно несколько копий транспорта.
+
−
* Секция admins
+
−
** List - список [[JID]]ов, на которые будут приходить уведомления о новых регистрациях. Пример:
+
−
  List=vasya@server.ru,zhenya@server.com
+
−
* Секция debug
+
−
** logfile - путь к лог-файлу
+
−
** registrations - помещать ли в лог-файл сообщения, связанные с регистрацией пользователей на сервисе
+
−
** logins - помещать ли в лог-файл сообщения, связанные с входом-выходом пользователей
+
−
 
+
−
** xml_logging - путь к xml-логу
+
−
** component_xml - помещать ли в xml-лог данные от сервиса
+
−
** clients_xml - помещать ли в xml-лог данные по клиентам
+
−
** clients_jids_to_log - список JIDов, станзы которых помещать в xml-лог или All, если помещать все.
+
−
 
+
−
Конфигурационный файл должен быть в кодировке UTF-8.
+
  
 
=== Запуск ===
 
=== Запуск ===
Line 98: Line 62:
 
Теперь все готово к запуску:
 
Теперь все готово к запуску:
 
  python main.py
 
  python main.py
−
 
−
== Параметры командной строки ==
 
−
Запустите транспорт с ключом --help для получения справки по параметрам командной строки.
 
  
 
== Администрирование транспорта ==
 
== Администрирование транспорта ==

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://www.jawiki.ru/J2J:AdminGuide"