Cisco Cisco Unified Customer Voice Portal 11.0(1) User Guide

Page of 156
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
 
 
 
 
63 
System Information Page 
The same information is displayed in the system information page at the top of the table. It will 
also provide a list of the applications deployed on VXML Server as well as information on the 
application server, operating system, and Java memory usage. 
Server Status Checks 
Many load balancers can be configured to access a URL that is used to determine if a server is 
running.  This request is usually made periodically.  The load balancer makes a request to the 
URL and if a response comes back within an acceptable time, it considers the server available to 
handle connections.  To gauge the health of VXML Server, the URL to access must contain the 
argument “probe=true” in the request.  The URL may look like either of the following: 
http://[DOMAIN][:PORT]/CVP/Server?probe=true 
http://[DOMAIN][:PORT]/CVP/Server?application=[APPLICATION]&probe=true 
The “probe=true” argument is required to ensure that probe calls do not affect the session (i.e., 
license) usage statistics. 
If VXML Server is accessible and is not suspended, it will respond with: 
The Cisco Unified CVP VXML Server is up and running 
 
However, if it is suspended (via the 
suspendServer
 administrative script), it will respond with: 
 
The Cisco Unified CVP VXML Server is running, however it has been suspended. 
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