Cisco Cisco Customer Voice Portal 8.0(1) User Guide

Page of 157
what may have taken 100ms to complete could take longer and depending on what it is that
needs to be done, could take much longer.
The administrator should refrain from the temptation of making this number too large. This is
because while a call session is still valid but not representing a live call, all that information
remains in memory. This may not be much but could be significant depending on the amount
of data stored in element and session data by the application. Even though the session has not
been invalidated, since the call has ended, VXML Server is ready and will accept new calls,
which will allocate additional memory. Under high load, the Java application server could
encounter memory issues if call sessions remain in memory for too long a period.
The JMX interface supports the ability to change the session invalidation delay at runtime. The
administrator would increase this setting if 
IllegalStateException
 errors appear in the
logs. They would lower the value if the JVM memory usage stays close to the maximum after
each garbage collection. Keep in mind that there are many potential causes for JVM memory
utilization to rise and is certainly not limited to this cause.
The default value of the session invalidation delay is sufficient to handle a heavy load without
issues so the administrator is urged to be cautious when changing this value.
Application Configuration Options
To view the configuration options of an application using the JMX interface, navigate to the
VoiceApplication/APPNAME/Command
 MBean, where 
APPNAME
 is the name of the
application. There are four attributes listed:
DefautAudioPath – Shows the audio path defining where the audio files are located (assuming
the application was designed to take advantage of it).
GatewayAdapter – Shows the gateway adapter that the application is using and is not
editable. It is for informational purposes only.
SessionTimeout – Shows the length of time, in seconds, of inactivity to consider a call session
timed out.
SuspendedAudioFile – The path for the audio file to play to callers when calling into an
application that is suspended.
An administrator may choose to change the default audio path of an application at runtime
should there be a need to change the audio callers hear quickly. One use case would be if the
server that hosts the audio files is being restarted and the administrator wishes all audio to be
fetched from a backup server.
Note: The effectiveness of this change will be based on how consistently the application was
designed to use the default audio path and also if the application explicitly sets the default audio
path itself, which would override the value passed here.
An administrator may choose to change the session timeout value at runtime as part of the
process of debugging a problem. Under normal circumstances no session should time out because
the voice browser and VXML Server should be in constant communication regarding when a
User Guide for Cisco Unified CVP VXML Server and Cisco Unified Call Studio Release 8.0(1)
73
Chapter 3: Administration
Configuration Updates