← Back to branch summary

~kim0/serverguide/serverguide-review-ch19

« back to all changes in this revision

Viewing changes to build/serverguide/C/jabberd2-server.html

  • Committer: Matthew East
  • Date: 2011-05-03 07:11:18 UTC
  • Revision ID: mdke@ubuntu.com-20110503071118-081aatibsr9k2yqy
Add files from ubuntu-docs natty branch, trim to use only those necessary for serverguide

Show diffs side-by-side

added added

removed removed

Lines of Context:
build/serverguide/C/jabberd2-server.html
 
1
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
 
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
3
<html xmlns="http://www.w3.org/1999/xhtml">
 
4
  <head xmlns="http://www.w3.org/1999/xhtml">
 
5
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 
6
    <title xmlns="">Jabber Instant Messaging Server</title>
 
7
    <link rel="stylesheet" href="../../libs/ubuntu-book.css" type="text/css" />
 
8
    <link rel="home" href="index.html" title="Ubuntu Server Guide" />
 
9
    <link rel="up" href="chat-servers.html" title="Chapter 15. Chat Applications" />
 
10
    <link rel="prev" href="irc-server.html" title="IRC Server" />
 
11
    <link rel="next" href="version-control-system.html" title="Chapter 16. Version Control System" />
 
12
    <link rel="copyright" href="legal.html" title="Credits and License" />
 
13
  </head>
 
14
  <body>
 
15
    <div id="round">
 
16
      <img id="topcap" alt="" src="https://help.ubuntu.com/htdocs/ubuntunew/img/cap-top.png" />
 
17
      <div id="layout" class="container clear-block">
 
18
        <script xmlns="" src="https://ssl.google-analytics.com/urchin.js" type="text/javascript"></script>
 
19
        <script xmlns="" type="text/javascript">
 
20
_uacct = "UA-1018242-8";
 
21
urchinTracker();
 
22
</script>
 
23
        <div id="header">
 
24
          <div id="logo-floater">
 
25
            <h1>
 
26
              <a href="https://help.ubuntu.com" title="Ubuntu Documentation">
 
27
                <img alt="Ubuntu" id="logo" src="https://help.ubuntu.com/htdocs/ubuntunew/img/logo.png" />
 
28
              </a>
 
29
            </h1>
 
30
          </div>
 
31
          <noscript>
 
32
            <form action="http://www.google.com/cse" id="cse-search-box">
 
33
              <div>
 
34
                <input type="hidden" name="cx" value="003883529982892832976:e2vwumte3fq" />
 
35
                <input type="hidden" name="ie" value="UTF-8" />
 
36
                <input type="text" name="q" size="27" />
 
37
                <input type="submit" name="sa" value="Search" />
 
38
              </div>
 
39
            </form>
 
40
          </noscript>
 
41
          <script>
 
42
 document.write('<form action="https://help.ubuntu.com/search.html" id="cse-search-box">');
 
43
 document.write('  <div>');
 
44
 document.write('    <input type="hidden" name="cof" value="FORID:9" />');
 
45
 document.write('    <input type="hidden" name="cx" value="003883529982892832976:e2vwumte3fq" />');
 
46
 document.write('    <input type="hidden" name="ie" value="UTF-8" />');
 
47
 document.write('    <input type="text" name="q" size="27" />');
 
48
 document.write('    <input type="submit" name="sa" value="Search" />');
 
49
 document.write('  </div>');
 
50
 document.write('</form>');
 
51
</script>
 
52
          <div id="sitename">
 
53
            <a href="https://help.ubuntu.com/">
 
54
              <img alt="Official Documentation" src="https://help.ubuntu.com/htdocs/ubuntunew/img/help-about.png" />
 
55
              <span>Official Documentation</span>
 
56
            </a>
 
57
          </div>
 
58
        </div>
 
59
        <div id="page">
 
60
          <div id="content">
 
61
            <div class="breadcrumbs"><a href="https://help.ubuntu.com/">Ubuntu Documentation</a> &gt; <a href="https://help.ubuntu.com/11.04">Ubuntu 11.04</a> &gt; <span class="breadcrumb-link"><a href="index.html">Ubuntu Server Guide</a></span> &gt; <span class="breadcrumb-link"><a href="chat-servers.html">Chat Applications</a></span> &gt; <span class="breadcrumb-node">Jabber Instant Messaging Server</span></div>
 
