WAR installation
- Keywords:
- Installing
Requirements: Java 5 or later (Download). A servlet container supporting Servlet 2.4 and JSP 2.0.
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, subsonic.war, 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.
* Stop Tomcat if it's running.
* Remove these files and directories if they exist:
o TOMCAT_
o TOMCAT_
o TOMCAT_HOME/work
* Copy the file subsonic.war to TOMCAT_
* Start Tomcat.
* Point your web browser to http://
Notes
* If you installed Tomcat as a Windows Service, you can start and stop it from the service manager:
Control Panel > Administrative Tools > Services.
* TOMCAT_HOME refers to the directory in which you installed Tomcat.
On Windows this is normally 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\
* 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.