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

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

 

 

 

72 

•

 

Suspending a voice application still requires VXML Server (and hence the Java application 
server) to be running in order to produce the VoiceXML page containing the suspended 
message. If the application server itself requires a restart, there are four possible ways to 
continue to play the suspended message to callers. Remember to execute the suspend 
function before any of these actions are taken as this is the prerequisite. The solutions are 
listed in order of effectiveness and desirability. 

o

 

. In a load-balanced environment, one 

machine can be shut down, restarted, or reconfigured while the rest continue serving new 
calls. Once removed from the load balance cluster, a machine will not receive new call 
requests. Eventually, all existing callers will complete their sessions, leaving no calls on 
the machine removed from the cluster. That machine can then be safely taken down 
without affecting new or existing callers. 

o

 

 In a smaller environment, a web server can be used as a 

proxy for an application server so that when that application server becomes unreachable, 
the web server itself can return a static VoiceXML page containing the suspended 
message to the voice browser. The web server need not be on the same machine as the 
application server. Once the web server is configured, VXML Server can be suspended to 
flush out all existing callers, then the application server can be taken down and the proxy 
server will take over producing the suspended message VoiceXML page. The 
disadvantage of this approach is that the web server setup is done outside of Unified CVP 
and if the suspended message changes it would need to be changed in both the Builder for 
Call Studio and the web server configuration. 

o

 

 The voice browser can be configured to point to another URL 

for calls coming on the specific number. This can point to another machine running 
VXML Server or even just a web server with a single static VoiceXML document 
playing the suspended message. A separate file would be needed for each application. 
This is a manual process and requires another machine with at least a web server (it can 
be on the same machine which would allow the Java application server to be restarted but 
would not allow the machine itself to be restarted).  

To suspend an application using the JMX interface, use a JMX client connected to the server to 
navigate to the 

VoiceApplication/APPNAME/Command

 MBean, where 

APPNAME

 is the name of 

the application to be suspended. The operations tab of this MBean will list a function named 
“suspendApplication”. Pressing this button will cause the application to be suspended and the 
result will be displayed in a dialog box. To resume the application, select the function named 
“resumeApplication”. The result will be displayed in a dialog box. 

The administrator should be aware that there is no confirmation when these functions are called, 
the suspension and resumption occurs immediately once executed.  

Note that while the suspend function returns immediately, the application may still be active if 
there were calls visiting the application at the time of the suspension. Only when all existing