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}}
+
===Установка и настройка===
Руководство по установке и администрированию [[gateway|транспорта]] [[J2J|J2J (Jabber-to-Jabber)]].
+
====Зависимости====
 
+
Для работы [[J2J]] необходимо:
Руководство пользователя находится на [[J2J|следующей странице]].
+
* [http://python.org Python] >=2.3
 
+
* [http://www.postgresql.org/ PostgreSQL] >=7.4.7
== Установка и настройка ==
+
 
+
=== Зависимости ===
+
 
+
Для работы J2J необходимо:
+
* [[Python]] >=2.3
+
* [http://www.postgresql.org/ PostgreSQL] >=8.2
+
 
* [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)
+
* [http://www.twistedmatrix.com/ Twisted] >=2.4.0
* [http://pyopenssl.sourceforge.net/ PyOpenSSL] >=0.6
+
* Любой Jabber-[[server]] (например, [[ejabberd]] или [[Wildfire]]), поддерживающий:
* Любой Jabber-[[server]] (например, [[ejabberd]] или [[Openfire]]), поддерживающий:
+
** [http://www.xmpp.org/extensions/xep-0114.html XEP-0114]
** {{xep|0114|Jabber Component Protocol}}
+
** [http://www.xmpp.org/extensions/xep-0030.html XEP-0030]
** [[Service Discovery|XEP-0030: Service Discovery]]
+
 
+
=== Загрузка исходного кода ===
+
  
 +
====Скачать исходный код====
 
Необходимо получить исходный код транспорта. Это можно сделать, пройдя по [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>
+
  svn co https://svn.jrudevels.org/j2j/trunk j2j/
  
=== Настройка базы данных ===
+
====Настроить БД====
 
+
Необходимо настроить БД на работу с J2J-компонентом:
Необходимо настроить базу данных (БД) на работу с J2J-компонентом:
+
  
 
Создаем пользователя:
 
Создаем пользователя:
Line 41: Line 31:
 
  \i pgsql.schema
 
  \i pgsql.schema
  
=== Настройка Jabber-сервера ===
+
====Настроить компонент====
 
+
Необходимо получить конфигурационный файл для компонента с именем config.py. Для этого скопируем пример такого файла и отредактируем его:
==== ejabberd ====
+
  cp config.py.example config.py
Вся настройка сводится к добавлению строки вида:
+
  nano -w config.py
 
+
{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. Для этого скопируем пример такого файла и отредактируем его:
+
  cp j2j.conf.example j2j.conf
+
  nano -w j2j.conf
+
  
 
Параметры:
 
Параметры:
* Секция 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.
+
 
+
=== Запуск ===
+
  
 +
====Запуск====
 
Теперь все готово к запуску:
 
Теперь все готово к запуску:
 
  python main.py
 
  python main.py
  
== Параметры командной строки ==
+
===Администрирование транспорта===
Запустите транспорт с ключом --help для получения справки по параметрам командной строки.
+
Информация пока отсутствует.
 
+
== Администрирование транспорта ==
+
 
+
{{todo|Информация пока отсутствует}}
+
 
+
 
+
[[Category:Documentation]]
+

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: