Article ID:	248
Last updated:	November 02, 2006

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 explains the parameters which can be set in web.xml to enable or disable various features of Audium Call Services, as well as specify required variables such as the location of Audium Home.

SYMPTOMS

N/A

RESOLUTION

Under your application server's expanded Audium directory (from Audium.war), there is a WEB-INF/web.xml file.  In this file, you can specify a number of parameters to enable or disable various features of Audium Call Services, and define variables which Audium Call Services requires.  All of these parameters are defined on the same level as the <load-on-startup> element.

1. AUDIUM_HOME.  This parameter allows administrators to set the location of the Audium Call Service's Audium Home directory.  Example:

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

2. Debug.  This parameter enables logging of all interactions between the voice browser and Audium Call Services, including VoiceXML that is sent, headers that are received, and various other pieces of information.  This feature is invaluable to help debug problems, as well as provide information while testing custom voice elements.  Example:

<init-param>
    <param-name>Debug</param-name>
    <param-value>on</param-value>
</init-param>

When this feature is enabled, Audium Call Services will produce very large log files very rapidly; it is not recommended that this option be enabled on production systems unless necessary.

3. Stacktraces.  This parameter enables logging of stacktraces generated by code used in Audium Call Services (e.g. custom code, 3rd party code, etc.).  This parameter was made available as of Audium Call Services 3.4.3.  Example:

<init-param>
    <param-name>Stacktraces</param-name>
    <param-value>on</param-value>
</init-param>

Note that Audium Call Services or your application server should be restarted for any changes to web.xml to take effect.  Some application servers allow individual applications to be restarted which may work, whereas other application servers may need to be completely restarted.  Please refer to your application server's documentation for details.