1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<%! String current = "installation"; %>
<%@ include file="header.jsp" %>
<body>
<a name="top"></a>
<div id="container">
<%@ include file="menu.jsp" %>
<div id="content">
<div id="main-col">
<h1 class="bottomspace">Installing Subsonic</h1>
<p>
Subsonic features several flexible installation options. Select the one which suits you best:
</p>
<ul class="list">
<li><a href="#windows">Windows installation</a></li>
<li><a href="#mac">Mac installation</a></li>
<li><a href="#debian">Debian/Ubuntu installation</a></li>
<li><a href="#rpm">Red Hat/Fedora installation</a></li>
<li><a href="#standalone">Stand-alone installation</a></li>
<li><a href="#war">WAR installation</a></li>
</ul>
<a href="inc/img/change-password.png"><img src="inc/img/change-password-small.png" alt="Change password" class="img-right"/></a>
<p class="bottomspace"><b>Important!</b>
Immediately after installing Subsonic you should change the admin password to secure the server.
Point your browser to the Subsonic web page (see URL below), and log in with username <code>admin</code> and password
<code>admin</code>. Go to <code>Settings > Users</code> to change password and create new users.
</p>
<div class="featureitem">
<a name="windows"></a>
<div class="heading"><img src="inc/img/download-windows.png" alt="" height="16" width="16"/> Windows installation <a href="#top" class="backtotop" title="Top"><img src="inc/img/top.gif" alt="" height="16" width="16"/></a></div>
<div class="content">
<div class="wide-content">
<p>
On Windows, the easiest way to install Subsonic is using the provided Windows Installer: <code>subsonic-x.x-setup.exe</code>.
</p>
<a href="inc/img/windows-installer.png"><img class="img-right" src="inc/img/windows-installer-small.png" alt="Windows Installer"/></a>
<p>
It installs Subsonic as a service, available in <code>Control Panel > Administrative Tools > Services</code>, that is started automatically when you log on to Windows.
</p>
<p>
It also creates links in the Start Menu: <code>Start > All Programs > Subsonic</code>. From this menu you can start/stop the Subsonic service, open the Subsonic web page, or
change basic settings such as which port number Subsonic should use. You can also click on the little yellow submarine tray icon.
</p>
<p>
If you're upgrading an existing Subsonic installation, you don't have to uninstall the old version first. In any case, the existing Subsonic settings are preserved.
</p>
<p>
After installing and starting Subsonic, open the Subsonic web page on <a href="http://localhost">http://localhost</a>.
</p>
</div>
</div>
</div>
<div class="featureitem">
<a name="mac"></a>
<div class="heading"><img src="inc/img/download-mac.png" alt="" height="16" width="16"/> Mac installation <a href="#top" class="backtotop" title="Top"><img src="inc/img/top.gif" alt="" height="16" width="16"/></a></div>
<div class="content">
<div class="wide-content">
<a href="inc/img/mac-installer.png"><img class="img-right" src="inc/img/mac-installer-small.png" alt="Mac Installer"/></a>
<p>
Download the installation package and run it. This installs Subsonic.app in Applications. Start it by opening Applications and
click the Subsonic icon. A small headset icon will appear in the menu bar. If you want Subsonic to start automatically when you log in,
open <b>System Preferences > Accounts</b> and add Subsonic to the list of <b>Login Items</b>.
</p>
<p>
After installing and starting Subsonic, open the Subsonic web page on <a href="http://localhost:4040">http://localhost:4040</a>.
</p>
<p><b>Advanced configuration</b></p>
<p>
To change the port number, Java memory settings or other startup parameters, edit <code style="white-space:nowrap;">/Applications/Subsonic.app/Contents/Info.plist</code>.
</p>
<p><b>Troubleshooting</b></p>
<p>
If Subsonic doesn't start properly you can troubleshoot it by starting it from the command line:
<code style="white-space:nowrap;" >/Applications/Subsonic.app/Contents/MacOS/JavaApplicationStub</code>.
</p>
<p>
Also check the logs in <code style="white-space:nowrap;">/Library/Application Support/Subsonic</code>.
</p>
</div>
</div>
</div>
<div class="featureitem">
<a name="debian"></a>
<div class="heading"><img src="inc/img/download-ubuntu.png" alt="" height="16" width="16"/> Debian/Ubuntu installation <a href="#top" class="backtotop" title="Top"><img src="inc/img/top.gif" alt="" height="16" width="16"/></a></div>
<div class="content">
<div class="wide-content">
<p>
This installation option applies to Debian Linux, including Ubuntu.
</p>
<ul>
<li>First, install Java: <code>sudo apt-get install openjdk-6-jre</code></li>
<li><a href="download.jsp">Download</a> the Subsonic .deb package and install it: <code>sudo dpkg -i subsonic-x.x.deb</code></li>
</ul>
<p>
Notice that the installer configures your system to start Subsonic automatically when booting.
After installing, open the Subsonic web page on <a href="http://localhost:4040">http://localhost:4040</a>.
</p>
<p><b>Change user</b></p>
<p>
By default the Subsonic process is run as the root user. To improve security it is strongly advised that you run it as a
dedicated user with less powerful privileges. You can specify this user by setting the SUBSONIC_USER variable in
<code style="white-space:nowrap;">/etc/default/subsonic</code>.
</p>
<p>
Note that non-root users are by default not allowed to use ports below 1024. Also make sure to grant the user write permissions in
the music directories, otherwise changing album art and tags will fail.
</p>
<p><b>Advanced configuration</b></p>
<p>
To change the port number, Java memory settings or other startup parameters, edit the SUBSONIC_ARGS variable in
<code style="white-space:nowrap;">/etc/default/subsonic</code>. To restart Subsonic, do
<code style="white-space:nowrap;">sudo service subsonic restart</code>
</p>
<p><b>Troubleshooting</b></p>
<p>
Check the logs in <code style="white-space:nowrap;">/var/subsonic</code>.
</p>
</div>
</div>
</div>
<div class="featureitem">
<a name="rpm"></a>
<div class="heading"><img src="inc/img/download-fedora.png" alt="" height="16" width="16"/> Red Hat/Fedora installation <a href="#top" class="backtotop" title="Top"><img src="inc/img/top.gif" alt="" height="16" width="16"/></a></div>
<div class="content">
<div class="wide-content">
<p>
This installation option applies to Red Hat Linux, including Fedora.
</p>
<ul>
<li>First, install Java: <code>sudo yum install java-1.6.0-openjdk</code></li>
<li><a href="download.jsp">Download</a> the Subsonic .rpm installation package and install it: <code style="white-space:nowrap;">sudo yum install --nogpgcheck subsonic-x.x.rpm</code></li>
<li>If nothing happens, try to remove the old version first (all settings will be retained): <code style="white-space:nowrap;">sudo yum remove subsonic</code></li>
</ul>
<p>
Notice that the installer configures your system to start Subsonic automatically when booting.
After installing, open the Subsonic web page on <a href="http://localhost:4040">http://localhost:4040</a>.
</p>
<p><b>Change user</b></p>
<p>
By default the Subsonic process is run as the root user. To improve security it is strongly advised that you run it as a
dedicated user with less powerful privileges. You can specify this user by setting the SUBSONIC_USER variable in
<code style="white-space:nowrap;">/etc/sysconfig/subsonic</code>.
</p>
<p>
Note that non-root users are by default not allowed to use ports below 1024. Also make sure to grant the user write permissions in
the music directories, otherwise changing album art and tags will fail.
</p>
<p><b>Advanced configuration</b></p>
<p>
To change the port number, Java memory settings or other startup parameters, edit the SUBSONIC_ARGS variable in
<code style="white-space:nowrap;">/etc/sysconfig/subsonic</code>. To restart Subsonic, do
<code style="white-space:nowrap;">sudo service subsonic restart</code>
</p>
<p><b>Troubleshooting</b></p>
<p>
Check the logs in <code style="white-space:nowrap;">/var/subsonic</code>.
</p>
</div>
</div>
</div>
<div class="featureitem">
<a name="standalone"></a>
<div class="heading">Stand-alone installation <a href="#top" class="backtotop" title="Top"><img src="inc/img/top.gif" alt="" height="16" width="16"/></a></div>
<div class="content">
<div class="wide-content">
<p><b>Requirements: </b>Sun Java 5 or later (<a href="http://www.java.com">Download</a>)</p>
<p>
This is Subsonic with an embedded Jetty server, and can be installed on any Windows, Linux, Unix, FreeNAS, unRAID etc operating system.
</p>
<ul>
<li>Unpack <code>subsonic-x.x-standalone.tar.gz</code> to <code>SUBSONIC_HOME/standalone</code>.
<code>SUBSONIC_HOME</code> is typically <code>c:\subsonic</code> on Windows, and <code>/var/subsonic</code> on Unix-based operating systems.</li>
<li>Optionally configure the startup script <code>SUBSONIC_HOME/standalone/subsonic.sh</code></li>
<li>Execute the startup script. (Typically you will configure your operating system to execute the script automatically at start-up.)</li>
<li>Open the Subsonic web page. The default address is <a href="http://localhost:4040">http://localhost:4040</a>.</li>
</ul>
</div>
</div>
</div>
<div class="featureitem">
<a name="war"></a>
<div class="heading">WAR installation <a href="#top" class="backtotop" title="Top"><img src="inc/img/top.gif" alt="" height="16" width="16"/></a></div>
<div class="content">
<div class="wide-content">
<p><b>Requirements: </b>Java 5 or later (<a href="http://www.java.com">Download</a>). A servlet container supporting Servlet 2.4 and JSP 2.0.</p>
<p>
Use this option if you want to deploy Subsonic in an external server, such as Tomcat, Jetty, GlassFish or Geronimo. Subsonic comes
packaged as a standard Java web application, <code>subsonic.war</code>, which can be easily deployed in any compatible servlet container.
The most commonly used server is Tomcat, and the rest of this section describes how to install or upgrade Subsonic on a Tomcat server.
(Please note that Subsonic currently doesn't work with Tomcat 7.)
</p>
<ul>
<li>Stop Tomcat if it's running.</li>
<li>Remove these files and directories if they exist:
<ul>
<li><code>TOMCAT_HOME/webapps/subsonic.war</code></li>
<li><code>TOMCAT_HOME/webapps/subsonic</code></li>
<li><code>TOMCAT_HOME/work</code></li>
</ul>
</li>
<li>Copy the file <code>subsonic.war</code> to <code>TOMCAT_HOME/webapps</code>.</li>
<li>Start Tomcat.</li>
<li>Point your web browser to <a href="http://localhost/subsonic">http://localhost/subsonic</a> (or
<a href="http://localhost:8080/subsonic">http://localhost:8080/subsonic</a> if you installed Tomcat on port 8080.)</li>
</ul>
<p><b>Notes</b></p>
<ul>
<li> If you installed Tomcat as a Windows Service, you can start and stop it from the service manager: <code>Control Panel > Administrative Tools > Services</code>.</li>
<li><code>TOMCAT_HOME</code> refers to the directory in which you installed Tomcat. On Windows this is normally <code>C:\Program Files\Apache Software Foundation\Tomcat 5.5</code></li>
<li>On Linux, Subsonic keeps its files in <code>/var/subsonic</code>. Depending on your configuration, Tomcat may not be permitted to create this directory, in which case
you have to create it manually: <code>mkdir /var/subsonic; chown tomcat:tomcat /var/subsonic</code></li>
</ul>
<p><b>Troubleshooting</b></p>
<p>
If you experience any problems, please make sure you follow the installation instructions above. Here's a list of suggestions of what to do if it still doesn't work:
</p>
<ul>
<li>Restart Tomcat.</li>
<li>Reinstall Subsonic.</li>
<li>Upgrade to the latest Tomcat version (at least if you're using Tomcat 5.0 or earlier).</li>
<li>Look for errors in the Subsonic log, <code>c:\subsonic\subsonic.log</code> or <code>/var/subsonic/subsonic.log</code>.</li>
<li>Look for errors in the Tomcat logs, <code>TOMCAT_HOME/logs</code>.</li>
<li>Post a message to the <a href="forum.jsp">Subsonic forum</a>. Please let us know what Subsonic version, Tomcat version and
operating system you're using. Also, please give a detailed description of the problem. This way, we'll be able to help you faster.</li>
</ul>
</div>
</div>
</div>
</div>
<div id="side-col">
<%@ include file="google-translate.jsp" %>
<%@ include file="tutorial.jsp" %>
<%@ include file="donate.jsp" %>
<%@ include file="translate-subsonic.jsp" %>
</div>
<div class="clear">
</div>
</div>
<hr/>
<%@ include file="footer.jsp" %>
</div>
</body>
</html>
|
