Installing Subsonic for the first time

1. Install Java from http://www.java.com/.
2. Install Tomcat from http://tomcat.apache.org/. Note that version 5.5 or later is required.
3. Stop Tomcat if it's running.
4. Copy the file subsonic.war to <TOMCAT_HOME>/webapps.
5. Start Tomcat.
6. Point your web browser to http://localhost/subsonic (or http://localhost:8080/subsonic if you installed Tomcat on port 8080.)
7. Logon with username admin and password admin. You should change the password immediately. Click Settings to change password and create new users.
8. Subsonic will attempt to create the directory c:\subsonic (on Windows) or /var/subsonic (all other platforms). This will fail if the user running Tomcat doesn't have the necessary privileges. In that case, create the directory manually, and make sure that Tomcat has write access to it.

Upgrading Subsonic

1. Stop Tomcat.
2. Remove both <TOMCAT_HOME>/webapps/subsonic.war and the <TOMCAT_HOME>/webapps/subsonic directory.
3. Copy the file subsonic.war to <TOMCAT_HOME>/webapps.
4. Start Tomcat.
5. If upgrading from version 2.4 (or earlier) to 2.5 (or later) - Please follow steps 6 and 7 above.
6. If the upgrade does not seem to have any effect, delete all files in the <TOMCAT_HOME>/work directory.

Notes

• If you installed Tomcat as a Windows Service, you can start and stop it from the service manager (Start > Settings > Control Panel > Administrative Tools > Services)
• <TOMCAT_HOME> refers to the directory in which you installed Tomcat, typically C:\Program Files\Apache Software Foundation\Tomcat 5.5
• On Linux, Subsonic keeps its files in /var/subsonic. Depending on your configuration, Tomcat may not be permitted to create this directory, in which case you have to create it manually: mkdir /var/subsonic; chown tomcat:tomcat /var/subsonic

Troubleshooting

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:

• Restart Tomcat.
• Reinstall Subsonic.
• Upgrade to the latest Tomcat version (at least if you're using Tomcat 5.0 or earlier).
• Look for errors in the Subsonic log (c:\subsonic\subsonic.log or /var/subsonic/subsonic.log).
• Look for errors in the Tomcat logs (<TOMCAT_HOME>/logs).
• Post a message to the Subsonic forum. 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.