← Back to branch summary

~kim0/serverguide/serverguide-review-ch19

« back to all changes in this revision

Viewing changes to build/serverguide/C/irc-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/irc-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="">IRC 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="chat-overview.html" title="Overview" />
 
11
    <link rel="next" href="jabberd2-server.html" title="Jabber Instant Messaging Server" />
 
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">IRC Server</span></div>
 
62
            <div xmlns="http://www.w3.org/1999/xhtml" class="sect1" title="IRC Server">
 
63
              <div class="titlepage">
 
64
                <div>
 
65
                  <div>
 
66
                    <h2 class="title" style="clear: both"><a id="irc-server"></a>IRC Server</h2>
 
67
                  </div>
 
68
                </div>
 
69
              </div>
 
70
              <p>
 
71
    The Ubuntu repository has many Internet Relay Chat servers. This
 
72
    section explains how to install and configure the original IRC
 
73
    server <span class="application"><strong>ircd-irc2</strong></span>.
 
74
    </p>
 
75
              <div class="sect2" title="Installation">
 
76
                <div class="titlepage">
 
77
                  <div>
 
78
                    <div>
 
79
                      <h3 class="title"><a id="irc-installation"></a>Installation</h3>
 
80
                    </div>
 
81
                  </div>
 
82
                </div>
 
83
                <p>
 
84
      To install <span class="application"><strong>ircd-irc2</strong></span>, run the following
 
85
      command in the command prompt:
 
86
      </p>
 
87
                <pre class="screen">
 
88
<span class="command"><strong>sudo apt-get install ircd-irc2</strong></span>
 
89
</pre>
 
90
                <p>
 
91
       The configuration files are stored in
 
92
       <code class="filename">/etc/ircd</code> directory. The documents are
 
93
       available in <code class="filename">/usr/share/doc/ircd-irc2</code>
 
94
       directory. 
 
95
       </p>
 
96
              </div>
 
97
              <div class="sect2" title="Configuration">
 
98
                <div class="titlepage">
 
99
                  <div>
 
100
                    <div>
 
101
                      <h3 class="title"><a id="irc-configuration"></a>Configuration</h3>
 
102
                    </div>
 
103
                  </div>
 
104
                </div>
 
105
                <p>
 
106
      The IRC settings can be done in the configuration file
 
107
      <code class="filename">/etc/ircd/ircd.conf</code>. You can set the IRC host
 
108
      name in this file by editing the following line:
 
109
      </p>
 
110
                <pre class="programlisting">
 
111
M:irc.localhost::Debian ircd default configuration::000A
 
112
</pre>
 
113
                <p>
 
114
      Please make sure you add DNS aliases for the IRC host name. For
 
115
      instance, if you set irc.livecipher.com as IRC host name, please
 
116
      make sure irc.livecipher.com is resolvable in your Domain Name
 
117
      Server. The IRC host name should not be same as the host name.
 
118
      </p>
 
119
                <p>
 
120
      The IRC admin details can be configured by editing the following
 
121
      line:
 
122
      </p>
 
123
                <pre class="programlisting">
 
124
A:Organization, IRC dept.:Daemon &lt;ircd@example.irc.org&gt;:Client Server::IRCnet:
 
125
</pre>
 
126
                <p>
 
127
      You should add specific lines to configure the list of IRC ports to
 
128
      listen on, to configure Operator credentials, to configure client
 
129
      authentication, etc. For details, please refer to the example
 
130
      configuration file
 
131
      <code class="filename">/usr/share/doc/ircd-irc2/ircd.conf.example.gz</code>.
 
132
      </p>
 
133
                <p>
 
134
      The IRC banner to be displayed in the IRC client, when the user
 
135
      connects to the server can be set in
 
136
      <code class="filename">/etc/ircd/ircd.motd</code> file.
 
137
      </p>
 
138
                <p>
 
139
      After making necessary changes to the configuration file, you can
 
140
      restart the IRC server using following command:
 
141
      </p>
 
142
                <pre class="programlisting">
 
143
sudo /etc/init.d/ircd-irc2 restart
 
144
</pre>
 
145
              </div>
 
146
              <div class="sect2" title="References">
 
147
                <div class="titlepage">
 
148
                  <div>
 
149
                    <div>
 
150
                      <h3 class="title"><a id="irc-references"></a>References</h3>
 
151
                    </div>
 
152
                  </div>
 
153
                </div>
 
154
                <p>
 
155
    You may also be interested to take a look at other IRC servers
 
156
    available in Ubuntu Repository. It includes,
 
157
    <span class="application"><strong>ircd-ircu</strong></span> and
 
158
    <span class="application"><strong>ircd-hybrid</strong></span>.
 
159
    </p>
 
160
                <div class="itemizedlist">
 
161
                  <ul class="itemizedlist" type="disc">
 
162
                    <li class="listitem">
 
163
                      <p>
 
164
        Refer to <a class="ulink" href="http://www.irc.org/tech_docs/ircnet/faq.html" target="_top">IRCD
 
165
        FAQ</a> for more details about the IRC Server.
 
166
        </p>
 
167
                    </li>
 
168
                    <li class="listitem">
 
169
                      <p>
 
170
        Also, the <a class="ulink" href="https://help.ubuntu.com/community/ircd" target="_top">Ubuntu Wiki IRCD</a> page has more information.
 
171
        </p>
 
172
                    </li>
 
173
                  </ul>
 
174
                </div>
 
175
              </div>
 
176
            </div>
 
177
          </div>
 
178
          <div xmlns="http://www.w3.org/1999/xhtml" class="navfooter">
 
179
            <hr />
 
180
            <table width="100%" summary="Navigation footer">
 
181
              <tr>
 
182
                <td width="40%" align="left"><a accesskey="p" href="chat-overview.html"><img src="../../libs/navig/prev.png" alt="Prev" /></a> </td>
 
183
                <td width="20%" align="center">
 
184
                  <a accesskey="u" href="chat-servers.html">
 
185
                    <img src="../../libs/navig/up.png" alt="Up" />
 
186
                  </a>
 
187
                </td>
 
188
                <td width="40%" align="right"> <a accesskey="n" href="jabberd2-server.html"><img src="../../libs/navig/next.png" alt="Next" /></a></td>
 
189
              </tr>
 
190
              <tr>
 
191
                <td width="40%" align="left" valign="top">Overview </td>
 
192
                <td width="20%" align="center">
 
193
                  <a accesskey="h" href="index.html">
 
194
                    <img src="../../libs/navig/home.png" alt="Home" />
 
195
                  </a>
 
196
                </td>
 
197
                <td width="40%" align="right" valign="top"> Jabber Instant Messaging Server</td>
 
198
              </tr>
 
199
            </table>
 
200
          </div>
 
201
          <hr />
 
202
          <div id="footer">
 
203
            <div id="ubuntulinks">
 
204
              <p>The material in this document is available under a free license, see <a href="/legal.html">Legal</a> for details<br />
 
205
        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>
 
206
            </div>
 
207
          </div>
 
208
          <div id="bottomcap">
 
209
            <img src="https://help.ubuntu.com/htdocs/ubuntunew/img/cap-bottom.png" alt="" />
 
210
          </div>
 
211
        </div>
 
212
      </div>
 
213
    </div>
 
214
  </body>
 
215
</html>