62
            <div xmlns="http://www.w3.org/1999/xhtml" class="sect1" title="Jabber Instant Messaging Server">
 
63
              <div class="titlepage">
 
64
                <div>
 
65
                  <div>
 
66
                    <h2 class="title" style="clear: both"><a id="jabberd2-server"></a>Jabber Instant Messaging Server</h2>
 
67
                  </div>
 
68
                </div>
 
69
              </div>
 
70
              <p>
 
71
    <span class="emphasis"><em>Jabber</em></span> a popular instant message protocol is based on XMPP, an open standard for instant messaging, and
 
72
    used by many popular applications.  This section covers setting up a <span class="emphasis"><em>Jabberd 2</em></span> server on a local LAN.  
 
73
    This configuration can also be adapted to providing messaging services to users over the Internet.
 
74
    </p>
 
75
              <div class="sect2" title="Installation">
 
76
                <div class="titlepage">
 
77
                  <div>
 
78
                    <div>
 
79
                      <h3 class="title"><a id="jabberd2-installation"></a>Installation</h3>
 
80
                    </div>
 
81
                  </div>
 
82
                </div>
 
83
                <p>
 
84
      To install <span class="application"><strong>jabberd2</strong></span>, in a terminal enter:
 
85
      </p>
 
86
                <pre class="screen">
 
87
<span class="command"><strong>sudo apt-get install jabberd2</strong></span>
 
88
</pre>
 
89
              </div>
 
90
              <div class="sect2" title="Configuration">
 
91
                <div class="titlepage">
 
92
                  <div>
 
93
                    <div>
 
94
                      <h3 class="title"><a id="jabberd2-configuration"></a>Configuration</h3>
 
95
                    </div>
 
96
                  </div>
 
97
                </div>
 
98
                <p>
 
99
    A couple of XML configuration files will be used to configure <span class="application"><strong>jabberd2</strong></span> for 
 
100
    <span class="emphasis"><em>Berkeley DB</em></span> user authentication.  This is a very simple form of authentication.  However,
 
101
    <span class="application"><strong>jabberd2</strong></span> can be configured to use LDAP, MySQL, PostgreSQL, etc for 
 
102
    for user authentication.
 
103
    </p>
 
104
                <p>
 
105
    First, edit <code class="filename">/etc/jabberd2/sm.xml</code> changing:
 
106
    </p>
 
107
                <pre class="programlisting">
 
108
  &lt;id&gt;jabber.example.com&lt;/id&gt;
 
109
</pre>
 
110
                <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
 
111
                  <table border="0" summary="Note">
 
112
                    <tr>
 
113
                      <td rowspan="2" align="center" valign="top" width="25">
 
114
                        <img alt="[Note]" src="../../libs/admon/note.png" />
 
115
                      </td>
 
116
                      <th align="left"></th>
 
117
                    </tr>
 
118
                    <tr>
 
119
                      <td align="left" valign="top">
 
120
                        <p>
 
121
      Replace <span class="emphasis"><em>jabber.example.com</em></span> with the hostname, or other id, of your server.  
 
122
      </p>
 
123
                      </td>
 
124
                    </tr>
 
125
                  </table>
 
126
                </div>
 
127
                <p>
 
128
    Now in the &lt;storage&gt; section change the &lt;driver&gt; to:
 
129
    </p>
 
130
                <pre class="programlisting">
 
131
   &lt;driver&gt;db&lt;/driver&gt;
 
132
</pre>
 
133
                <p>
 
134
    Next, edit <code class="filename">/etc/jabberd2/c2s.xml</code> in the <span class="emphasis"><em>&lt;local&gt;</em></span> section change: 
 
135
    </p>
 
136
                <pre class="programlisting">
 
137
    &lt;id&gt;jabber.example.com&lt;/id&gt;
 
138
</pre>
 
139
                <p>
 
140
    And in the &lt;authreg&gt; section adjust the &lt;module&gt; section to:
 
141
    </p>
 
142
                <pre class="programlisting">
 
143
    &lt;module&gt;db&lt;/module&gt;
 
144
</pre>
 
145
                <p>
 
146
    Finally, restart <span class="application"><strong>jabberd2</strong></span> to enable the new settings:
 
147
    </p>
 
148
                <pre class="screen">
 
149
<span class="command"><strong>sudo /etc/init.d/jabberd2 restart</strong></span>
 
150
</pre>
 
151
                <p>
 
152
  You should now be able to connect to the server using a Jabber client like <span class="application"><strong>Pidgin</strong></span> for example.
 
