Audium Knowledge Base

Knowledgebase Home | Contact Knowledgebase Home | Contact
Search the Knowledgebase Jump to ID Browse by Category
How to use Audium 3.2.x when Tomcat is running as a Windows service
Categories: Audium 3.2.x
Article ID: 16
Last updated: May 24, 2007
User Opinions
100% 0% (1 vote)

How would you rate this answer?
Helpful
Not helpful
SUMMARY

This article explains the steps a developer should take to run Audium 3.2.x on a Tomcat installation that is running as a service on Windows.

SYMPTOMS

When Tomcat is run as a service, it throws the following exception:

javax.servlet.ServletException:
AUDIUM SERVER ERROR: An error occurred during initialization of the server: AUDIUM_HOME is not defined


RESOLUTION

The environment variable AUDIUM_HOME is not available to Tomcat at startup, since Windows services start before environment variables are available.

If you would like to continue to run Tomcat as a service, take the following steps to make the AUDIUM_HOME environment variable available at startup:

1. Run the "regedit" application (administrator privileges are required to make registry changes).
2. Follow path: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ApacheTomcat\ Parameters
3. Modify "JVM Option Count" to 3 (make sure it is in decimal format).
4. Create a new "String Value" and give it the name: "JVM Option Number 2".
5. Double-click the newly created string value.
6. Under "Value data:" enter "-DAudium.Home=AUDIUM_HOME" where AUDIUM_HOME is the full path of the Audium directory (e.g. "C:\Program Files\Audium\").
7. Restart Windows. Note that Tomcat as a service will not produce a console window. Check the Tomcat logs (stdout) to ensure that Audium Server has started correctly.
Visitor Comments
No visitor comments posted. Post a comment
Related Questions
Attachments
No attachments were found.

Copyright (c) 2005 Audium Corporation. All rights reserved.
Audium Home | Audium Support Center Home | Audium Customer Care Home