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

Page of 83
C
HAPTER 
3:
 
A
DMINISTRATION
 
 
C
ISCO 
CVP
 
V
OICE
XML
 
 
 
User Guide 
 
Graceful Administration Functions 
Administration scripts are used primarily to alter an application, whether it be to update its 
contents or suspend its activity. Whenever changes are made to a live system handling callers, a 
concern is how these changes affect live callers. A robust, reliable system should strive for 
maximum uptime and minimal disruptions of live calls, and CVP VoiceXML Server does this by 
implementing a “graceful” process for managing changes. 
In the graceful process, existing callers continue to experience the application as it existed before 
the change, while new callers experience the change. Only after all existing callers have naturally 
ended their calls will the change apply to all live callers. At this time, Serverwill perform any 
necessary cleanup required to remove the old application configurations. In this manner, changes 
can be made to applications at any time, the administrator need not worry about the impact of the 
change on live callers as they will be handled gracefully. 
When a graceful administration script is executed, it will keep track of callers that were already 
visiting the application and display a count down as those callers naturally end their calls. This is 
provided as an aid to the administrator in determining how many callers are still experiencing the 
application before the change. Command line arguments passed to the scripts can turn off this 
countdown if desired. The information on the number of callers visiting the old and new versions 
of the application is still available when obtaining the status of the system. 
The description of the various administration functions listed below will each explain the manner 
in which their actions are handled gracefully (if applicable) and any points that need to be 
considered when the administration script is run. 
Updating Applications 
Occasionally, an application will need to be updated. Possible changes can be small, such as 
renaming an audio file or altering a TTS phrase, or large, such as adding another item to a menu 
and creating a new call flow branch. They can involve simple configuration changes or may 
involve new or changed Java class files. These kinds of changes occur most frequently when the 
voice application is being developed, and less frequently on a live application. 
The update functionality acts gracefully in that any callers on the system at update time continue 
to experience the rest of the call as if the application had not been updated, while new callers 
experience the updated voice application. In this manner, there is no downtime when a change is 
needed for an application; the callers are handled as expected. 
The scripts for updating an application are found in the 
admin
 folder of the application to be 
updated. The 
updateApp.bat
 should be used to update a specific application. It is possible to 
update all applications deployed on Cisco CVP VoiceXML Server by running 
updateAllApps.bat
 script found in the 
admin
 folder of the Server. This script essentially runs 
the update script for each application deployed on Cisco CVP VoiceXML Server. 
 
 
©2000 - 2005 Audium Corporation.  All Rights Reserved.  1/14/05
 
50