Debian Codegraph @

doc/relaying/index.html

raw
1 <!DOCTYPE html>
2 <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
3 <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
4 <head>
5 <meta charset="utf-8">
6 <meta http-equiv="X-UA-Compatible" content="IE=edge">
7 <meta name="viewport" content="width=device-width, initial-scale=1.0">
8
9
10 <link rel="shortcut icon" href="../img/favicon.ico">
11 <title>Relaying - Icecast Docs</title>
12 <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
13
14 <link rel="stylesheet" href="../css/theme.css" type="text/css" />
15 <link rel="stylesheet" href="../css/theme_extra.css" type="text/css" />
16 <link rel="stylesheet" href="../css/highlight.css">
17
18 <script>
19 // Current page data
20 var mkdocs_page_name = "Relaying";
21 var mkdocs_page_input_path = "relaying.md";
22 var mkdocs_page_url = "/relaying/";
23 </script>
24
25 <script src="../js/jquery-2.1.1.min.js"></script>
26 <script src="../js/modernizr-2.8.3.min.js"></script>
27 <script type="text/javascript" src="../js/highlight.pack.js"></script>
28
29 </head>
30
31 <body class="wy-body-for-nav" role="document">
32
33 <div class="wy-grid-for-nav">
34
35
36 <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
37 <div class="wy-side-nav-search">
38 <a href=".." class="icon icon-home"> Icecast Docs</a>
39
40 </div>
41
42 <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
43 <ul class="current">
44
45
46 <li class="toctree-l1">
47
48 <a class="" href="..">Introduction</a>
49 </li>
50
51 <li class="toctree-l1">
52
53 <a class="" href="../basic_setup/">Basic Setup</a>
54 </li>
55
56 <li class="toctree-l1">
57
58 <a class="" href="../config_file/">Configuration File</a>
59 </li>
60
61 <li class="toctree-l1">
62
63 <a class="" href="../server_stats/">Server Statistics</a>
64 </li>
65
66 <li class="toctree-l1">
67
68 <a class="" href="../auth/">Authentication</a>
69 </li>
70
71 <li class="toctree-l1 current">
72
73 <a class="current" href="./">Relaying</a>
74 <ul class="subnav">
75
76 <li class="toctree-l2"><a href="#type-of-relays">Type of Relays</a></li>
77
78
79 <li class="toctree-l2"><a href="#setting-up-a-master-slave-relay">Setting Up a Master-Slave Relay</a></li>
80
81
82 <li class="toctree-l2"><a href="#specific-mountpoint-relay">Specific Mountpoint Relay</a></li>
83
84
85 </ul>
86 </li>
87
88 <li class="toctree-l1">
89
90 <a class="" href="../yp/">Listing in a YellowPage Directory</a>
91 </li>
92
93 <li class="toctree-l1">
94
95 <a class="" href="../admin_interface/">Admin Interface</a>
96 </li>
97
98 <li class="toctree-l1">
99
100 <a class="" href="../win32/">Windows Specific</a>
101 </li>
102
103 </ul>
104 </div>
105 &nbsp;
106 </nav>
107
108 <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
109
110
111 <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
112 <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
113 <a href="..">Icecast Docs</a>
114 </nav>
115
116
117 <div class="wy-nav-content">
118 <div class="rst-content">
119 <div role="navigation" aria-label="breadcrumbs navigation">
120 <ul class="wy-breadcrumbs">
121 <li><a href="..">Docs</a> &raquo;</li>
122
123
124
125 <li>Relaying</li>
126 <li class="wy-breadcrumbs-aside">
127
128 </li>
129 </ul>
130 <hr/>
131 </div>
132 <div role="main">
133 <div class="section">
134
135 <p>Relaying is the process by which one server mirrors one or more streams from a remote server. The servers
136 need not be of the same type (i.e. Icecast can relay from Shoutcast). Relaying is used primarily for large
137 broadcasts that need to distribute listening clients across multiple physical machines.</p>
138 <h1 id="type-of-relays">Type of Relays</h1>
139 <p>There are two types of relays that Icecast supports:<br />
140 The first type is when both master and slave servers are Icecast 2 servers. In this case, a “master-slave” relay
141 can be setup such that all that needs to be done is configure the slave server with the connection information
142 (server IP and port) of the master server and the slave will mirror all mountpoints on the master server. The slave
143 will also periodically check the master server to see if any new mountpoints have attached and if so will relay those
144 as well.</p>
145 <p>The second type of relay is a specific mountpoint relay. In this case, the slave server is configured with a
146 server IP, port and mountpoint and only the mountpoint specified is relayed.</p>
147 <h1 id="setting-up-a-master-slave-relay">Setting Up a Master-Slave Relay</h1>
148 <p>In order to setup a relay of this type both servers (the one you wish to relay and the one doing the relaying)
149 need to be Icecast 2 servers.<br />
150 The following configuration snippet is used as an example:</p>
151 <pre><code class="xml">&lt;master-server&gt;192.168.1.11&lt;/master-server&gt;
152 &lt;master-server-port&gt;8001&lt;/master-server-port&gt;
153 &lt;master-update-interval&gt;120&lt;/master-update-interval&gt;
154 &lt;master-username&gt;relay&lt;/master-username&gt;
155 &lt;master-password&gt;hackme&lt;/master-password&gt;
156 &lt;relays-on-demand&gt;0&lt;/relays-on-demand&gt;
157 </code></pre>
158
159 <p>In this example, this configuration is setup in the server which will be doing the relaying (slave server).
160 The master server in this case need not be configured (and actually is unaware of the relaying being performed).
161 When the slave server is started, it will connect to the master server, 192.168.1.11:8001 in this example. The slave server will begin to relay all non-hidden mountpoints connected to the master server. Additionally, every master-update-interval, 120 seconds
162 in this case, the slave server will poll the master server to see if any new mountpoints have connected.<br />
163 Note that the names of the mountpoints on the slave server will be identical to those on the master server.</p>
164 <p>Configuration options:</p>
165 <dl>
166 <dt>master-server</dt>
167 <dd>This is the hostname (or IP) for the server which contains the mountpoints to be relayed (Master Server).</dd>
168 <dt>master-server-port</dt>
169 <dd>This is the TCP port for the server which contains the mountpoints to be relayed (Master Server).</dd>
170 <dt>master-update-interval</dt>
171 <dd>The interval in seconds that the relay server will poll the master server for any new mountpoints to relay.</dd>
172 <dt>master-username</dt>
173 <dd>This is the relay username for the master server, used to query the server for a list of mountpoints to relay.<br />
174 (Defaults to <code>relay</code>)</dd>
175 <dt>master-password</dt>
176 <dd>This is the relay password for the master server, used to query the server for a list of mounpoints to relay.</dd>
177 <dt>relays-on-demand</dt>
178 <dd>Global on-demand setting for relays. Because you do not have individual relay options when using a master server relay, you still may want those relays to only pull the stream when there is at least one listener on the slave. The typical case here is to avoid bandwidth costs when no one is listening.</dd>
179 </dl>
180 <h1 id="specific-mountpoint-relay">Specific Mountpoint Relay</h1>
181 <p>If only specific mountpoints need to be relayed, or the master server is not a Icecast 2 server, you can use the specific
182 mountpoint relay. Supported master servers for this type of relay are Shoutcast, Icecast 1.x, and of course Icecast 2.<br />
183 The following configuration snippet is used as an example:</p>
184 <pre><code class="xml">&lt;relay&gt;
185 &lt;server&gt;192.168.1.11&lt;/server&gt;
186 &lt;port&gt;8001&lt;/port&gt;
187 &lt;mount&gt;/example.ogg&lt;/mount&gt;
188 &lt;local-mount&gt;/different.ogg&lt;/local-mount&gt;
189 &lt;username&gt;Jekyll&lt;/username&gt;
190 &lt;password&gt;Hyde&lt;/password&gt;
191 &lt;relay-shoutcast-metadata&gt;0&lt;/relay-shoutcast-metadata&gt;
192 &lt;on-demand&gt;1&lt;/on-demand&gt;
193 &lt;/relay&gt;
194 </code></pre>
195
196 <p>In this example, this configuration is setup in the server which will be doing the relaying (slave server).
197 The master server in this case need not be configured (and actually is unaware of the relaying being performed) as a
198 relay. When the slave server is started, it will connect to the master server, in this example located at 192.168.1.11:8001
199 and will begin to relay only the mountpoint specified (/example.ogg in this case).<br />
200 Using this type of relay, the user can override the local mountpoint name and make it something entirely different than the one on the master server. Additionally, if the server is a Shoutcast server, then the <code>&lt;mount&gt;</code> must be specified as <code>/</code>,
201 and if you want the Shoutcast relay stream to have metadata contained within it (Shoutcast metadata is embedded
202 in the stream itself), the <code>&lt;relay-shoutcast-metadata&gt;</code> needs to be set to <code>1</code>.</p>
203 <p>Configuration options:</p>
204 <dl>
205 <dt>server</dt>
206 <dd>This is the hostname (or IP) for the server which contains the mountpoint to be relayed.</dd>
207 <dt>port</dt>
208 <dd>This is the TCP port for the server which contains the mountpoint to be relayed.</dd>
209 <dt>mount</dt>
210 <dd>The mountpoint located on the remote server. (If you are relaying a Shoutcast stream, this should be <code>/</code>)</dd>
211 <dt>local-mount</dt>
212 <dd>The name to use for the local mountpoint. This is what the mountpoint will be called on the relaying server. (Defaults to the remote mountpoint)</dd>
213 <dt>username</dt>
214 <dd>The username, if required, for the remote mountpoint.</dd>
215 <dt>password</dt>
216 <dd>The password, if required, for the remote mountpoint.</dd>
217 <dt>relay-shoutcast-metadata</dt>
218 <dd>If relaying a Shoutcast stream, set this to <code>1</code> to relay the metadata (song titles), which are part of the Shoutcast data stream. (Defaults to enabled, but it's up to the remote server if metadata is sent)<br />
219 Possible values: <code>1</code>: enabled, <code>0</code>: disabled</dd>
220 <dt>on-demand</dt>
221 <dd>An on-demand relay will only retrieve the stream if there are listeners requesting the stream. (Defaults to the value of <code>&lt;relays-on-demand&gt;</code>)<br />
222 Possible values: <code>1</code>: enabled, <code>0</code>: disabled</dd>
223 </dl>
224
225 </div>
226 </div>
227 <footer>
228
229 <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
230
231 <a href="../yp/" class="btn btn-neutral float-right" title="Listing in a YellowPage Directory">Next <span class="icon icon-circle-arrow-right"></span></a>
232
233
234 <a href="../auth/" class="btn btn-neutral" title="Authentication"><span class="icon icon-circle-arrow-left"></span> Previous</a>
235
236 </div>
237
238
239 <hr/>
240
241 <div role="contentinfo">
242 <!-- Copyright etc -->
243
244 </div>
245
246 Built with <a href="http://www.mkdocs.org">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
247 </footer>
248
249 </div>
250 </div>
251
252 </section>
253
254 </div>
255
256 <div class="rst-versions" role="note" style="cursor: pointer">
257 <span class="rst-current-version" data-toggle="rst-current-version">
258
259
260 <span><a href="../auth/" style="color: #fcfcfc;">&laquo; Previous</a></span>
261
262
263 <span style="margin-left: 15px"><a href="../yp/" style="color: #fcfcfc">Next &raquo;</a></span>
264
265 </span>
266 </div>
267 <script>var base_url = '..';</script>
268 <script src="../js/theme.js"></script>
269
270 </body>
271 </html>