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

HAPTER

DMINISTRATION

ISCO

CVP

OICE

XML

User Guide

Suspending Applications

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
CVP VoiceXML Studio. When the suspend order is given,Serverproduces a VoiceXML page
containing this suspended audio message to all new calls followed by a hang-up. Since 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, Serverreports 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. The script named

suspendApp.bat

should be used to suspend a

specific application. To resume the application, use the script named

resumeApp.bat.

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

admin

folder

of Cisco CVP VoiceXML Server. The script named

suspendServer.bat

should be used. To

restore all applications to their original status, use the script named

resumeServer

. Note that this

script does not resume all applications; it simply restores the administrator-specified status of
each application. So if an application was already suspended when the

suspendServer

script

was called,

resumeServer

leaves it in a suspended state.

There are a few items to note when suspending a voice application.

• Only when all existing callers have exited the system will the application be officially

suspended. Depending on the average length of calls to the voice application, this may take
some time.

• If changes were made to an application while it was suspended, the application should first

be updated before being resumed (see the previous section on the update administration
function).

• The suspension applies only to those resources under the control of Server. External

resources such as databases, other web servers hosting audio or grammar files, or servers
hosting components via XML documents over HTTP are accessed at runtime by Server. If