Jabberd2:安装和管理指南

可选的名称

          su
          groupadd jabber
          useradd -g jabber jabber
          su
          mkdir -p /usr/local/var/jabberd/pid/
          chown -R jabber:jabber /usr/local/var/jabberd/pid/
          mkdir -p /usr/local/var/jabberd/log/
          chown -R jabber:jabber /usr/local/var/jabberd/log
      tar -zxvf  jabberd-2.0s3.tar.gz
      cd jabberd-2.0s3
          ./configure --help
          ./configure --enable-mysql --enable-ssl --enable-idn
      ./configure --enable-db --enable-debug --enable-ssl --enable-idn
      ./configure --enable-pgsql --enable-ssl --enable-idn \
      --with extra-include-path=/usr/local/include:/usr/local/include/mysql \
      --with-extra-library-path=/usr/local/lib:/usr/local/lib/mysql
      ./configure
      make
      su
      make install
      /usr/local/etc/jabberd     Jabberd Configuration Files
      /usr/local/bin       Jabberd Binaries (jabberd, c2s, resolver, router, s2s, sm)
      chown -R root:jabber /usr/local/etc/jabberd/*
      chmod -R 640 /usr/local/etc/jabberd/*
          ln -s /usr/local/etc/jabberd/ /etc/jabberd
      <!-- Session manager configuration -->
      <sm>
        <!-- Our ID on the network. Users will have this as the domain part of
             their JID. If you want your server to be accessible from other
             Jabber servers, this ID must be resolvable by DNS.s
             (default: localhost) -->
        <id>somemachine.somedomain.com</id>
      <!-- Local network configuration -->
      <local>
        <!-- Who we identify ourselves as. This should correspond to the
             ID (host) that the session manager thinks it is. You can
             specify more than one to support virtual hosts, as long as you
             have additional session manager instances on the network to
             handle those hosts. The realm attribute specifies the auth/reg
             or SASL authentication realm for the host. If the attribute is
             not specified, the realm will be selected by the SASL
             mechanism, or will be the same as the ID itself. Be aware that
             users are assigned to a realm, not a host, so two hosts in the
             same realm will have the same users.
             If no realm is specified, it will be set to be the same as the
             ID. -->
        <id>somemachine.somedomain.com</id>
           mkdir -p /usr/local/var/jabberd/db
           chown -R jabber:jabber /usr/local/var/jabberd
      <!-- Storage database configuration -->
        <storage>
          <!-- By default, we use the MySQL driver for all storage -->
          <driver>db</driver>
          <!-- Berkeley DB driver configuration -->
          <db>
            <!-- Directory to store database files under -->
            <path>/usr/local/var/jabberd/db</path>
 
            <!-- Synchronize the database to disk after each write. If you
                 disable this, database accesses may be faster, but data may
                 be lost if jabberd crashes. -->
            <sync/>
          </db>
      <!-- Authentication/registration database configuration -->
      <authreg>
        <!-- Backend module to use -->
        <module>db</module>
          <!-- Berkeley DB module configuration -->
          <db>
            <!-- Directory to store database files under -->
            <path>/usr/local/var/jabberd/db</path>
 
            <!-- Synchronize the database to disk after each write. If you
                 disable this, database accesses may be faster, but data may
                 be lost if jabberd crashes. -->
            <sync/>
          </db>
   mysql -u root -p
   mysql>\. db-setup.mysql
 GRANT select,insert,delete,update ON jabberd2.* 
      to jabberd2@localhost IDENTIFIED by 'secret';
      ln -s /var/lib/mysql/mysql.sock /tmp/mysql.sock
 <!-- Storage database configuration -->
        <storage>
          <!-- By default, we use the MySQL driver for all storage -->
          <driver>mysql</driver>
 <!-- MySQL driver configuration -->
      <mysql>
        <!-- Database server host and port -->
        <host>localhost</host>
        <port>3306</port>
 
        <!-- Database name -->
        <dbname>jabberd2</dbname>
 
        <!-- Database username and password -->
        <user>jabberd2</user>
        <pass>secret</pass>
 
        <!-- Transaction support. If this is commented out, transactions
             will be disabled. This might make database accesses faster,
             but data may be lost if jabberd crashes.
 
             This will need to be disabled if you are using a MySQL
             earlier than v3.23.xx, as transaction support did not appear
             until this version. -->
        <transactions/>
      <!-- Authentication/registration database configuration -->
      <authreg>
        <!-- Backend module to use -->
        <module>mysql</module>
      <!-- MySQL module configuration -->
      <mysql>
        <!-- Database server host and port -->
        <host>localhost</host>
        <port>3306</port>
 
        <!-- Database name -->
        <dbname>jabberd2</dbname>
 
        <!-- Database username and password -->
        <user>jabberd2</user>
        <pass>secret</pass>
      </mysql>
      createdb -U postgres jabberd2
      createdb -U postgres -E UNICODE jabberd2
      createuser -P -U postgres jabberd2
      Enter password for user "jabberd2":
      Enter it again:
      Shall the new user be allowed to create databases? (y/n) n
      Shall the new user be allowed to create more new users? (y/n) n
      CREATE USER
      psql -U jabberd2 jabberd2
      jabberd2=>\i db-setup.pgsql
      <!-- Storage database configuration -->
        <storage>
          <!-- By default, we use the MySQL driver for all storage -->
          <driver>pgsql</driver>
      <!-- PostgreSQL driver configuration -->
      <pgsql>
        <!-- Database server host and port -->
        <host>localhost</host>
        <port>5432</port>
 
        <!-- Database name -->
        <dbname>jabberd2</dbname>
 
        <!-- Database username and password -->
        <user>jabberd2</user>
        <pass>secret</pass>
 
        <!-- Transaction support. If this is commented out, transactions
             will be disabled. This might make database accesses faster,
             but data may be lost if jabberd crashes. -->
        <transactions/>
      </pgsql>
     <!-- Authentication/registration database configuration -->
      <authreg>
        <!-- Backend module to use -->
        <module>pgsql</module>
      <!-- PostgreSQL module configuration -->
      <pgsql>
        <!-- Database server host and port -->
        <host>localhost</host>
        <port>5432</port>
 
        <!-- Database name -->
        <dbname>jabberd2</dbname>
 
        <!-- Database username and password -->
        <user>jabberd2</user>
        <pass>secret</pass>
      </pgsql>

@@ 第737行： / 第737行： @@
 ===提供和配置PostgreSQL===
+[http://www.postgresql.org/ PostgreSQL] 和MySQL一样，提供一个非常易于管理的后端用于存储和验证. 和MySQL不同的是, PostgreSQL提供了更好的 unicode支持.
+====提供PostgreSQL====
+如果你使用PostgreSQL存储 和/或 验证请完成本节. 为了给Jabberd配置PostgreSQL, 你必须新建一个数据库，新建一个PostgreSQL用户并运行Jabberd 2分发包里带的PostgreSQL脚本.
+为Jabberd新建数据库. (PostgreSQL服务器应该已经在运行):
+<source lang="bash">
+      createdb -U postgres jabberd2
+</source>
+以上命令讲新建一个数据库，你可以在那个数据库运行接哦本来安装Jabberd PostgreSQL数据库.
+'''N 注意: Unicode支持'''
+:如果你希望为你的PostgreSQL数据库激活Unicode支持, 把以上命令修改如下:
+<source lang="bash">
+      createdb -U postgres -E UNICODE jabberd2
+</source>
+'''P 参数: PostgreSQL用户名和密码'''
+:新建你的Jabberd数据库用户, 输入以下命令:
+<source lang="bash">
+      createuser -P -U postgres jabberd2
+</source>
+这个命令将初始化一个交互用户创建脚本. 当看到提示, 输入将来用于连接到你的PostgreSQL数据库的Jabberd的密码:
+<source lang="bash">
+      Enter password for user "jabberd2":
+      Enter it again:
+      Shall the new user be allowed to create databases? (y/n) n
+      Shall the new user be allowed to create more new users? (y/n) n
+      CREATE USER
+</source>
+''CREATE USER'' 信息表示命令执行成功.
+在你的jabberd用户创建之后, 你已经准备好运行PostgreSQL安装脚本了. 这个脚本位于 '\[Jabberd Source Files\]\/tools'. 切换到 ''tools'' 目录并以jabberd2用户身份启动PostgreSQL控制台:
+<source lang="bash">
+      psql -U jabberd2 jabberd2
+</source>
+然后, 从PostgreSQL控制台运行 ''db-setup.pgsql'' 脚本:
+<source lang="bash">
+      jabberd2=>\i db-setup.pgsql
+</source>
+PostgreSQL现在准备好用于Jabberd了.
+====配置存储使用PostgreSQL(sm.xml)====
+如果你使用PostgreSQL存储，请完成本节. 大多数使用PostgreSQL存储的安装只需要设置驱动, 用户和密码.
+在 ''sm.xml'' 里标为 ''Storage database configuration'' 的段落下, 确保 ''driver'' 是用 pgsql (PostgreSQL):
+<source lang="xml">
+      <!-- Storage database configuration -->
+        <storage>
+          <!-- By default, we use the MySQL driver for all storage -->
+          <driver>pgsql</driver>
+</source>
+'''P 参数: PostgreSQL用户名和密码'''
+:在 ''sm.xml'' 里标为 ''PostgreSQL driver configuration'' 的段落下, 把 ''secret'' 替换成你的PostgreSQL密码. 如果你不使用缺省用户(jabberd2)则还要修改用户名 :
+<source lang="xml">
+      <!-- PostgreSQL driver configuration -->
+      <pgsql>
+        <!-- Database server host and port -->
+        <host>localhost</host>
+        <port>5432</port>
+        <!-- Database name -->
+        <dbname>jabberd2</dbname>
+        <!-- Database username and password -->
+        <user>jabberd2</user>
+        <pass>secret</pass>
+        <!-- Transaction support. If this is commented out, transactions
+             will be disabled. This might make database accesses faster,
+             but data may be lost if jabberd crashes. -->
+        <transactions/>
+      </pgsql>
+</source>
+注意只有你的PostgreSQL服务器运行在另一个主机上你才应该修改host设置. 只有你的PostgreSQL服务器运行在一个非标准端口(5432是PostgreSQL安装后的缺省端口)你才应该修改port设置. transaction support 段落则是不言自明的了.
+现在Jabberd 2已经配置成使用PostgreSQL来存储了.
+如果你希望使用一个不同于PostgreSQL的验证包, 跳到你选择的验证包:
+* [[Jabberd2:安装和管理指南#提供和配置PAM|提供和配置PAM]]
+* [[Jabberd2:安装和管理指南#提供和配置OpenLDAP|提供和配置OpenLDAP]]
+否则, 继续到 4.5.3. 直接往下完成你的Jabberd 2配置.
+====配置验证使用PostgreSQL(c2s.xml)====
+如果你使用PostgreSQL来验证，请完成本节. Jabberd 2对于PostgreSQL验证配置的要求同上，除了包含在 ''c2s.xml'' 的信息.
+在 ''c2s.xml'' 的 ''Authentication/registration database configuration'' （验证/注册 数据库配置）段落, 确保 ''driver'' 使用pgsql (PostgreSQL):
+<source lang="xml">
+     <!-- Authentication/registration database configuration -->
+      <authreg>
+        <!-- Backend module to use -->
+        <module>pgsql</module>
+</source>
+'''P 参数: PostgreSQL用户名和密码'''
+:在 ''c2s.xml'' 的 ''PostgreSQL module configuration'' 段落, 把 ''secret'' 替换成你的PostgreSQL密码. 如果你不使用缺省用户(jabberd2)则还要修改用户名 :
+<source lang="xml">
+      <!-- PostgreSQL module configuration -->
+      <pgsql>
+        <!-- Database server host and port -->
+        <host>localhost</host>
+        <port>5432</port>
+        <!-- Database name -->
+        <dbname>jabberd2</dbname>
+        <!-- Database username and password -->
+        <user>jabberd2</user>
+        <pass>secret</pass>
+      </pgsql>
+</source>
+注意只有你的PostgreSQL服务器运行在另一个主机上你才应该修改host设置. 只有你的PostgreSQL服务器运行在一个非标准端口(5432是PostgreSQL安装后的缺省端口)你才应该修改port设置.
+你的Jabberd 2的存储和验证配置现在完成了. 在转移到其他配置任务(例如 [[Jabberd2:安装和管理指南#通用配置任务|第五章]] 的配置SSL)之前，跳到 [[Jabberd2:安装和管理指南#测试服务器|测试服务器]] 去开始测试你的服务器.
+[http://www.jabberdoc.org/section04_5/html2pdf 以PDF格式查看]
 ===对PAM的规定和配置===
 ===对OpenLDAP的规定和配置===
 ===测试服务器===

约定	名称	描述
P	参数	一个配置文件中关于你的特定安装的信息, 等等.
C	检查点	一个点，停止并检查你的安装
N	注意	强调信息
I	重要	重要的强调或警告
F	必需的文件	完成这一步或下列步骤所需要的软件或特定文件
O	可选步骤	这一步在大部分基本安装中不是必需的步骤
E	外部系统	这一步可能需要在外部系统配置，如路由器

参数	必需的	章节	描述	你的信息
Jabberd User and Group	Y	2.2	Linux(或其他OS)用户和组，将用于运行Jabberd	user: jabber group: jabber
PID Directory	Y	2.3	Jabberd存储PID文件的目录	/usr/local/var/jabberd/pid
Log Directory	N	2.3	用于Jabberd logs的目录. 如果在配置文件中不指定, 日志缺省存在syslog.	/usr/local/var/jabberd/log
Authentication Package	Y	2.4.3 3.3,	Jabberd验证管理使用的第三方包	MySQL, PostgreSQL, Berkeley DB, OpenLDAP or PAM
Data Storage Package	Y	2.4.4 4.3	用于存储Jabberd数据的第三方包	MySQL, PostgreSQL or Berkeley DB
Data Directory	Berkeley DB	4.1.1, 4.2.1,	用于存储Berkeley DB数据文件的目录	/usr/local/var/jabberd/db
MySQL User and Password	MySQL	3.5.2.2, 4.1.2, 4.2.2,	Jabberd用于连接MySQL的MySQL用户名和密码	user: jabberd2 password: secret
PostgreSQL User and Password	PostgreSQL	3.5.3.1, 1 3, 4.2.3,	Jabberd用于连接PostgreSQL的PostgreSQL用户名和密码	user: jabberd2 password: secret
OpenLDAP Connection Settings	OpenLDAP	2.5	用于你的OpenLDAP服务器连接设置: 指定LDAP服务器(或IP)的FQDN,端口,和LDAP使用的版本(要么v2要么v3)
OpenLDAP User and Password	OpenLDAP	4.2.5	连接到你的OpenLDAP服务器的用户名和密码. 只有你的OpenLDAP服务器不允许匿名绑定(访问)时才需要
OpenLDAP Query Settings	OpenLDAP	4.2.5	Base DN (识别名) 和 User ID 属性用于为OpenLDAP服务器建立查询. Base DN 可以要么是服务器的root DN 要么是一个可以在它那找到 User ID's 的 RDN (相对的识别名).
Hostname	Y	4.4	你的安装了Jabberd服务器的主机名. 对于可从互联网访问的服务器, 看起来类似 somedomain.com
SSL Key Location	N	5.3.1, 5.3.2	OpenSSL证书文件的位置. 对于SSL加密通讯是必需的	/usr/local/etc/jabberd/server.pem
Router User and Password	N	5.4	用于别的组件连接到Jabberd Router组件的用户名和密码	user: jabberd2 password: secret

Jabberd2:安装和管理指南

2011年1月18日 (二) 06:59的版本

目录

绪论

目的和范围

需要的背景知识

如何使用本文档

本文使用的约定

更多阅读

法律术语

来源

准备安装Jabberd2

收集必需的信息

新建Jabber用户和组

为PID's和Logs新建目录

安装先决条件

OpenSSL

Libidn

数据存储包

验证包

安装Jabberd 2

下载Jabberd 2

提取Jabberd安装文件

配置Jabberd编译

编译Jabberd

安装Jabberd

缺省文件位置

设置配置文件的所有权

基本配置

在sm.xml和c2s.xml设置主机名

对存储和验证包的提供和配置

提供和配置BerkeleyDB

提供BerkeleyDB

配置存储使用BerkeleyDB(sm.xml)

配置验证使用BerkeleyDB(c2s.xml)

提供和配置MySQL

提供MySQL

配置存储使用MySQL(sm.xml)

配置验证使用MySQL(c2s.xml)

提供和配置PostgreSQL

提供PostgreSQL

配置存储使用PostgreSQL(sm.xml)

配置验证使用PostgreSQL(c2s.xml)

对PAM的规定和配置

对OpenLDAP的规定和配置

测试服务器

查看

个人工具

导航

XMPP资源

搜索

工具箱