Article ID:	247
Last updated:	February 22, 2007

Would you like to...

Print this page

Post a comment

User Opinions

No users have voted.

---

How would you rate this answer?

Helpful

Not helpful

Thank you for rating this answer.

SUMMARY

This article describes various ways to declare Audium Home (the Audium Call Services data directory), which is required for Audium Call Services to start properly.

SYMPTOMS

Administrator has installed Audium Call Services for the first time and needs to declare Audium Home, and/or administrator sees an error similar to the following in the application server logs:

 *** An error occurred during initialization of the server: com.audium.server.AudiumException: AUDIUM_HOME is not defined. ***

RESOLUTION

There are three ways by which Audium Home can be defined, listed here in order of precedence:

1) In Audium's expanded directory under your application server (from Audium.war), edit Audium/WEB-INF/web.xml and add an initial parameter named "AUDIUM_HOME" whose value points to the location of Audium Home. The disadvantage of this is that one has to run the application server once to unpack the Audium.war file before editing the web.xml file. Additionally, any upgrades would cause this to be lost and would require reimplementation.  Here is an example of the lines that should be added to web.xml:

 <init-param>
    <param-name>AUDIUM_HOME</param-name>
    <param-value>\usr\local\Audium\CallServices</param-value>
</init-param>

(NOTE: If you use this example, please be sure to change the path to match your actual Audium Home location)

2) Define a Java system property named "Audium.Home" pointing to the location of Audium Home. In Java code, you can set a system property by writing the following line of code:

System.setProperty("Audium.Home", "C:\Program Files\Audium\CallServices\");

Some application servers (such as WebSphere) allow administrators to set Java properties. Such application servers allow Java system properties be set on a per-web application basis. Depending on the application server, this variable may or may not be reset when an upgrade is installed.

3) Define an OS-level environment variable that points to the location of Audium Home. Note that this option may have security implications in installations with a high level of Java 2 security, for such environments we recommend the previous two options. This option, however, is not affected by upgrades as it is set outside of the web application.

On Windows, this third method can be used by doing the following:

- Open Start -> Control Panel.
- Double-click on System.
- Go to the Advanced tab.
- Click on Environment Variables.
- Under System variables, click New.
- Specify AUDIUM_HOME as the variable name, and the path as the variable value.
- Click OK on all open dialogs.
- Restart your computer.

To use this approach on Linux, the following command can be executed (usually in your application server's startup script):

export AUDIUM_HOME=/usr/local/Audium/CallServices

where the path listed is the appropriate path for your system.