Difference between revisions of "J2J:AdminGuide"

From JaWiki (Jabber/XMPP wiki)
Jump to: navigation, search
(как же я мог забыть pygresql? :))
m (+категория; ~ссылки на XEP; +ссылка на J2J)
Line 1: Line 1:
===Установка и настройка===
+
Руководство по установке и администрированию [[gateway|транспорта]] [[J2J|J2J (Jabber-to-Jabber)]].
====Зависимости====
+
 
Для работы [[J2J]] необходимо:
+
== Установка и настройка ==
* [http://python.org Python] >=2.3
+
 
 +
=== Зависимости ===
 +
 
 +
Для работы J2J необходимо:
 +
* [[Python]] >=2.3
 
* [http://www.postgresql.org/ PostgreSQL] >=7.4.7
 
* [http://www.postgresql.org/ PostgreSQL] >=7.4.7
 
* [http://www.pygresql.org/ PyGreSQL] >=3.8
 
* [http://www.pygresql.org/ PyGreSQL] >=3.8
* [http://www.twistedmatrix.com/ Twisted] >=2.4.0
+
* [[Twisted]] >=2.4.0
 
* Любой Jabber-[[server]] (например, [[ejabberd]] или [[Wildfire]]), поддерживающий:
 
* Любой Jabber-[[server]] (например, [[ejabberd]] или [[Wildfire]]), поддерживающий:
** [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]:
  
  svn co https://svn.jrudevels.org/j2j/trunk j2j/
+
  <nowiki>svn co https://svn.jrudevels.org/j2j/trunk j2j/</nowiki>
  
====Настроить БД====
+
=== Настройка базы данных ===
Необходимо настроить БД на работу с J2J-компонентом:
+
 
 +
Необходимо настроить базу данных (БД) на работу с J2J-компонентом:
  
 
Создаем пользователя:
 
Создаем пользователя:
Line 31: Line 37:
 
  \i pgsql.schema
 
  \i pgsql.schema
  
====Настроить компонент====
+
=== Настройка компонента ===
 +
 
 
Необходимо получить конфигурационный файл для компонента с именем config.py. Для этого скопируем пример такого файла и отредактируем его:
 
Необходимо получить конфигурационный файл для компонента с именем config.py. Для этого скопируем пример такого файла и отредактируем его:
 
  cp config.py.example config.py
 
  cp config.py.example config.py
Line 50: Line 57:
 
  ADMINS=[u"vasya@server.ru",u"zhenya@server.com"]
 
  ADMINS=[u"vasya@server.ru",u"zhenya@server.com"]
  
====Запуск====
+
=== Запуск ===
 +
 
 
Теперь все готово к запуску:
 
Теперь все готово к запуску:
 
  python main.py
 
  python main.py
  
===Администрирование транспорта===
+
== Администрирование транспорта ==
Информация пока отсутствует.
+
 
 +
{{todo|Информация пока отсутствует}}
 +
 
 +
 
 +
[[Category:Documentation]]

Revision as of 13:24, 30 May 2007

Руководство по установке и администрированию транспорта J2J (Jabber-to-Jabber).

Установка и настройка

Зависимости

Для работы J2J необходимо:

Загрузка исходного кода

Необходимо получить исходный код транспорта. Это можно сделать, пройдя по ссылке, либо с помощью SVN:

svn co https://svn.jrudevels.org/j2j/trunk j2j/

Настройка базы данных

Необходимо настроить базу данных (БД) на работу с J2J-компонентом:

Создаем пользователя:

createuser -P j2j

Ключ -P означает, что пользователь создается с указанием пароля. Запомните его, он понадобится для дальнейшей настройки.

Создадим базу данных:

createdb j2j

Импортируем структуру БД:

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

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

ToDo: Информация пока отсутствует