Cisco Cisco Unified Customer Voice Portal 10.5(1) Release Note

Page of 152
C
HAPTER 
3:
 
A
DMINISTRATION
 
 
U
SER 
G
UIDE FOR 
C
ISCO 
U
NIFIED 
CVP
 
VXML
 
S
ERVER 
 
 
 
AND 
C
ISCO 
U
NIFIED 
C
ALL 
S
TUDIO
 
 
 
 
64 
Specifying both of the optional parameters results in both data items being returned, as 
illustrated in the following example: 
 
running;activeCalls=77;onHoldCalls=0; 
 
The second URL format (with the 
application
 parameter), results in a VoiceXML page which 
includes a 
<submit>
 to the listed voice application.  If that VoiceXML page is returned, then 
VXML Server is accessible.  This format is intended for use with load balancers that require the 
probe URL to match the URL through which actual content is retrieved.  This format cannot be 
used to obtain additional information (i.e., active and on-hold calls) beyond that the server is 
accessible. 
Configuration Updates 
When an administrator monitors a VXML Server installation, they want to be aware of any 
warning signs that the system is overloaded. In these scenarios, it is advantageous if the 
administrator is able to tweak a few settings to better handle the given load without worrying 
about updating or suspending applications or shutting down the Java application server. These 
tweaks may enable a system to better handle spikes in call activity with no adverse effects. To 
this end, VXML Server exposes some of its configuration options and allows an administrator to 
change them at runtime. It also allows the administrator to change some application settings 
values for deployed application. 
It is important to note that the administrator must be very careful when altering these 
configuration options at runtime as improperly chosen values could make the system unstable 
and achieve the opposite effect than desired. 
The ability to change VXML Server configuration options and application settings is available 
only through the JMX interface. The configuration options are exposed as attributes of an 
MBean, one for the VXML Server configuration options and one for each application’s settings. 
Those attributes that allow their values to be changed will have editable values. When a new 
value is given, it takes affect immediately with no confirmation so it is important to ensure that 
the value entered is correct. There is some simple validation that takes place by VXML Server 
and if the value entered is inappropriate (such as entering -1 where a positive integer is required), 
the change will not take place and the original value will remain unchanged. The administrator 
will know that their entry was accepted if the value does not revert back. 
It is very important to note that any changes made to these attributes are not persisted. The 
changes affect VXML Server in memory and do not affect the XML files that hold these values. 
As a result, should the Java application server or the VXML Server web application be restarted 
or for application-specific attributes the application is updated, the attributes will revert back to 
the values specified in their respective XML files.