153
  </p>
 
154
                <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
 
155
                  <table border="0" summary="Note">
 
156
                    <tr>
 
157
                      <td rowspan="2" align="center" valign="top" width="25">
 
158
                        <img alt="[Note]" src="../../libs/admon/note.png" />
 
159
                      </td>
 
160
                      <th align="left"></th>
 
161
                    </tr>
 
162
                    <tr>
 
163
                      <td align="left" valign="top">
 
164
                        <p>
 
165
    The advantage of using Berkeley DB for user data is that after being configured no additional maintenance is required.  If you need
 
166
    more control over user accounts and credentials another authentication method is recommended.
 
167
    </p>
 
168
                      </td>
 
169
                    </tr>
 
170
                  </table>
 
171
                </div>
 
172
              </div>
 
173
              <div class="sect2" title="References">
 
174
                <div class="titlepage">
 
175
                  <div>
 
176
                    <div>
 
177
                      <h3 class="title"><a id="jabberd2-references"></a>References</h3>
 
178
                    </div>
 
179
                  </div>
 
180
                </div>
 
181
                <div class="itemizedlist">
 
182
                  <ul class="itemizedlist" type="disc">
 
183
                    <li class="listitem">
 
184
                      <p>
 
185
        The <a class="ulink" href="http://codex.xiaoka.com/wiki/jabberd2:start" target="_top">Jabberd2 Web Site</a> contains more details on configuring 
 
186
        <span class="application"><strong>Jabberd2</strong></span>.
 
187
        </p>
 
188
                    </li>
 
189
                    <li class="listitem">
 
190
                      <p>
 
191
        For more authentication options see the <a class="ulink" href="http://www.jabberdoc.org/" target="_top">Jabberd2 Install Guide</a>.
 
192
        </p>
 
193
                    </li>
 
194
                    <li class="listitem">
 
195
                      <p>
 
196
        Also, the <a class="ulink" href="https://help.ubuntu.com/community/SettingUpJabberServer" target="_top">Setting Up Jabber Server Ubuntu Wiki</a> page 
 
197
        has more information.
 
198
        </p>
 
199
                    </li>
 
200
                  </ul>
 
201
                </div>
 
202
              </div>
 
203
            </div>
 
204
          </div>
 
205
          <div xmlns="http://www.w3.org/1999/xhtml" class="navfooter">
 
206
            <hr />
 
207
            <table width="100%" summary="Navigation footer">
 
208
              <tr>
 
209
                <td width="40%" align="left"><a accesskey="p" href="irc-server.html"><img src="../../libs/navig/prev.png" alt="Prev" /></a> </td>
 
210
                <td width="20%" align="center">
 
211
                  <a accesskey="u" href="chat-servers.html">
 
212
                    <img src="../../libs/navig/up.png" alt="Up" />
 
213
                  </a>
 
214
                </td>
 
215
                <td width="40%" align="right"> <a accesskey="n" href="version-control-system.html"><img src="../../libs/navig/next.png" alt="Next" /></a></td>
 
216
              </tr>
 
217
              <tr>
 
218
                <td width="40%" align="left" valign="top">IRC Server </td>
 
219
                <td width="20%" align="center">
 
220
                  <a accesskey="h" href="index.html">
 
221
                    <img src="../../libs/navig/home.png" alt="Home" />
 
222
                  </a>
 
223
                </td>
 
224
                <td width="40%" align="right" valign="top"> Chapter 16. Version Control System</td>
 
225
              </tr>
 
226
            </table>
 
227
          </div>
 
228
          <hr />
 
229
          <div id="footer">
 
230
            <div id="ubuntulinks">
 
231
              <p>The material in this document is available under a free license, see <a href="/legal.html">Legal</a> for details<br />
 
232
        For information on contributing see the <a href="https://wiki.ubuntu.com/DocumentationTeam">Ubuntu Documentation Team wiki page</a>. To report a problem, visit the <a href="https://bugs.launchpad.net/ubuntu/+source/ubuntu-docs">bug page for Ubuntu Documentation</a></p>
 
233
            </div>
 
234
          </div>
 
235
          <div id="bottomcap">
 
236
            <img src="https://help.ubuntu.com/htdocs/ubuntunew/img/cap-bottom.png" alt="" />
 
237
          </div>
 
238
        </div>
 
239
      </div>
 
240
    </div>
 
241
  </body>
 
242
</html>