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

C

HAPTER 

3:

 

A

DMINISTRATION

 

 

V

OICE

XML

 

S

ERVER 

U

SER 

G

UIDE 

 

 

 

FOR 

C

ISCO 

U

NIFIED 

C

USTOMER 

V

OICE 

P

ORTAL 

R

ELEASE 

4.0(1) 

 

 

 

 

 

47

the application should be updated followed by resuming it from its suspended state. This 
way, no caller will be in the system when the changes are made. The only disadvantage to 
this approach is that it will make the application unavailable for a period of time as opposed 
to a transparent change if the update feature alone is used. This may be a necessary tradeoff 
considering the consequences. 

    When the update occurs, the event created by the VoiceXML Server to send to any loggers 

that are listening will reflect when the update script was run, not when it completed. 

    If an error occurs during the update process, e.g., due to an incorrectly configured XML file, 

a description of the error is displayed to the console window and sent to any loggers listening 
to the appropriate logger events and the update is cancelled. 

There are many situations when an application needs to be temporarily suspended. There could 
be scheduled maintenance to the network, the voice application could have an expiration date 
(say it runs a contest that must end at a specific time), or the application is to be turned off while 
enterprise-wide improvements are made. There may also be situations where all applications are 
to be put in suspension if modifications are being made that affect all applications. In each of 
these situations, a caller would need to be played a designer-specified message indicating that the 
application has been temporarily suspended, followed by a hang-up. This is preferable to simply 
not answering or taking down the system, which would cause a cryptic outage message to be 
played. 

First, the application designer defines the suspended message in the Application Settings pane in 
Unified CVP VoiceXML Studio. When the suspend order is given, Unified CVP VoiceXML 
Server produces a VoiceXML page containing this suspended audio message to all new calls 
followed by a hang-up. Since the VoiceXML Server gracefully allows all calls currently on the 
system to finish normally when the command was issued, existing callers are unaware of any 
changes. Once all the old calls are completed and all new callers are receiving the suspended 
audio message, the VoiceXML Server reports the application as being successfully suspended 
for all callers. Only then is it safe for the administrator to perform the system maintenance that 
required callers to be prevented from entering the application. 

The scripts for suspending and resuming applications are found in the 

admin

 folder of the 

application to be suspended. Windows users should use the script named 

suspendApp.bat

 and 

Unix users should use the script named 

suspendApp.sh

. To resume the application, use the 

script named 

resumeApp.bat 

or

 resumeApp.sh

. 

It is possible to suspend all applications at once by accessing a script found in the 

admin

 folder 

of Unified CVP VoiceXML Server. Windows users should use the script named 

suspendServer.bat

 and Unix users should use the script named 

suspendServer.sh

. To restore 

all applications to their original status, use the script named 

resumeServer.bat 

or

 

resumeServer.sh

. Note that these scripts do not resume all applications; they simply restore the 

administrator-specified status of each application. So if an application was already suspended 
when the server was suspended, resuming the server leaves the application in a suspended state.